kdlbs/kandev

Perfil de kdlbs

Última atividade de origem registrada: 6 de outubro de 2026 às 07:05

Catálogo do SkillsMP atualizado: 17 de outubro de 2026 às 00:09

skills coletadas: 46

Estrelas no GitHub: 907
Forks no GitHub: 147

README do repositório

Arquivo de origem do README: README.md

Ler o README original

Expandir README completo

# Kandev Manage and run tasks in parallel. Orchestrate agents. Review changes. Ship value. [Features](docs/features.md) | [Workflows](docs/workflow-tips.md) | [Run as a Service](docs/run-as-a-service.md) | [Mobile Access](docs/public/mobile-remote-access.md) | [Debug Logs](docs/debug-logs.md) | [Roadmap](docs/roadmap.md) | [Contributing](CONTRIBUTING.md) | [Architecture](docs/ARCHITECTURE.md) | [Discord](https://discord.gg/gWdCPGcFCD) <img src="docs/screenshots/readme-intro.gif" alt="Kandev Demo"> [See screenshots](docs/screenshots.md) ## 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. Use the [mobile remote-access guide](docs/public/mobile-remote-access.md) to connect through Tailscale, Cloudflare Tunnel, or another private VPN. Open source, multi-provider, no telemetry, not tied to any cloud. ## Distribution Kandev is distributed as a native Go binary for each supported platform. The compiled web frontend is embedded in that binary. The binary serves the web UI and API, so the application server does not need Node.js, a separate web server, or a frontend build at runtime. Homebrew, Scoop, release archives, and the desktop app run this native binary directly. The npm/npx package adds a small Node.js platform selector, so Node.js is required to launch Kandev through npm/npx but not by the application server. Release bundles also include `agentctl` helpers for task environments. ## 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, Antigravity - **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](docs/workflow-tips.md) - **Automations** - Trigger agent tasks on schedules or webhooks, with configurable run destinations, context, and concurrency - **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, 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 - **Plugin marketplace and management** - Browse, install, update, enable, disable, and configure plugins from Settings, including MCP Explorer and the [Bitbucket plugin](https://github.com/kdlbs/kandev-plugin-bitbucket) - **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](docs/features.md) for the full feature inventory, including settings, secrets, custom prompts, and MCP task capabilities. ### In progress: Office mode **Office mode** is an experimental autonomy layer for persistent agent teams, disabled by default in production. It includes agent roles and permissions, dashboards, inbox/approvals, routines, task delegation, skills, memory, cost tracking, budgets, and workspace config sync. The [Office guide](docs/public/office.md) covers explicit enablement, setup, and evaluation of the current implementation; Office is not yet a stable production contract. ## Integrations <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://azure.microsoft.com/products/devops"><img src="https://img.shields.io/badge/Azure%20DevOps-0078D7?style=for-the-badge&logo=azuredevops&logoColor=white" alt="Azure DevOps"></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> Connect Kandev to GitHub, GitLab, Jira, Linear, Sentry, and Azure DevOps to pull issues into the kanban, link tasks to PRs, and surface review activity inline. Bitbucket support is available through the [Bitbucket plugin](https://github.com/kdlbs/kandev-plugin-bitbucket). ## Supported Agent CLIs | Agent | Package / command | |:-------:|:----------:| | **Claude Code** | `@agentclientprotocol/claude-agent-acp` | | **Codex** | `@agentclientprotocol/codex-acp` | | **Codex app server** | `@openai/codex` *(experimental; enable in System > Feature Toggles)* | | **GitHub Copilot** | `@github/copilot` | | **Gemini CLI** | `@google/gemini-cli` | | **Amp** | `amp-acp` | | **Auggie** | `@augmentcode/auggie` | | **OpenCode** | v2: `@opencode/cli`; existing v1: `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** | ACP adapter: `pi-acp`; CLI passthrough: `pi` | | **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)* | | **Antigravity** | `agy_acp_server.par` / `.exe` *(no automated install; download from the [ACP registry](https://github.com/agentclientprotocol/registry/tree/main/antigravity-acp), extract both archive entries into one directory, and put that directory on PATH)* | > Most structured agent integrations communicate via [ACP](https://agentclientprotocol.com) (Agent Client Protocol). Codex app-server is a separate experimental native integration. **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](docs/public/add-agent-cli.md) for a step-by-step guide. Managed npm runtimes have reviewed defaults. To fetch a selected upstream release, use **Update agent** in **Settings > Agents**. Kandev refreshes its advertised models and modes for future sessions without restarting active sessions. Background notices cover enabled, available registered runtimes, with optional automatic updates for supported managed installations and manual guidance for external CLIs. See [Agents and Profiles](docs/public/agents-and-profiles.md#update-a-managed-agent-runtime). Fresh OpenCode installs use managed v2 (`@opencode/cli`). Existing v1 selections remain on `opencode-ai` until you choose the explicit migration action. Kandev leaves a separately installed `opencode` CLI unchanged. ### 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 | | **Kubernetes** | Runs each task session in an administrator-configured Pod with managed, existing, or disposable workspace storage | | **SSH** | Runs the agent on a remote server over SSH | | **Sprites** | Runs the agent in a remote cloud environment via [sprites.dev](https://sprites.dev) | Executors support profiles for reusable runtime configuration: prepare scripts, environment variables, credentials, and settings. On shared instances, [private executor ownership](docs/public/executors.md#private-executors-and-profiles) limits compute and profile access to the owner and configuration administrators. 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) ```bash brew install kdlbs/kandev/kandev kandev ``` ### Scoop (Windows) ```bash scoop bucket add kandev https://github.com/kdlbs/scoop-kandev scoop install kandev kandev ``` Installs the native bundle — no Node.js required. ### NPX ```bash npx kandev@latest ``` Requires npm 7+. Installs the CLI plus a platform-matched runtime bundle in one step. ### NPM (global) ```bash 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: ```bash npx -y kandev@nightly # or npm install -g kandev@nightly ``` `npx` runs a transient Nightly without changing a global package. The global install replaces your installed Kandev until you reinstall `kandev@latest`. Nightlies are best-effort builds scheduled for 12:00 UTC when `main` has changed since the latest stable release. They do not move `latest`, and no Homebrew, Scoop, or Desktop nightly channel is published. A verified Kandev-managed npm/npx user service can switch between Stable and Nightly in **Settings > System > Updates**. Other install types expose only Stable in that page; npm/npx users can still invoke `@nightly` directly with the commands above. The worktrees and sqlite db live in `~/.kandev` by default. Works on macOS, Linux, and Windows (WSL or native). ### From Source ```bash # Clone the repository git clone git@github.com:kdlbs/kandev.git cd kandev # Start in production mode make start ``` **Prerequisites:** Go 1.26.0, Node.js 24, and pnpm 9.15.9 (pinned in `mise.toml`). Docker is optional and needed only for container runtimes. ## High level architecture ```mermaid graph LR UI[Web UI] --> Backend Backend["Backend (Orchestrator)"] Backend --> W1 & W2 & W3 & W4 subgraph W1[Local Process] Agent1[Agent CLI] --- WT1[Worktree] end subgraph W2[Docker Container] Agent2[Agent CLI] --- WT2[Worktree] end subgraph W3[SSH Remote] Agent3[Agent CLI] --- WT3[Worktree] end subgraph W4[Sprites Cloud] Agent4[Agent CLI] --- WT4[Worktree] end ``` See the [Kubernetes guide](docs/public/k8s.md) for executor configuration and lifecycle. The executor uses ordinary Pods and does not require an operator. <details> <summary>Development</summary> ### Project Structure ``` apps/ ├── backend/ # Go backend (orchestrator, lifecycle, agentctl, WS gateway) ├── web/ # Vite/React frontend (SPA, Zustand, real-time subscriptions) ├── cli/ # npm shim for the native Go runtime ├── desktop/ # Tauri desktop shell └── packages/ # Shared UI components & types ``` ### Prerequisites - [mise](https://mise.jdx.dev/) for the pinned toolchain in `mise.toml` (`make bootstrap` installs it when missing) - Go 1.26.0, Node.js 24, pnpm 9.15.9 (installed by `make bootstrap`) - Docker (optional) ### Environment Setup ```bash # Install mise tools, workspace dependencies, and git hooks make bootstrap # Also install Playwright Chromium browser/deps for E2E make bootstrap-e2e ``` ### Running Dev Servers ```bash # Start everything (backend + frontend with auto ports) make dev # Or run separately make dev-backend # Backend on :38429 make dev-web # Frontend on :37429 ``` ### Testing & Linting ```bash make test # Run all tests (backend + web) make lint # Run all linters make typecheck # TypeScript type checking make fmt # Format all code ``` ### Pre-commit Hooks ```bash # Installed and wired by make bootstrap make doctor ``` </details> ## Comparison to Other Tools There are a few similar tools in this space, and new ones appearing everyday. Here's what sets this one apart: - **Server-first architecture** - The core app runs as a server you can access from any device, including your phone. - **Remote runtimes** - Run agents on remote servers via SSH, Docker hosts, and cloud environments, not just your local machine. - **Multi-provider** - Use Claude Code, Codex, Copilot, Gemini, Amp, Auggie, OpenCode, Cursor, Devin, Qwen, Droid, iFlow, Kilocode, Pi, Kimi, Kiro, Qoder, Trae, Oh My Pi, Grok, Hermes, and Antigravity side by side. Not locked to one vendor. - **CLI passthrough and chat** - Interact with agents through structured chat messages or, where supported, drop into raw CLI mode for full agent TUI capabilities. - **Open source and self-hostable** - No vendor lock-in, no telemetry, runs on your infrastructure. ## Contributing Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a PR. See 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. ## Acknowledgments Built with these excellent open-source projects: [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/) ## License [AGPL-3.0](LICENSE) ## Star History <a href="https://www.star-history.com/?repos=kdlbs%2Fkandev&type=date&legend=top-left"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=kdlbs/kandev&type=date&theme=dark&legend=top-left&sealed_token=VcdQXTkas2odX-D8DZINZOcBVuA6ZfkugIzgWgnAi0lqW3gwdqlh_Ei77fi2bdXwc3HnCFz3NQAYtRnoKxspsck-pIQxTdEwEIveR27Y3k8cKBWJxYGOCFqYhHiJGcECnrrMU_NhWcWWTWaz0t5cX-3Fm-1BOouTejaUEy9w78CSuoakpeUJby66XlCB" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=kdlbs/kandev&type=date&legend=top-left&sealed_token=VcdQXTkas2odX-D8DZINZOcBVuA6ZfkugIzgWgnAi0lqW3gwdqlh_Ei77fi2bdXwc3HnCFz3NQAYtRnoKxspsck-pIQxTdEwEIveR27Y3k8cKBWJxYGOCFqYhHiJGcECnrrMU_NhWcWWTWaz0t5cX-3Fm-1BOouTejaUEy9w78CSuoakpeUJby66XlCB" /> <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=kdlbs/kandev&type=date&legend=top-left&sealed_token=VcdQXTkas2odX-D8DZINZOcBVuA6ZfkugIzgWgnAi0lqW3gwdqlh_Ei77fi2bdXwc3HnCFz3NQAYtRnoKxspsck-pIQxTdEwEIveR27Y3k8cKBWJxYGOCFqYhHiJGcECnrrMU_NhWcWWTWaz0t5cX-3Fm-1BOouTejaUEy9w78CSuoakpeUJby66XlCB" /> </picture> </a>

Carregando o README do repositório…

Skills neste repositório

Desenvolvedores de software Outras ocupações de informática Analistas de garantia de qualidade de software e testadores Especialistas em gestão de projetos

6 categorias ocupacionais · 61% classificado

skill

ocupação

descrição

atualizado

pr

sem classificação

Create a PR from a committed and pushed branch after task-defined checks pass. Ready PRs continue to fixup in the primary conversation.