From 7a4d5fc4c8fcb81aef36debec3001fafb3032925 Mon Sep 17 00:00:00 2001 From: Levi Neely Date: Sat, 18 Apr 2026 11:06:32 +0200 Subject: [PATCH] doc: document all s/ scripts (ls, kill, q, sched) Co-Authored-By: Claude Sonnet 4.6 --- README.md | 2 +- doc/help.md | 4 ++++ scripts/README.md | 13 ++++++++----- 3 files changed, 13 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 9304967..64d4719 100644 --- a/README.md +++ b/README.md @@ -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 diff --git a/doc/help.md b/doc/help.md index 6c4499f..9af941d 100644 --- a/doc/help.md +++ b/doc/help.md @@ -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 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 / session directory rm -r to kill; mv to rename agent active agent (r/w) backend active backend (r/w) diff --git a/scripts/README.md b/scripts/README.md index 5bb9610..70849d0 100644 --- a/scripts/README.md +++ b/scripts/README.md @@ -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 # kill a session ``` ---