pardes.git/README.md, branch release-0.24Pardeshttps://git.0x4200.cafe/pardes.git/atom?h=release-0.242026-10-01T15:41:34ZThe landing leads with live text and plays terminal casts first; the Themes page gets a gallery; install starts at the clone2026-10-01T15:41:34ZGabriel Schneidergbrls@0x4200.cafe2026-10-01T15:41:34Zurn:sha1:3c1668e02395d41bb83a4df3d85bf47a7bbdbef4
The landing's own words sit in one `landing` record in site.typ: a lead
on the core idea (any text is live: right-click looks, middle-click
runs), where it runs, and a status line whose version is read from
build.zig.zon. Recordings come in two shelves: "In a terminal", asciicast
players from docs/site/casts/casts.toml (the first autoplays; all loop
and fit the width; data inline, so they play from file://), then "In
its own window", the GUI clips. asciinema-player 3.17.0 is vendored in
docs/site/player with its Apache-2.0 licence, from `npm pack`. The
Themes page shows #theme-gallery() from media/themes/themes.toml, a
thumbnail per theme opening the full picture; on paper it is nothing.
Both shelves and the gallery show placeholders until their files exist.
`project` in style.typ lists the mirrors (sourcehut, git.0x4200.cafe);
install.typ clones from the first and names them all, and the footer
links each. The README clones before it builds. The scripting
interface is a virtual filesystem served over 9P, never just a
filesystem, in the tagline, captions and README.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The landing shows the four recordings, pardes is ISC-licensed, and the install lines fit a phone2026-10-01T15:32:35ZGabriel Schneidergbrls@0x4200.cafe2026-10-01T15:28:20Zurn:sha1:9a7830c62d25d83754bd58d0e705501f71656c69
clips.toml names the recordings (text-is-the-interface,
terminals-are-panes, scripting-over-9p, diff-review), each ready, its
caption checked against what the clip shows. The first ready clip
plays at the top, full width and on its own (autoplay, muted, looping),
and the grid below shows the others, three across. Videos and posters keep the recordings' 960x700 shape. The footer
links the source at git.0x4200.cafe/pardes and names the ISC license,
from `project` in style.typ. LICENSE holds the ISC text, and the README
names it and says the libraries keep their own (MuPDF, on by default, is
AGPL). The install lines put their comments on lines of their own, and
on a phone a shell line wraps rather than scroll its end away.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The docs give back the day-one lines the trim cut, the tutor becomes exercises on a +Tutor copy, the README builds the GUI and says what a terminal needs, and Shift-Esc says it needs the kitty keyboard protocol2026-10-01T15:24:31ZGabriel Schneidergbrls@0x4200.cafe2026-10-01T14:03:21Zurn:sha1:d3638abbb3d177ea08beed3b09cd9682b3732daf
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The docs trimmed to their path: a guide with Words you'll see and one Where commands run and panes go table, scripting's first tag word Fmt and eight traps, setup as the one home of the pager and the servers, a scannable cheatsheet, an honest README, the edge cases moved to the reference, and the pager's colours2026-10-01T15:24:31ZGabriel Schneidergbrls@0x4200.cafe2026-10-01T13:45:29Zurn:sha1:351c3976805aa12a56c593894738001491548106
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Setting up your environment: a 9ns mount, pardes as the editor, pager and yazi opener, the shells with prompt marks, language servers, fonts and plan9port, each snippet tried2026-10-01T03:12:18ZGabriel Schneidergbrls@0x4200.cafe2026-10-01T03:02:33Zurn:sha1:06770c54a408057c92c0381b75039d70c85625d6
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The README says what pardes is, how to install it, and what to read next2026-10-01T03:12:17ZGabriel Schneidergbrls@0x4200.cafe2026-10-01T02:04:26Zurn:sha1:71c715e10fe85d71b615c8f9a5a2b0c4c95b1a3f
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Zig files go to zls as a child process through the protocol client, as every other language does: the in-process ZLS backend goes2026-10-01T03:12:17ZGabriel Schneidergbrls@0x4200.cafe2026-09-30T01:31:27Zurn:sha1:7e8e2655567cab1c28597f44d0aec79e46b0deb8
lsp_zls.zig (1,522 lines), the zls dependency, build.zig's zls wiring and the import graph it baked into the options only for it, and main.zig's reference go. lsp_client's table gains a zls row (PARDES_LSP_ZIG overrides it); Hover, Rename, Diagnostics, WsSymbols, Lspinfo and gd answer through it (checked with lspprobe and the snapshots against zls 0.16.1-dev). What changes for a user: zls must be on PATH; a completion's rows are zls's candidates at the cursor, where the linked analyser gave each one's declaration; document symbols carry no signature. The Zig snapshots (lsp, lspcomplete, lspcompletemoved, lspdebug, lsprelpath) run the real zls now: lspdebug reads the client's explain and report, lsprelpath spells gr's rows where it spelled a completion's, and their goldens are recorded again (stable over three runs). Lspinfo still opens with its backend line. The ReleaseFast tty binary is 105.35 MB to 96.28 MB, the Debug one 296.5 MB to 245.9 MB. docs/lsp.md, web.md, design.typ and the README say so.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The docs and the 9P skill say each fact once, in the file that owns it, and say only what a live session does2026-10-01T03:12:17ZGabriel Schneidergbrls@0x4200.cafe2026-09-29T22:25:00Zurn:sha1:57b30ba3e38153a4446626449b0fed5120da954c
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
pardes --wait (-w) in a pane returns only once the pane its file landed in is deleted, so it can be $EDITOR2026-10-01T03:12:17ZGabriel Schneidergbrls@0x4200.cafe2026-09-29T21:32:37Zurn:sha1:a22129c343d9236277dcc0353c48cb53bc3417ce
A launch inside a pane forwards its file to the session's look and returned at once, so fish's Ctrl-O (edit_command_buffer), git commit and crontab -e read their still-unedited file back and went on. With --wait, as acme's E against B and read the way plan9port's E reads acme's log, it finds the pane /index names the file by (the one already showing it, if open), follows /log on one connection with 'follow new', reads /index once more to catch a Del that came first, and then blocks with no deadline until that pane's del record: exit 0, or 1 when the connection ends with the session. The 9P client's one-shot requests keep their 2 s deadline; its new follow takes it for the setup only. Outside pardes nothing changes. --help, docs/fs.md, the README and the 9P skill say to set EDITOR='pardes --wait', which GIT_EDITOR follows. Tested in fs.py (it returns within 50 ms of the Del, a second -w waits on the same pane, one whose session is killed exits 1) and end to end: fish 4.8 in a detached session, echo hi, Ctrl-O, the waiting launch idle in poll, the line edited over 9P, Save, Del, and fish ran echo edited.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The README and the 9P skill warn that plan9port's 9p write always truncates, so it replaces a body2026-10-01T03:12:17ZGabriel Schneidergbrls@0x4200.cafe2026-09-29T20:11:35Zurn:sha1:290584fc1127d017603c7c98c9aab27c0523a2cf
acme ignores OTRUNC, pardes honours it, and 9p write sets it on every open: a pipe into body that appended under acme replaces the text here. The fix is >> through a mount.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>