Kandev

Manage and run tasks in parallel. Orchestrate agents. Review changes. Ship value.

Features | Workflows | Run as a Service | Debug Logs | Roadmap | Contributing | Architecture | Discord

<p align="center"> <img src="docs/screenshots/readme-intro.gif" alt="Kandev Demo"> </p>

See screenshots

What

Kandev is a powerful tool for power users who want deeper control over how AI agents work: customize workflows, agent profiles, runtimes, prompts, and review gates to match your process.

Organize work across kanban and pipeline views with opinionated workflows and execute multiple tasks in parallel. Assign agents from any provider, and review their output in an integrated workspace - file editor, file tree, terminal, browser preview, and git changes in one place. Terminal agent TUIs are great for running agents, but reviewing and iterating on changes there doesn't scale.

Run it locally or self-host it on your own infrastructure and access it from anywhere via Tailscale or any VPN.

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

Vision

Humans stay in control. Define tasks, build agentic workflows with gates, review every change, decide what ships.

• Review-first - Humans support production systems. We need to understand (yet) and trust the code that gets deployed.
• Your workflow - Every team is different, and not every developer uses AI the same way. Define workflows once, share them across the team, and give everyone a consistent process for working with agents - regardless of experience level.
• Remote agents - Running multiple agents on a large codebase can quickly saturate a local machine. The goal is a single control plane: offload execution to servers, orchestrate from anywhere, including your phone.

Features

• Multi-agent support - Claude Code, Codex, GitHub Copilot, Gemini CLI, Amp, Auggie, OpenCode, Cursor, Devin, Qwen, Factory Droid, iFlow, Kilocode, Pi, Kimi, AWS Kiro, Qoder, Trae, Oh My Pi, Grok, Hermes
• Parallel task execution – start and manage multiple tasks from different sources simultaneously, boosting productivity with AI agents
• Integrated workspace - Built-in terminal, code editor with LSP, git changes panel, embedded vscode and chat in one IDE-like view
• Kanban task management - Drag-and-drop boards, columns, and workflow automation
• Agentic workflows - Multi-step pipelines that mix-and-match agents per step - for example, Claude Code Opus to design a plan, GitHub Copilot Sonnet to implement it, and Codex GPT 5.4 to review the changes. See docs/workflow-tips.md
• Sub-tasks - Agents can spawn sub-tasks that resume from the parent task's session. Useful for splitting a task that has grown too big, or producing several PRs from the same starting point.
• CLI passthrough - Drop into raw agent CLI mode for direct terminal interaction with agents that support it, leveraging their full native TUI
• Workspace isolation - Git worktrees prevent concurrent agents from conflicting
• Multi-repository tasks - Span a single task across multiple repositories, with one worktree per repo, per-repo branches, per-repo PRs, and per-repo grouping in the Changes panel and review dialog
• Flexible runtimes - Run agents as local processes, in isolated Docker containers, on remote servers via SSH, or in cloud executors like sprites.dev
• Runtime settings - Executor profiles, secrets, custom prompts, utility agents, voice mode, and resource metrics are configurable from Settings
• Task-agent MCP - Agents can create subtasks, target sibling repos, attach extra branches for multiple PRs, message other tasks, read conversations, and inspect related tasks
• External MCP - Manage Kandev from outside coding agents over streamable HTTP or SSE, with copyable config snippets for popular agent CLIs
• Workflow portability - Export and import workflows as portable YAML across workspaces or Kandev installs
• Session management - Resume and review agent conversations
• Shareable task snapshots - Publish redacted task conversation snapshots as secret GitHub Gists, with preview and revoke controls
• Stats - Track your productivity with stats on the completed tasks, agent turns, etc

See docs/features.md for the full feature inventory, including settings, secrets, custom prompts, and MCP task capabilities.

In progress: Office mode

We're working on Office mode, a feature-flagged autonomy layer for persistent agent teams. The direction is agent instances with roles and permissions, dashboards, inbox/approvals, routines, task delegation, skills, memory, cost tracking, budgets, and workspace config sync. We'll document Office as a supported feature after it is live.

Integrations

