summaryrefslogtreecommitdiff
path: root/.agents/skills/pardes-9p/SKILL.md
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-09-29 09:17:23 -0300
committerGabriel Schneider <[email protected]>2026-10-01 00:12:16 -0300
commitfd08b9e11f108ea42621869b8708086fe8b309b0 (patch)
treefb07f8efb33ebc604c43cce5db5e246b433c68bb /.agents/skills/pardes-9p/SKILL.md
parentc2cc0d9f212fdb285a11cbceaa16a30ad3236743 (diff)
downloadpardes-fd08b9e11f108ea42621869b8708086fe8b309b0.tar.gz
pardes-fd08b9e11f108ea42621869b8708086fe8b309b0.zip
The docs: the one rule covers pty/ctl exec, misses and gone directories are ENOENT, #100,#50 past the end, --detach forks
The one rule's wording left out a pane's pty/ctl and the ENOENT a Find, Grep or missing directory now answers; `#100,#50` in a short text says out of range, its ends checked first; and the skill now says --detach forks, the pid being /status's. Co-Authored-By: Claude Opus 5.5 <[email protected]>
Diffstat (limited to '.agents/skills/pardes-9p/SKILL.md')
-rw-r--r--.agents/skills/pardes-9p/SKILL.md11
1 files changed, 7 insertions, 4 deletions
diff --git a/.agents/skills/pardes-9p/SKILL.md b/.agents/skills/pardes-9p/SKILL.md
index d89a3ac3..5ac1ba46 100644
--- a/.agents/skills/pardes-9p/SKILL.md
+++ b/.agents/skills/pardes-9p/SKILL.md
@@ -17,7 +17,9 @@ Check `$NINE_MOUNT` first. `9ns --mntgen` sets it for every process it starts
(an interactive shell on this machine runs inside one), so a set `$NINE_MOUNT`
means the posted-9P registry is mounted there, usually `/mnt/9p`, and each
running editor is a directory `$NINE_MOUNT/pardes/<pid>/` (a `--detach=NAME`
-session's is `pardes/NAME/`). Inside a pane, `$PARDES_9P` is that session's
+session's is `pardes/NAME/`; `pardes --detach=NAME` forks, its parent
+returning at once, so the running editor's pid is not `$!`: read it from
+`$m/status`, whose first line is `pid <n>`). Inside a pane, `$PARDES_9P` is that session's
socket (`/run/user/1000/pardes-9p-<pid or NAME>.sock`), which names the
directory either way, and `$PARDES_PANE` is the calling pane's serial:
@@ -162,9 +164,10 @@ it again. Each command line runs once whole, however a mount cuts a big write; a
line with no newline runs when the open closes, and an Edit block still open
then fails there (an `err`: ``unmatched `{'``, or an a/c/i text with no `.`
line), changing nothing. One rule: a builtin that fails, whether through a
-ctl, look, exec, tagexec or a column's exec, fails the write (EINVAL for a
-malformed line, else EIO or an errno that fits) and logs one `err` with the
-reason, no `msg`. A look that finds nothing is no failure: it answers
+ctl (a pane's pty/ctl `exec` too), look, exec, tagexec or a column's exec,
+fails the write (EINVAL for a malformed line, ENOENT for what is not there --
+a directory gone, a Find or Grep with no hit -- else EIO or an errno that
+fits) and logs one `err` with the reason, no `msg`. A look that finds nothing is no failure: it answers
nothing and logs one `err`. A command line run in a command pane is judged
by its `exit` record. A word no builtin
knows (a typo included) is a command line: written at a terminal at its