Open-source VS Code extension that coordinates multiple AI coding CLIs from one chat UI:
Status: Early MVP — ACP-only, task-model architecture (TaskEngine + SqliteTaskRepository is the sole host path). Five ACP backends are implemented: Claude, Grok, Kiro, Codex, OpenCode. Grok, Kiro, and OpenCode speak ACP natively; Claude and Codex use standard ACP adapters (claude-agent-acp / codex-acp) that are bundled into the extension so no extra install is needed beyond the CLI itself. Durable state is SQLite-only (muster.sqlite3); there is no JSON task store. See docs/TASK-MANAGEMENT.md and docs/SQLITE-STORAGE.md.
| Feature | Status |
|---|---|
ACP client (acp-client.ts) |
✅ |
Grok ACP backend (grok --no-auto-update agent stdio) |
✅ |
Kiro ACP backend (kiro-cli acp) |
✅ |
OpenCode ACP backend (opencode acp) |
✅ |
Claude ACP backend (bundled @agentclientprotocol/claude-agent-acp) |
✅ |
Codex ACP backend (bundled @agentclientprotocol/codex-acp) |
✅ |
| Antigravity ACP backend | 🔜 (entry TBD) |
Session resume (session/load) |
✅ |
Task model (SqliteTaskRepository + TaskEngine) |
✅ |
| Webview task UI (list + workspace, protocol v2) | ✅ |
| Muster Bridge + coordinator tools | ✅ |
MCP via mcpServers (context + Bridge) |
✅ |
| ACP RFD elicitation + Grok ask adapter | ✅ — MCP ask_user removed; see MUSTER-BRIDGE.md |
| Reload recovery UI (Retry / Continue / Resume) | ✅ |
| Read-only presentation tabs | ✅ — review and revision guide |
- Node.js 20+ (CI and the M002 quality gate target Node 24 LTS)
- VS Code 1.101+ (matches
engines.vscodeinpackage.json; 1.100 and older are rejected — the task engine needsnode:sqlitein the extension host) - The CLI for whichever backend you use, on
PATHand logged in:- Claude Code (
claude) — Claude backend - Grok CLI (
grok) — Grok backend - Kiro CLI (
kiro-cli) — Kiro backend - Codex CLI (
codex) — Codex backend - OpenCode (
opencode) — OpenCode backend
- Claude Code (
The Claude and Codex ACP adapters (@agentclientprotocol/claude-agent-acp, @agentclientprotocol/codex-acp) are bundled into the extension (resources/*/index.mjs) and pointed at your installed CLI via CLAUDE_CODE_EXECUTABLE / CODEX_PATH, so no extra install is required. Grok, Kiro, and OpenCode speak ACP natively (… agent stdio / acp).
git clone https://github.com/lploc94/muster.git
cd muster
npm install
npm run watch # compile on saveIn VS Code: Run and Debug → Run Extension (or F5). This opens an Extension Development Host with Muster loaded.
Each backend has an mvp:<backend> script that runs one ACP turn from the terminal:
npm run mvp:claude -- "your prompt here"
npm run mvp:grok -- "your prompt here"
npm run mvp:kiro -- "your prompt here"
npm run mvp:codex -- "your prompt here"
npm run mvp:opencode -- "your prompt here"
# resume a session
RESUME_ID=<session-id> npm run mvp:claude -- "continue"ABORT_MS=<ms> schedules an abort to exercise cancellation.
npm run test:agy-askDev-only file IPC proof — production design uses Muster Bridge.
| Doc | Contents |
|---|---|
| docs/DESIGN.md | Architecture overview |
| docs/ADAPTER-SPEC.md | Backend adapter contract |
| docs/CLI-COMMANDS.md | Per-CLI flags & streaming |
| docs/MUSTER-BRIDGE.md | Bridge / AskBridge (Grok vendor); MCP ask_user removed |
| docs/MCP-INJECTION.md | MCP config per backend |
| docs/SESSION-MANAGEMENT.md | Session IDs & resume |
| docs/TASK-MANAGEMENT.md | Task/turn model, TaskEngine, and Markdown export contract |
| docs/SETTINGS.md | Host-backed Settings pattern |
| docs/SETTINGS-DESIGN.md | Adopted four-domain Settings information architecture; three actionable tabs rendered and Connections reserved |
| docs/WEBVIEW.md | Chat UI, read-only presentation review/revision, and task Markdown export UX |
| docs/SQLITE-STORAGE.md | SQLite global storage, backup/reset, recovery, and privacy |
| docs/UI-VISUAL-REGRESSION.md | Pinned Linux visual baselines: compare, explicit update, CI artifacts, troubleshooting |
| docs/UI-IMPROVEMENT-ROADMAP.md | Deferred prioritized UI work (a11y, hit targets, motion, theme/zoom, density) — not implemented in M014 |
Full index: docs/README.md.
See CONTRIBUTING.md.