docs: remove FUSE mount references, use ollie-9p CLI
- Update README examples to use ollie-9p instead of /mnt/ollie paths - Remove OLLIE mount path from env.sample (no longer needed) - Update network transparency section for direct 9P access
This commit is contained in:
parent
1766b7c2bb
commit
361a68bc3a
43
README.md
43
README.md
|
|
@ -122,38 +122,38 @@ server — there is no D-Bus interface.
|
|||
|
||||
The 9P server exposes the agent runtime as a synthetic filesystem. Every session
|
||||
is a directory; every operation is a read or write. There is no client library,
|
||||
no SDK, no protocol buffer — `echo`, `cat`, `tail`, and `rm` are the API.
|
||||
no SDK, no protocol buffer — `ollie-9p` commands are the API.
|
||||
|
||||
```sh
|
||||
# Create a session
|
||||
echo "name=worker" > /mnt/ollie/session/new
|
||||
echo "name=worker" | ollie-9p write session/new
|
||||
|
||||
# Submit a prompt
|
||||
echo "fix the bug in main.go" > /mnt/ollie/session/{sname}/agent/{aname}/prompt
|
||||
echo "fix the bug in main.go" | ollie-9p write session/{sname}/agent/{aname}/prompt
|
||||
|
||||
# Stream the response
|
||||
tail -f /mnt/ollie/session/{sname}/agent/{aname}/chat
|
||||
ollie-9p read session/{sname}/agent/{aname}/chat
|
||||
|
||||
# Check state
|
||||
cat /mnt/ollie/session/{sname}/agent/{aname}/state
|
||||
ollie-9p read session/{sname}/agent/{aname}/state
|
||||
|
||||
# One-shot generation (no session needed)
|
||||
exec 3<>/mnt/ollie/generate; echo 'explain monads' >&3; cat <&3; exec 3>&-
|
||||
echo 'explain monads' | ollie-9p rdwr generate
|
||||
|
||||
# Route a task to the best model
|
||||
exec 3<>/mnt/ollie/route; echo 'redesign the auth system' >&3; cat <&3; exec 3>&-
|
||||
echo 'redesign the auth system' | ollie-9p rdwr route
|
||||
# → backend=kiro model=claude-sonnet-4-20250514
|
||||
```
|
||||
|
||||
### Network transparency
|
||||
|
||||
9P is a network protocol. Mount the agent from any machine:
|
||||
9P is a network protocol. Connect to a remote agent:
|
||||
|
||||
```sh
|
||||
ollie-9p mount tcp!server:5640 ~/mnt/ollie
|
||||
ollie-9p -addr tcp!server:5640 read session/idx
|
||||
```
|
||||
|
||||
No SSH tunneling, no port forwarding, no API gateway. One mount and every
|
||||
No SSH tunneling, no port forwarding, no API gateway. One connection and every
|
||||
session, every tool, every config value is accessible as if local.
|
||||
|
||||
### Pipe `o`: a composable CLI
|
||||
|
|
@ -205,20 +205,23 @@ background `statewait` reader. No SDK, no widget toolkit, no event loop.
|
|||
It's the Plan 9 principle in miniature — shell composition over framework
|
||||
bloat.
|
||||
|
||||
Because operations are file I/O, they compose with the full Unix toolkit:
|
||||
Because operations are 9P I/O, they compose with scripts:
|
||||
|
||||
```sh
|
||||
# Fan out a prompt to all agents
|
||||
for s in /mnt/ollie/session/*/agent/*/prompt; do echo "run tests" > "$s"; done
|
||||
for s in $(ollie-9p read session/idx | cut -f1); do
|
||||
for a in $(ollie-9p ls session/$s/agent | grep -v new); do
|
||||
echo "run tests" | ollie-9p write session/$s/agent/$a/prompt
|
||||
done
|
||||
done
|
||||
|
||||
# Wait for all agents to finish
|
||||
for s in /mnt/ollie/session/*/agent/*/statewait; do cat "$s" > /dev/null; done
|
||||
|
||||
# Grep all agent plans
|
||||
grep -r "TODO" /mnt/ollie/session/*/plan
|
||||
|
||||
# Monitor costs
|
||||
paste /mnt/ollie/session/*/agent/*/cost
|
||||
# Read all agent plans
|
||||
ollie-9p read session/idx | cut -f1 | while read s; do
|
||||
ollie-9p ls session/$s/agent | grep -v new | while read a; do
|
||||
echo "=== $s/$a ==="
|
||||
ollie-9p read session/$s/agent/$a/plan
|
||||
done
|
||||
done
|
||||
|
||||
# Strip block markup from chat output (text-only frontends)
|
||||
ollie-9p read session/{sname}/agent/{aname}/chat | grep -vE '^\[\[\[.*'
|
||||
|
|
|
|||
|
|
@ -3,9 +3,6 @@
|
|||
# Lines beginning with # and blank lines are ignored.
|
||||
# Inline comments are supported: KEY=value # comment
|
||||
|
||||
# Mount path for the 9P filesystem (default: ~/mnt/ollie)
|
||||
#OLLIE=~/mnt/ollie
|
||||
|
||||
# Default backend (default: ollama)
|
||||
# Supported: ollama, openai, openrouter, anthropic, copilot, kiro
|
||||
#OLLIE_BACKEND=ollama
|
||||
|
|
|
|||
Loading…
Reference in New Issue