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:
Levi Neely 2026-08-05 08:25:02 +02:00
parent 1766b7c2bb
commit 361a68bc3a
2 changed files with 23 additions and 23 deletions

View File

@ -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 '^\[\[\[.*'

View File

@ -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