Giới thiệu
Wuphf là multi-agent terminal office mã nguồn mở viết bằng Go, cho phép nhiều AI coding agent (Claude Code, Codex, OpenClaw) cùng cộng tác qua một broker và một bộ memory chia sẻ git-native. Tên gọi lấy từ The Office — startup mà Ryan Howard đốt $10K của Michael Scott — nhưng repo này thì ship được thật.
Điểm khác biệt so với các orchestrator khác: thay vì giả lập trí nhớ bằng cách đẩy lịch sử dài vào mỗi prompt, Wuphf hiện thực ý tưởng LLM wiki của Karpathy — agents tự ghi episode, một synthesis worker shell ra LLM CLI của bạn để gộp episode thành facts, rồi commit kết quả vào git repo dưới identity archivist.
Tính năng chính
- LLM Wiki kiểu Karpathy: git-native team memory với UI Wikipedia-style. Code chính ở
internal/team/wiki_git.go,internal/team/wiki_worker.go,web/src/components/wiki/. - Multi-agent broker: Claude Code, Codex và OpenClaw chạy chung, broker đẩy notification để wake agent — không heartbeat polling, không idle burn token.
- Per-role MCP scoping: mỗi role chỉ load tools cần thiết. DM mode load 4 MCP tools thay vì 27 — schema prompt nhỏ lại, prompt cache hit của Anthropic API lên tới 97%.
- Worktree isolation: mỗi agent có workspace riêng (
internal/team/worktree.go), không đè file của nhau khi parallel. - Fresh session per turn: không tích tụ context qua
--resume, prefix prompt giống nhau giữa turn nên cache prefix làm việc tốt. - Sonnet làm CEO mặc định: tiết kiệm token, dùng
--opus-ceođể upgrade khi tác vụ phức tạp (internal/team/headless_claude.go:203). - Hai action provider: One CLI mặc định, hoặc Composio (
internal/action/registry.go). - OpenClaw bridge: kéo các agent có sẵn vào office (
internal/team/openclaw.go). - Telegram bridge và live web-view streaming (partial).
- Resume in-flight work on restart (đã ship từ v0.0.2.0).
Cách sử dụng
Demo wiki LLM tự viết:
WUPHF_MEMORY_BACKEND=markdown HOME="$HOME/.wuphf-dev-home" \
./wuphf-dev --broker-port 7899 --web-port 7900 &
./scripts/demo-entity-synthesis.shYêu cầu: curl, python3, broker chạy với --memory-backend markdown, và một LLM CLI (claude / codex / openclaw) trong PATH. Các env var BROKER, ENTITY_KIND, ENTITY_SLUG, AGENT_SLUG, THRESHOLD override default — xem header của script.
Benchmark trên máy bạn:
wuphf --pack starter &
./scripts/benchmark.shĐánh giá repo trước khi fork
Team Wuphf gợi ý chạy prompt sau với coding assistant (Claude Code, Cursor, Codex) để có cái nhìn cynical, không marketing:
You are a cynical senior engineer evaluating whether to fork this repo as the
base for a multi-agent terminal office product. No prior context — explore it
as you naturally would. Tell me: should I fork this, and what's your honest
take? Be specific: file paths, line numbers, actual evidence. "The docs are
bad" is useless. Under 500 words.Claim status table
Repo có table mapping từng tính năng về trạng thái (✅ shipped · 🟡 partial · 🔜 planned) và file path cụ thể — đọc table đó là cách nhanh nhất biết cái gì đã chạy được, cái gì chưa. Ví dụ: live web-view streaming còn 🟡 partial, prebuilt binary qua goreleaser còn 🟡 (config sẵn nhưng tag chưa release).
Dev nên quan tâm vì
Nếu bạn đang tự build agent orchestration, đây là một trong số ít implementation thật sự ship code chứ không phải vaporware. Architecture đáng học: prompt cache thân thiện với Anthropic API, push-driven thay vì polling, scoped tools để giữ context window nhỏ. License MIT.