diff --git a/README.md b/README.md index d9b180d..49bc674 100644 --- a/README.md +++ b/README.md @@ -91,11 +91,11 @@ git submodule update --remote **Discoverability** — `ls s/{id}/` shows every control surface. `cat t/idx` and `cat sk/idx` list available tools and skills. `cat help` explains the rest. -**Composability** — Agents can be composed by piping `reply` into another session's `prompt`. Tools can be composed via `execute_pipe`, chaining `execute_code` and `execute_tool` steps the same way Unix pipes chain programs. +**Composability** — Tools can be composed via `execute_pipe`, chaining `execute_code` and `execute_tool` steps the same way Unix pipes chain programs. Sessions can be chained by reading `s/{id}/chat` and writing to another session's `prompt` or `enqueue`. **Passive memory** — Every session's chat history accumulates at `s/{id}/chat`, searchable with `grep`. An agent doesn't need to actively decide what to remember. This extends across sessions: an agent can search another session's chat for answers that have already been worked through. -**Sub-agents** — An agent can spin up new sessions by writing to `s/new`, prime each one with a prompt, and collect results by reading their `reply` or having them write back to the parent's `prompt` or `enqueue`. Coordination is not yet fully resolved, but the basic fan-out pattern works today. +**Sub-agents** — An agent can fan out work by writing to `b/new` (ephemeral one-shot jobs) or `s/new` (persistent sessions), then collect results from `b/{id}/result` or `s/{id}/chat`. Multiple jobs run concurrently with `parallel=N`; each gets its own result file. ## Credits diff --git a/doc/help.md b/doc/help.md index f31ff58..0dc407f 100644 --- a/doc/help.md +++ b/doc/help.md @@ -24,6 +24,15 @@ ollie/ idx memory index (ro) cat p/ prompt templates (ro) ls, cat (rebuilt on new session, /cwd, /agent) pl/ plans (r/w) ls, cat, edit + b/ batch jobs (ephemeral) ls + idx job index (ro) cat: id status cwd agent, one per line + new create job (r/w) cat: KV template; write spec to submit + / job directory rm -r to cancel and remove + spec original job spec (ro) + status job status (ro) running | done | failed: + result assistant reply (ro) + usage token counts (ro) + ctxsz context size (ro) 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" > @@ -40,7 +49,6 @@ ollie/ model active model (r/w) models available models (ro) prompt submit prompt (w) - reply last reply (ro) state agent state (ro) idle | thinking | calling: systemprompt rendered system prompt (ro) usage token counts (ro)