<p align="center"> <a href="https://github.com/"><img src="https://img.shields.io/badge/GitHub-181717?style=for-the-badge&logo=github&logoColor=white" alt="GitHub"></a> <a href="https://www.atlassian.com/software/jira"><img src="https://img.shields.io/badge/Jira-0052CC?style=for-the-badge&logo=jira&logoColor=white" alt="Jira"></a> <a href="https://linear.app/"><img src="https://img.shields.io/badge/Linear-5E6AD2?style=for-the-badge&logo=linear&logoColor=white" alt="Linear"></a> <a href="https://sentry.io/"><img src="https://img.shields.io/badge/Sentry-362D59?style=for-the-badge&logo=sentry&logoColor=white" alt="Sentry"></a> <a href="https://gitlab.com/"><img src="https://img.shields.io/badge/GitLab-FC6D26?style=for-the-badge&logo=gitlab&logoColor=white" alt="GitLab"></a> <a href="https://slack.com/"><img src="https://img.shields.io/badge/Slack-4A154B?style=for-the-badge&logo=slack&logoColor=white" alt="Slack"></a> </p>

Connect Kandev to the tools your team already uses — pull issues into the kanban, link tasks to PRs, and surface review activity inline.

Supported ACP Agents

| Agent | Package / command | |:-------:|:----------:| | Claude Code | @agentclientprotocol/claude-agent-acp | | Codex | @agentclientprotocol/codex-acp | | GitHub Copilot | @github/copilot | | Gemini CLI | @google/gemini-cli | | Amp | amp-acp | | Auggie | @augmentcode/auggie | | OpenCode | opencode-ai | | Cursor | cursor-agent (requires Cursor Pro) | | Devin | devin (install Devin CLI from Devin Desktop or standalone installer) | | Qwen | @qwen-code/qwen-code | | Factory Droid | droid | | iFlow (beta) | @iflow-ai/iflow-cli | | Kilocode | @kilocode/cli | | Pi | pi-acp | | Kimi | kimi (install Kimi CLI from Moonshot AI) | | Kiro | kiro-cli-chat (install Kiro CLI from AWS) | | Qoder | qodercli (install Qoder CLI) | | Trae | traecli (install Trae IDE CLI) | | Oh My Pi | omp (install @oh-my-pi/pi-coding-agent with Bun) | | Grok | grok (install @xai-official/grok with npm) | | Hermes | hermes (install with the official Hermes installer) |

All agents communicate via ACP (Agent Client Protocol). Some agents support ACP natively, while others use ACP adapter packages that bridge their native protocols. CLI Passthrough mode is available when an integration provides a passthrough command. If your agent isn't supported yet, open an issue or submit a PR with the integration. See Adding a New Agent CLI for a step-by-step guide.

Kandev does not pin the managed npm runtimes for Claude, Codex, OpenCode, Copilot, or Gemini. Normal launches can reuse npm's best-effort execution cache. To deliberately fetch an upstream release, use Update agent in Settings > Agents; Kandev updates the host runtime and refreshes its advertised models and modes for future sessions without restarting active sessions. See Agents and Profiles.

Bring your own TUI agents

Kandev can run any agent CLI as a TUI inside a terminal, even when it does not speak ACP. Add the command in agent profile settings and the task starts that agent inside a PTY terminal. CLI passthrough keeps the agent's native terminal UX available while still giving Kandev task tracking, worktrees, review, and session management.

Supported Executors

| Executor | Description | |:--------:|-------------| | Local Process | Runs the agent as a local process on the host machine | | Docker | Runs the agent in an isolated Docker container | | SSH | Runs the agent on a remote server over SSH | | Sprites | Runs the agent in a remote cloud environment via sprites.dev |

Executors support profiles for reusable runtime configuration: prepare scripts, environment variables, credentials, and settings. Worktree-based tasks can also attach multiple repositories or multiple branches from the same repository, which lets one task produce several PRs when the work needs it.

Quick Start

Homebrew (macOS, Linux)

brew install kdlbs/kandev/kandev
kandev

Scoop (Windows)

scoop bucket add kandev https://github.com/kdlbs/scoop-kandev
scoop install kandev
kandev

Installs the native bundle — no Node.js required.

NPX

npx kandev@latest

Requires npm 7+. Installs the CLI plus a platform-matched runtime bundle in one step.

NPM (global)

npm install -g kandev@latest
kandev

Updates

• brew upgrade kandev
• scoop update kandev
• npx kandev@latest (always uses the latest published version)
• npm install -g kandev@latest

To try the current prerelease from main, use npm's nightly tag:

npx -y kandev@nightly
# or
npm install -g kan