Oh My Kanban

Contrabass is a terminal-first orchestrator for issue-driven agent runs, with an optional local web dashboard for live visibility.

Current scope

Today Contrabass ships with:

• A Cobra CLI with TUI, headless, and optional embedded web dashboard modes
• A WORKFLOW.md parser with YAML front matter, Liquid prompt rendering, and $ENV_VAR interpolation
• Issue tracker adapters for Linear, GitHub Issues, and a built-in Internal Board (local filesystem, no external service required)
• Agent runners for Codex app-server, OpenCode, and oh-my-opencode
• Git-worktree-based workspace provisioning under workspaces/
• Teams: multi-agent coordination with a local task board, phased pipeline (plan → exec → verify), and live TUI team table
• An orchestrator with claim/release, timeout detection, stall detection, deterministic retry backoff, and state snapshots
• A Charm v2 terminal UI built with Bubble Tea, Bubbles, and Lip Gloss
• A React dashboard served from the Go binary, with state snapshots and live SSE updates
• Go unit/integration tests, TUI snapshot tests, and dashboard component/hook tests

Requirements

• Go 1.25+
• Bun 1.3+ for the dashboard/landing workspace
• Git (workspace creation uses git worktree)
• A supported agent runtime:
  • codex app-server
  • opencode serve
  • or oh-my-opencode
• Tracker credentials for the backend you use:
  • Linear: LINEAR_API_KEY
  • GitHub: GITHUB_TOKEN

From a fresh