Add 'Why 9P?' section

Explains design rationale: orchestration as file manipulation
Benefits: simplicity, universal access, composability
Placement: after Architecture, before Requirements

Addresses the 'why this obscure protocol' question upfront
This commit is contained in:
Levi Neely 2026-02-20 00:25:27 +01:00
parent 536b358006
commit ebeac0da6a
1 changed files with 4 additions and 0 deletions

View File

@ -8,6 +8,10 @@
**Clients:** Assist (Acme), anvillm.el (Emacs), anvillm (TUI), anvilweb (web)
**Benefits:** Shared sessions, crash-resilient, scriptable via 9P, service integration, MCP support
## Why 9P?
AnviLLM uses 9P because orchestration becomes file manipulation (`read`, `write`, `ls`, `stat`). Benefits: simplicity, universal access (shell, C, Go, Python, `cat`, `echo`), and composability (Unix pipes, `grep`, `awk`, `jq`). The only requirement is a 9P client (plan9port's `9p` or compatible).
## Requirements
Go 1.21+, plan9port, tmux, [landrun](https://github.com/zouuup/landrun) (kernel 5.13+), backend ([Claude Code](https://github.com/anthropics/claude-code) or [Kiro](https://kiro.dev))