Kandev

Manage tasks. Orchestrate agents. Review changes. Ship value.

Quick Start

Homebrew

brew install kdlbs/kandev/kandev
kandev

NPX (requires npm 7+)

npx kandev@latest

Either install path resolves a platform-matched runtime (Go backend, agentctl, Next.js standalone web), launches the backend + web, and opens your browser. Data (worktrees, SQLite DB) is stored in ~/.kandev by default.

Version and Updates

The package manager owns the runtime version. [email protected] ships with the matching runtime.

• Update via Homebrew: brew upgrade kandev
• Update via npm/npx: npx kandev@latest or npm install -g kandev@latest
• Print CLI version: kandev --version

Advanced: pin a specific runtime tag

--runtime-version <tag> downloads a specific GitHub release runtime instead of using the installed one. For debugging compatibility issues only:

kandev --runtime-version v0.16.0

Run as a Service

Install kandev as a systemd (Linux) or launchd (macOS) service so it auto-starts and stays running across reboots:

kandev service install                   # user mode (laptop, single-user)
sudo kandev service install --system     # system mode (VPS, shared host)

See docs/run-as-a-service.md for the full guide — user vs system mode comparison, update workflow, troubleshooting.

What You Get

• Multi-agent support - Claude Code, Codex, GitHub Copilot, Gemini CLI, Amp, Auggie, OpenCode
• Integrated workspace - Terminal, code editor with LSP, git changes, browser preview, and chat
• Kanban & pipeline views - Organize tasks with opinionated workflows and gates
• CLI passthrough - Drop into raw agent TUI mode for full terminal access
• Workspace isolation - Git worktrees prevent concurrent agents from conflicting
• Session management - Resume and review agent conversations

Supported Agents

| Agent | Default Model | Protocol | | ------------------ | -------------- | ----------- | | Claude Code | Sonnet 4.5 | stream-json | | Codex | GPT-5.2 Codex | Codex | | GitHub Copilot | GPT-4.1 | Copilot SDK | | Gemini CLI | Gemini 3 Flash | ACP | | Amp | Smart Mode | stream-json | | Auggie | Sonnet 4.5 | ACP | | OpenCode | GPT-5 Nano | REST/SSE |

Beta - Under active development. Expect rough edges and breaking changes.

Requirements

• Node.js (for npx)
• Git
• Docker (optional - needed for container runtimes)

Platforms

• macOS (Intel + Apple Silicon)
• Linux (x64)
• Windows (x64, WSL)

Learn More

Open source, multi-provider, no telemetry, not tied to any cloud.

See the GitHub repository for architecture, vision, development setup, and contributing guidelines.

License

AGPL-3.0