{"id":45762329,"url":"https://github.com/kdlbs/kandev","last_synced_at":"2026-06-03T01:01:25.497Z","repository":{"id":340337605,"uuid":"1131388506","full_name":"kdlbs/kandev","owner":"kdlbs","description":"AI Kanban \u0026 Development Environment. Orchestrate multiple agents, review changes, open PRs. Multi-provider, self-hostable, no telemetry.","archived":false,"fork":false,"pushed_at":"2026-05-29T20:41:49.000Z","size":88356,"stargazers_count":294,"open_issues_count":44,"forks_count":31,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-29T21:09:41.241Z","etag":null,"topics":["acp","agent-orchestration","agentic-ai","agentic-development-environment","ai-agents","claude-code","code-review","coding-agents","developer-tools","github-copilot","golang","kanban","nextjs","open-source","self-hosted","task-manager","tui","vibe-coding","workflow-automation","worktrees"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kdlbs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-09T23:26:53.000Z","updated_at":"2026-05-29T21:04:03.000Z","dependencies_parsed_at":"2026-03-09T00:04:31.217Z","dependency_job_id":"e79c4621-300c-447b-b939-8a5428266218","html_url":"https://github.com/kdlbs/kandev","commit_stats":null,"previous_names":["kdlbs/kandev"],"tags_count":68,"template":false,"template_full_name":null,"purl":"pkg:github/kdlbs/kandev","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdlbs%2Fkandev","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdlbs%2Fkandev/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdlbs%2Fkandev/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdlbs%2Fkandev/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kdlbs","download_url":"https://codeload.github.com/kdlbs/kandev/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdlbs%2Fkandev/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33753925,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["acp","agent-orchestration","agentic-ai","agentic-development-environment","ai-agents","claude-code","code-review","coding-agents","developer-tools","github-copilot","golang","kanban","nextjs","open-source","self-hosted","task-manager","tui","vibe-coding","workflow-automation","worktrees"],"created_at":"2026-02-25T23:24:21.559Z","updated_at":"2026-06-01T00:00:48.254Z","avatar_url":"https://github.com/kdlbs.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kandev\n\nManage and run tasks in parallel. Orchestrate agents. Review changes. Ship value.\n\n[Workflows](docs/workflow-tips.md) | [Run as a Service](docs/run-as-a-service.md) | [Roadmap](docs/roadmap.md) | [Contributing](CONTRIBUTING.md) | [Architecture](docs/ARCHITECTURE.md) | [Discord](https://discord.gg/gWdCPGcFCD)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/screenshots/readme-intro.gif\" alt=\"Kandev Demo\"\u003e\n\u003c/p\u003e\n\n[See all screenshots](docs/screenshots.md)\n\n## What\n\n\nOrganize 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.\n\nRun it locally or self-host it on your own infrastructure and access it from anywhere via [Tailscale](https://tailscale.com/) or any VPN.\n\nOpen source, multi-provider, no telemetry, not tied to any cloud.\n\n## Vision\n\n\u003e **Humans stay in control.** Define tasks, build agentic workflows with gates, review every change, decide what ships.\n\n- **Review-first** - Humans support production systems. We need to understand (yet) and trust the code that gets deployed.\n- **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.\n- **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.\n\n## Features\n\n- **Multi-agent support** - Claude Code, Codex, GitHub Copilot, Gemini CLI, Amp, Auggie, OpenCode, Cursor, Qwen, Factory Droid, iFlow, Kilocode, Pi, Kimi, AWS Kiro, Qoder, Trae\n- **Parallel task execution** – start and manage multiple tasks from different sources simultaneously, boosting productivity with AI agents\n- **Integrated workspace** - Built-in terminal, code editor with LSP, git changes panel, embedded vscode and chat in one IDE-like view\n- **Kanban task management** - Drag-and-drop boards, columns, and workflow automation\n- **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/workflows.md](docs/workflow-tips.md)\n- **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.\n- **CLI passthrough** - Drop into raw agent CLI mode for direct terminal interaction with any supported agent, leverage the full power of their TUIs\n- **Workspace isolation** - Git worktrees prevent concurrent agents from conflicting\n- **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\n- **Flexible runtimes** - Run agents as local processes, in isolated Docker containers or in remote executors like sprites.dev\n- **Session management** - Resume and review agent conversations\n- **Stats** - Track your productivity with stats on the completed tasks, agent turns, etc\n\n## Integrations\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/\"\u003e\u003cimg src=\"https://img.shields.io/badge/GitHub-181717?style=for-the-badge\u0026logo=github\u0026logoColor=white\" alt=\"GitHub\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.atlassian.com/software/jira\"\u003e\u003cimg src=\"https://img.shields.io/badge/Jira-0052CC?style=for-the-badge\u0026logo=jira\u0026logoColor=white\" alt=\"Jira\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://linear.app/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Linear-5E6AD2?style=for-the-badge\u0026logo=linear\u0026logoColor=white\" alt=\"Linear\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nConnect Kandev to the tools your team already uses — pull issues into the kanban, link tasks to PRs, and surface review activity inline.\n\n## Supported ACP Agents\n\n| Agent | Launch |\n|:-------:|:----------:|\n| **Claude Code** | `npx -y @agentclientprotocol/claude-agent-acp` |\n| **Codex** | `npx -y @zed-industries/codex-acp` |\n| **GitHub Copilot** | `npx -y @github/copilot --acp` |\n| **Gemini CLI** | `npx -y @google/gemini-cli --acp` |\n| **Amp** | `npx -y amp-acp` |\n| **Auggie** | `npx -y @augmentcode/auggie --acp` |\n| **OpenCode** | `opencode acp` |\n| **Cursor** | `cursor-agent acp` *(requires Cursor Pro)* |\n| **Qwen** | `npx -y @qwen-code/qwen-code --acp` |\n| **Factory Droid** | `npx -y droid exec --output-format acp` |\n| **iFlow (beta)** | `npx -y @iflow-ai/iflow-cli --experimental-acp` |\n| **Kilocode** | `npx -y @kilocode/cli acp` |\n| **Pi** | `npx -y pi-acp` |\n| **Kimi** | `kimi acp` *(install Kimi CLI from Moonshot AI)* |\n| **Kiro** | `kiro-cli-chat acp` *(install Kiro CLI from AWS)* |\n| **Qoder** | `qodercli --acp` *(install Qoder CLI)* |\n| **Trae** | `traecli acp serve` *(install Trae IDE CLI)* |\n\n\u003e All agents communicate via [ACP](https://agentclientprotocol.com) (Agent Client Protocol). Some agents support ACP natively, while others use ACP adapter packages that bridge their native protocols. **CLI Passthrough mode** is also available for direct terminal interaction with any agent CLI. If your agent isn't supported yet, open an issue or submit a PR with the integration. See [Adding a New Agent CLI](docs/add-agent-cli.md) for a step-by-step guide.\n\n### Bring your own TUI agents\n\nThere is support for running any agent as TUI inside a terminal. Just add the cli command in the agent profile settings and the task will start the agent inside a PTY terminal instead of using ACP.\n\n## Supported Executors\n\n| Executor | Description |\n|:--------:|-------------|\n| **Local Process** | Runs the agent as a local process on the host machine |\n| **Docker** | Runs the agent in an isolated Docker container |\n| **Sprites** | Runs the agent in a remote cloud environment via [sprites.dev](https://sprites.dev) |\n\nEach executor uses git worktrees for workspace isolation, preventing concurrent agents from conflicting.\n\n## Quick Start\n\n### Homebrew (macOS, Linux)\n\n```bash\nbrew install kdlbs/kandev/kandev\nkandev\n```\n\n### NPX\n\n```bash\nnpx kandev@latest\n```\n\nRequires npm 7+. Installs the CLI plus a platform-matched runtime bundle in one step.\n\n### NPM (global)\n\n```bash\nnpm install -g kandev@latest\nkandev\n```\n\n### Updates\n\n- `brew upgrade kandev`\n- `npx kandev@latest` (always uses the latest published version)\n- `npm install -g kandev@latest`\n\nThe worktrees and sqlite db live in `~/.kandev` by default. Works on macOS, Linux, and Windows (WSL or native).\n\n### From Source\n\n```bash\n# Clone the repository\ngit clone git@github.com:kdlbs/kandev.git\ncd kandev\n\n# Start in production mode\nmake start\n```\n\n**Prerequisites:** Go 1.26+, Node.js 18+, pnpm, Docker (optional - needed for container runtimes)\n\n## High level architecture\n\n```mermaid\ngraph LR\n    UI[Web UI] --\u003e Backend\n\n\n        Backend[\"Backend (Orchestrator)\"]\n\n\n    Backend --\u003e W1 \u0026 W2\n\n    subgraph W1[Local Process]\n        Agent1[Agent CLI] --- WT1[Worktree]\n    end\n\n    subgraph W2[Docker Container]\n        Agent2[Agent CLI] --- WT2[Worktree]\n    end\n```\n\nWe also want to add support for these remote runtimes:\n- Remote SSH - run agents on remote servers over SSH, using docker or local processes with workspace isolation\n- K8s operator - run agents in a Kubernetes cluster, with auto-scaling and resource management.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eDevelopment\u003c/strong\u003e\u003c/summary\u003e\n\n### Project Structure\n\n```\napps/\n├── backend/    # Go backend (orchestrator, lifecycle, agentctl, WS gateway)\n├── web/        # Next.js frontend (SSR, Zustand, real-time subscriptions)\n├── cli/        # CLI tool (npx kandev launcher)\n└── packages/   # Shared UI components \u0026 types\n```\n\n### Prerequisites\n\n- Go 1.21+\n- Node.js 18+\n- pnpm\n- Docker (optional)\n\n### Running Dev Servers\n\n```bash\n# Start everything (backend + frontend with auto ports)\nmake dev\n\n# Or run separately\nmake dev-backend    # Backend on :38429\nmake dev-web        # Frontend on :37429\n```\n\n### Testing \u0026 Linting\n\n```bash\nmake test           # Run all tests (backend + web)\nmake lint           # Run all linters\nmake typecheck      # TypeScript type checking\nmake fmt            # Format all code\n```\n\n### Pre-commit Hooks\n\n```bash\n# Install pre-commit (https://pre-commit.com/#install)\npipx install pre-commit\n\n# Install git hooks\npre-commit install\n```\n\n\u003c/details\u003e\n\n## Comparison to Other Tools\n\nThere are a few similar tools in this space, and new ones appearing everyday. Here's what sets this one apart:\n\n- **Server-first architecture** - Not a desktop app. Runs as a server you can access from any device, including your phone. Start a task away from your computer and check in on it later.\n- **Remote runtimes** - Run agents on remote servers and Docker hosts, not just your local machine.\n- **Multi-provider** - Use Claude Code, Codex, Copilot, Gemini, Amp, Auggie, OpenCode, Cursor, Qwen, Droid, iFlow, Kilocode, Pi, Kimi, Kiro, Qoder, and Trae side by side. Not locked to one vendor.\n- **CLI passthrough and chat** - Interact with agents through structured chat messages or drop into raw CLI mode for full agent TUI capabilities.\n- **Open source and self-hostable** - No vendor lock-in, no telemetry, runs on your infrastructure.\n\n## Contributing\n\nContributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a PR.\n\nSee the [issue tracker](https://github.com/kdlbs/kandev/issues) for open tasks, or join our [Discord](https://discord.gg/gWdCPGcFCD) to chat with maintainers and other contributors.\n\n## Acknowledgments\n\nBuilt with these excellent open-source projects:\n\n[Monaco Editor](https://microsoft.github.io/monaco-editor/) · [Tiptap](https://tiptap.dev/) · [xterm.js](https://xtermjs.org/) · [dockview](https://dockview.dev/) · [CodeMirror](https://codemirror.net/) · [dnd-kit](https://dndkit.com/) · [Mermaid](https://mermaid.js.org/) · [Recharts](https://recharts.org/) · [TanStack Table](https://tanstack.com/table) · [Zustand](https://zustand.docs.pmnd.rs/) · [Shadcn/UI](https://ui.shadcn.com/) · [Radix UI](https://www.radix-ui.com/) · [Tailwind CSS](https://tailwindcss.com/)\n\n## License\n\n[AGPL-3.0](LICENSE)\n\n## Star History\n\n\u003ca href=\"https://www.star-history.com/?repos=kdlbs%2Fkandev\u0026type=date\u0026legend=top-left\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/chart?repos=kdlbs/kandev\u0026type=date\u0026theme=dark\u0026legend=top-left\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/chart?repos=kdlbs/kandev\u0026type=date\u0026legend=top-left\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/chart?repos=kdlbs/kandev\u0026type=date\u0026legend=top-left\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkdlbs%2Fkandev","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkdlbs%2Fkandev","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkdlbs%2Fkandev/lists"}