pardes.git/src/fs-help.txt, branch main

The docs call pardes's scripting interface a virtual filesystem, served over 9P, and the guide opens on look and execute as the core idea

2026-10-01T15:42:16Z

Co-Authored-By: Claude Opus 5.5

Scripts find the session as m=\$PARDES_MOUNT, else 9p; SPC q quits; upper keeps a selection's newline and its tag words once; the reference takes line files, init errors, dumps, dials and Save on +Tutor

2026-10-01T15:31:48Z

Co-Authored-By: Claude Opus 5.5

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 colours

2026-10-01T15:24:31Z

Co-Authored-By: Claude Opus 5.5

Recipes work through a pane of their own, its look and exec, and keep a command pane while their open lasts; the docs give cmd panes, the err grep, alt-screen prompts, /pager's refusals, Tty+ on a ctl, --, and theme failures in words

2026-10-01T08:37:37Z

Co-Authored-By: Claude Opus 5.5

/index names a command's pane kind cmd, not term: a script picking a terminal by kind no longer picks a pane with no shell

2026-10-01T07:54:48Z

A command pane runs one line and takes no typing; a script choosing `$2=="term"` to type into got one. Its kind is now cmd; a shell's stays term. Co-Authored-By: Claude Opus 5.5

The docs say Grep is a literal search, that a write's own status comes before the log's last err, and that Delcol opens no +Unsaved

2026-10-01T07:14:31Z

Co-Authored-By: Claude Opus 5.5

pardes - asks /pager for its +Pager and reads the serial on the same open: another client's exec meanwhile can never take the text into its pane

2026-10-01T07:00:32Z

pardes - wrote `pager ` to /ctl, then read /exec on a fresh open, which answers the session's last answer: a client that exec'd in between had its pane overwritten by the paged text. /pager takes the directory and answers the +Pager's serial on the open that wrote it, as /pane/new answers its own open; the ctl verb is gone. Client.ask writes and reads on one open. The README's look recipe reads its answer on its own open too. Co-Authored-By: Claude Opus 5.5

Scripting over 9P has one chapter, and the served README and the 9P skill shrink to a summary, the traps and a pointer to it

2026-10-01T03:12:17Z

Co-Authored-By: Claude Opus 5.5

Recent lists the files opened lately, closed ones too, and a jump back to a closed file reopens it

2026-10-01T03:12:16Z

A file closed by accident, its path forgotten, could not be found again: the jumplist dropped closed panes. Every file opened (a look, a Save of a scratch, a Restore, a rename) goes first in a list of 200, kept once, its dot noted when it closes, kept across sessions in $XDG_STATE_HOME/pardes/ recent. `Recent` (SPC f r) shows it in a reused +Recent, each row `path:line:col open|closed` a look reopens; /recent reads `open|closed `. The jumplist keeps a closed file's entries, +Jumps marks them `(closed)`, and Back to one opens the file at its place. acme has no such thing; its dump and Load are the nearest. Co-Authored-By: Claude Opus 5.5

The docs: Kill leaves bash and fish to run the rest of a line, index rows split from the right, busy names its program, chord follow-ups, /commands rows, Exit's second refusal

2026-10-01T03:12:16Z

Dogfood round 16 took these literally and found them false: bash ran the echo after Kill as fish does; a name with spaces broke split(maxsplit=3) since the row ends with the column serial; pty/run's busy line names the program; /commands rows end in a description; a second Exit refusal names only panes edited since. Co-Authored-By: Claude Opus 5.5