TaskBridge

Claude plans. OpenCode builds. Dispatch real coding work from Claude to headless OpenCode agents via a durable SQLite queue.

Claude submits tasks over MCP. An auto-worker picks them up in ~60 s, runs opencode run in an isolated worktree, and returns a structured summary, git-aware diff, logs, and usage for Claude to read. Works from Claude Desktop (stdio), any MCP client over HTTP, and in reverse — OpenCode can drive Claude too.

Why this exists

Claude is a powerful planner that can’t touch your filesystem. OpenCode runs code locally but lives outside Claude’s context. The bridge closes the loop:

• Claude stays the interface — breaks work down, delegates, and reads results.
• OpenCode does the execution — edits, tests, shell, headlessly and reproducibly.
• SQLite is the durable handoff — survives restarts, supports retries, priorities, dependencies, and two-way questions.

Features

• 17 MCP tools for Claude — submit_task, submit_batch (up to 20), get_task / get_task_result, get_task_logs (live tail), wait_for, answer_task, list_tasks, queue_status / worker_heartbeat, restart_worker (recover a dead/stale worker through launchd, from the MCP server itself), add_task_note, cancel_task / clear_finished, list_models / set_default_model, ping. No polling loops, full observability.
• Headless auto-worker (worker.py) — launchd polls every 60 s, claims oldest-first by priority, streams output to task_logs/.log, returns structured {summary, files_touched, tests_run, open_questions} plus a git-aware diff.
• Two-way questions — worker can pause with a question block → task goes waiting + macOS banner → Claude answers via answer_task → run resumes with the answer in context.
• Worktree isolation — per-task branch + git worktree, auto-committed on success, cleaned up unless worktree_keep.
• Honest permissions — readonly reverts writes and reports reverted files; no-network / no-shell are prompt-level and explicitly labeled.
• Reverse bridge (claude_control_mcp.py) — 6 tools for OpenCode to drive Claude: claude_ask (sync), claude_submit / claude_poll / claude_result / claude_cancel (background), claude_status. Uses Anthropic API if ANTHROPIC_API_KEY is set, else claude -p.
• Public-URL mode (install.sh / start_public.sh) — one command to expose MCP through a temporary Cloudflare quick tunnel (default, no account needed) or ngrok, with automatic MCP_ALLOWED_HOSTS pairing. The installer asks which tunnel to use.