doc: document all s/ scripts (ls, kill, q, sched)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Levi Neely 2026-04-18 11:06:32 +02:00
parent f984565082
commit 7a4d5fc4c8
3 changed files with 13 additions and 6 deletions

View File

@ -13,7 +13,7 @@ What happens if agent primitives are exposed as an ordinary filesystem? How much
- `tui/`:
- `9p/`:
- `el/`:
- `scripts/`: shell scripts installed to `~/.config/ollie/scripts/` and exposed via `s/sh` and `s/job`
- `scripts/`: shell scripts installed to `~/.config/ollie/scripts/` and exposed via `s/` (`sh`, `job`, `q`, `sched`, `ls`, `kill`)
## Getting Started

View File

@ -36,8 +36,12 @@ ollie/
s/ sessions ls
idx session index (ro) cat: id state cwd backend model, one per line
new create session (r/w) cat: KV template; echo "cwd=/path" >
ls list sessions (x) exec s/ls
kill kill session (x) exec s/kill <id>
sh interactive shell (x) exec s/sh [-new|-resume] [-backend B] [-model M]
job batch job (x) exec s/job [-bg] [-parallel N] [-keep] [prompt...]
q foreground query (x) exec s/q [flags] [prompt...]
sched background job (x) exec s/sched [flags] [prompt...]; prints b/ path
<id>/ session directory rm -r to kill; mv to rename
agent active agent (r/w)
backend active backend (r/w)

View File

@ -3,13 +3,16 @@
Shell scripts for interacting with the ollie 9P filesystem.
All scripts read `OLLIE` (default: `$HOME/mnt/ollie`) for the mount path.
`mk scripts` installs them to `~/.config/ollie/scripts/` and they are exposed via the
mounted filesystem as `s/sh` (osh) and `s/job` (oq), so they are available without
any `$PATH` changes:
`mk scripts` installs them to `~/.config/ollie/scripts/` and exposes them via the
mounted filesystem under `s/`, so they are available without any `$PATH` changes:
```sh
exec $OLLIE/s/sh # start interactive shell
$OLLIE/s/job "my prompt" # run a batch job
exec $OLLIE/s/sh # start interactive shell
$OLLIE/s/job "my prompt" # batch job (foreground)
$OLLIE/s/q "my prompt" # foreground one-shot query
$OLLIE/s/sched "my prompt" # background job; prints b/ path
$OLLIE/s/ls # list sessions
$OLLIE/s/kill <id> # kill a session
```
---