lkn
/
ollie
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: replace agent/0 with agent/{aname} in path templates

This commit is contained in:
Ollie Agent 2026-08-04 19:26:22 +02:00
parent 6ceebe7ee1
commit 0f8cfd0c14
3 changed files with 18 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
README.md
View File

@ -139,13 +139,13 @@ no SDK, no protocol buffer — `echo`, `cat`, `tail`, and `rm` are the API.
echo "name=worker" > /mnt/ollie/session/new
# Submit a prompt
echo "fix the bug in main.go" > /mnt/ollie/session/worker/agent/0/prompt
echo "fix the bug in main.go" > /mnt/ollie/session/worker/agent/{aname}/prompt
# Stream the response
tail -f /mnt/ollie/session/worker/agent/0/chat
tail -f /mnt/ollie/session/worker/agent/{aname}/chat
# Check state
cat /mnt/ollie/session/worker/agent/0/state
cat /mnt/ollie/session/worker/agent/{aname}/state
# One-shot generation (no session needed)
exec 3<>/mnt/ollie/generate; echo 'explain monads' >&3; cat <&3; exec 3>&-

2
data/agents/README.md
View File

@ -16,7 +16,7 @@ The system prompt is assembled from the `prompt` array in the agent config. Each
The base system prompt is embedded in the binary and automatically prepended.
The fully assembled system prompt is visible at `session/<id>/agent/0/systemprompt`.
The fully assembled system prompt is visible at `session/{id}/agent/{aname}/systemprompt`.
## Hooks

28
doc/usage.md
View File

@ -193,7 +193,7 @@ Parameters are set in the agent config JSON and can be overridden at runtime by
writing `key=value` to the agent config. Runtime overrides take precedence:
```sh
echo "temperature=0.3" | ollie-9p write session/mysession/agent/0/cfg
echo "temperature=0.3" | ollie-9p write session/mysession/agent/{aname}/cfg
```
| Key | Type | Description |
@ -272,7 +272,7 @@ them via the filesystem:
```sh
printf 'name=writer\ncwd=%s\n' "$PWD" | o write session/new
printf 'name=reviewer\ncwd=%s\n' "$PWD" | o write session/new
o write prompt "Draft a design doc" # with session=writer agent=0
o write prompt "Draft a design doc" # with session=writer agent={aname}
o tail # read writer's response
```
@ -306,16 +306,16 @@ printf 'name=tester\nagent=tester\ncwd=%s\n' "$cwd" | 9p write session/new
send() {
sid=$1; shift
exec 3< session/$sid/agent/0/statewait
printf '%s' "$*" > session/$sid/agent/0/prompt
exec 3< session/$sid/agent/{aname}/statewait
printf '%s' "$*" > session/$sid/agent/{aname}/prompt
while true; do
read -r _ <&3 && { exec 3<&-; break; }
exec 3<&-
[ "$(cat session/$sid/agent/0/state)" != "idle" ] && break
exec 3< session/$sid/agent/0/statewait
[ "$(cat session/$sid/agent/{aname}/state)" != "idle" ] && break
exec 3< session/$sid/agent/{aname}/statewait
done
until [ "$(cat session/$sid/agent/0/state)" = "idle" ]; do sleep 0.5; done
tail -c +$(($(cat session/$sid/agent/0/offset) + 1)) session/$sid/agent/0/chat
until [ "$(cat session/$sid/agent/{aname}/state)" = "idle" ]; do sleep 0.5; done
tail -c +$(($(cat session/$sid/agent/{aname}/offset) + 1)) session/$sid/agent/{aname}/chat
}
reply=$(send developer "Implement a function that parses a JSON config file.")
@ -382,19 +382,19 @@ ollie-9p mount tcp!server:9564 ~/mnt/ollie
echo "name=worker" > session/new
# Submit a prompt
echo "fix the bug in main.go" > session/worker/agent/0/prompt
echo "fix the bug in main.go" > session/worker/agent/{aname}/prompt
# Stream the response
cat session/worker/agent/0/chat
cat session/worker/agent/{aname}/chat
# Check state
cat session/worker/agent/0/state
cat session/worker/agent/{aname}/state
# Block until state changes
cat session/worker/agent/0/statewait
cat session/worker/agent/{aname}/statewait
# Read offset (byte position after user prompt)
cat session/worker/agent/0/offset
cat session/worker/agent/{aname}/offset
```
### Network transparency
@ -404,7 +404,7 @@ session, tool, and config value is accessible as if local:
```sh
# From another machine:
9p -a 'tcp!server:5640' read session/worker/agent/0/state
9p -a 'tcp!server:5640' read session/worker/agent/{aname}/state
```
No SSH tunneling, no port forwarding, no API gateway.