gofer

README

gofer

Your errand-runner for agents. gofer is a daemon + TUI for running and supervising many coding agents at once — a roster of live sessions, peek/attach navigation, approvals that reach your phone — built in Go on agent-sdk-go.

Status: M0 scaffold. gofer demo streams a faux-provider session end-to-end through the SDK's typed event contract. The daemon, supervisor, and TUI land at M2 (see the roadmap).

What it will be

┌ overview ────────────────────────────────────────────┐
│ ● fix-ci        running   linux-build   $0.42  2m11s │
│ ● refactor-api  waiting   approval ⚠    $1.03  8m40s │
│ ○ docs-pass     done      —             $0.11  1h02m │
│                                                      │
│ [enter] peek · [a] attach · [ctrl-x] kill · [n] new  │
└──────────────────────────────────────────────────────┘

• One roster, many agents — every running session, its state, cost, and pending approvals in one screen; overview ⇄ peek ⇄ attach navigation.
• Everything is a client — the TUI, ACP clients (phone/editor), and headless exec all consume the same typed Event/Op stream. Attach from anywhere; the bytes are identical.
• Structural permissions — allow/ask/deny rules (Claude Code settings-compatible), approvals as protocol messages that render in the TUI or on your phone.
• Session lifecycle you can trust — event-sourced JSONL journals; kill or archive from the roster, resume after a crash, fork at any point. Journals are never deleted.

Try it (M0)

go run ./cmd/gofer demo

Streams a scripted faux-provider session through the real event pipeline — no API key, no network.

Roadmap

Stage	Ships
M0 · scaffold ✅	repo + gofer demo streaming the SDK's faux provider
M1 · one good session	real provider, builtin tools, resumable sessions, cost accounting
M2 · the daemon	supervisor, roster, overview⇄peek⇄attach TUI, native ACP
M3 · guardrails	permission engine + approvals UX, sandboxed exec, headless mode
M4 · ecosystem	MCP servers, SKILL.md skills, out-of-process plugins
M5 · auto + polish	auto mode with reviewer pipeline, multi-machine discovery

License

Apache-2.0. See NOTICE for attribution requirements.