diff options
| author | Gabriel Schneider <[email protected]> | 2026-11-17 09:14:00 -0300 |
|---|---|---|
| committer | Gabriel Schneider <[email protected]> | 2026-11-17 12:15:01 -0300 |
| commit | af127a88b03a4bd1b859993594a34b434e5e59d3 (patch) | |
| tree | 2c98f46f78f14b4ff9c9143dee4e7b99f0ecb8ff /src/skill.txt | |
| parent | 6535f3a59bb2454a0e945d840c083b2423a80b44 (diff) | |
| parent | 2e6777e06e3f3e9d59ec847b98e0cb676d04296a (diff) | |
| download | pardes-af127a88b03a4bd1b859993594a34b434e5e59d3.tar.gz pardes-af127a88b03a4bd1b859993594a34b434e5e59d3.zip | |
integration: the command line as commands that describe themselves, with the editor library, the GPU move, the terminal, the plumber and the diff work
A merge of pardes-next (nsyzqrms) and pardes-cli (xurkunwk). One conflict, the changelog (both sides' entries kept); docs/typ/command-line.txt written again by builtins-json on the merge (the tree's README and words gained the plumber's files and a pane's rows). pardes builds beside a cloud9 at c9-cli (by path, until that cloud9 is published). Gated against the integration line's baseline (.scratch/sketch/gpu/mbase): frame corpus 77/77 identical in Debug and in ReleaseFast, the gated window +0.160% instructions (spread 0.39%, threshold 0.5%), unit-test on gui 1587/1595 with no failure the baseline has not; on tui core-test 811/950 (139 skipped), shell-test 993/996, behaviour-test 269/273 and unit-test 1528/1536 (the four addon ABI tests the base fails, and the perf baseline's harness mismatch), process-test 2 of 144 failed (lspcomplete and lspcompletemoved, the base's; ttytaken failed once under load and passed its retry), lib-test, hxdiff 658, parity 738 and hxlib 538 with 0 mismatches, replicas pass.
Co-Authored-By: Claude Fable 5.2 <[email protected]>
Claude-Session: https://claude.ai/code/session_016Y9MNBECMWcJD5pdS4SR6T
Diffstat (limited to 'src/skill.txt')
| -rw-r--r-- | src/skill.txt | 47 |
1 files changed, 47 insertions, 0 deletions
diff --git a/src/skill.txt b/src/skill.txt new file mode 100644 index 00000000..8ae6a15a --- /dev/null +++ b/src/skill.txt @@ -0,0 +1,47 @@ +pardes, for an agent +==================== + +pardes is an editor (acme's mouse, helix's keys) and a terminal multiplexer, +and every session is a file tree served over 9P: panes, columns, tags and +the session are files. This guide is the judgement; the inventory is the +binary's own and the session's, and it is always the one to trust: + + pardes help the commands + pardes help PATH what the tree's README says of a file (pane, log...) + pardes words every builtin; pardes help WORD for one + pardes fs ls PATH what a session serves now + +Find the session + In a pane's shell, $PARDES_9P is its socket and $PARDES_PANE the pane: + every command below acts there. From outside, `pardes ps` lists the + sessions and -s NAME picks one. Never act on a session you did not start + or were not asked to touch: start your own, detached, and end it by name. + + pardes new --detach=work & a session with no terminal, named work + pardes fs read index -s work a line per pane + pardes kill work done with it + +Recipes + n=$(pardes fs read pane/new -s work) make a pane, take its serial + pardes fs write pane/$n/name /tmp/x.txt -s work name it + printf 'text\n' | pardes fs write pane/$n/body -s work replace its text + pardes do Save -p $n -s work a pane's builtin + pardes do Newcol -s work a session's builtin + pardes fs write pane/$n/ctl 'Edit ,x/foo/c/bar/' -s work sam's Edit, one undo step + pardes fs ask pane/$n/look /etc/hosts:3 -s work open a file there; answers the pane it went to + pardes fs ask pane/$n/pty/run make -s work on a terminal pane: exit N, then the output + pardes fs follow log follow -s work events as they come (Ctrl-C ends it) + pardes fs read screen -s work what is drawn, as JSON + +Traps + A refusal is printed in the session's words and the exit is 1; through a + mount the same refusal is only EINVAL or EIO (grep '^err' log says why). + Pane words (Save Undo Del) go to a pane's ctl, settings and session words + to the root's: pardes do picks the ctl, pardes help WORD says which. + The root's look and exec act at the pane with the keyboard, which a person + may be using: write a pane's own look and exec instead. + addr is the pane's and moves on: each /re/ searches from the last. + Exit, Restore, Del and get refuse once over unsaved text; the same word + again discards it. + A read the session holds (log follow, an event file) waits for ever only + under fs follow; other calls give up after 30 s, saying so. |
