summaryrefslogtreecommitdiff
path: root/src/skill.txt
blob: 8ae6a15abb1468935b735ccd36c306fba2631d78 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
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.