Favicon of Contrabass

Contrabass

A local AI coding agent orchestrator for macOS and Linux that connects Codex and OpenCode to project issues and shows progress in a terminal or dashboard.

Screenshot of Contrabass website

Contrabass coordinates AI coding agents working through project issues, for developers managing several tasks or agent teams. It runs locally on macOS and Linux and reimplements OpenAI's Symphony approach.

  • Issue-driven work: Connect Linear or GitHub Issues, or use the built-in local Internal Board; tasks with unresolved blockers wait before dispatch.
  • Agent coordination: Use Codex app-server, OpenCode, oh-my-opencode, OMX (oh-my-codex) or OMC (oh-my-claudecode), with team workflows covering planning, execution and verification.
  • Separate workspaces: Issue-specific Git worktrees keep agent tasks apart, with a plain-directory fallback for projects without Git.
  • Run oversight: The terminal interface and optional local Ziikoo browser dashboard show queues, agent stages, token use and completion estimates; the dashboard also provides live logs, board editing and agent stop controls.
  • Failure handling: Contrabass detects stalled runs, retries failures and recovers abandoned task claims after a restart, and checks for a new commit before marking a run successful.

The orchestrator requires a separate supported agent runtime. Its Internal Board, team state and workflow timelines use local files; Linear and GitHub integrations require credentials, and optional Linear timeline sync publishes workflow events as issue comments. Default team workers require tmux, while the in-process worker mode doesn't. Contrabass is open source under Apache 2.0.

Similar to Contrabass