Kandev 是一个可自托管的 AI 看板与开发环境（AI Kanban & Development Environment），支持多供应商 Agent 编排、变更审查与创建 PR。它的CLI 直通模式（CLI passthrough）让任何 Agent CLI 都能直接运行在终端里，既保留 Agent 原生的 TUI 体验，又顺带获得看板任务管理、worktree 隔离与集成的代码审查能力——对于"离不开终端手感"的开发者非常友好。

为什么需要 CLI 直通模式

在终端里跑 Agent 的 TUI 界面体验很好，但只靠终端来审查和迭代 Agent 的改动很难规模化：文件散落在终端输出里，改动、分支、PR 都没有统一视图。Kandev 的思路是让 Agent 继续在它自己的终端里跑，由 Kandev 在任务层面提供管理、隔离与审查。

Kandev CLI直通模式下任务视图：Agent原生TUI运行在PTY终端中，右侧同步展示文件树

两种接入方式：ACP 结构化会话 vs CLI 直通

Kandev 支持两种 Agent 接入方式，理解区别能帮你选对模式：

Kandev 不会为直通模式"编造"缺失的结构化能力——原生的 TUI 里有什么，你就得到什么，这正是直通模式的卖点。相关说明见 docs/public/agents-and-profiles.md。

三步开启 CLI 直通模式

第 1 步：检测或安装 Agent CLI。打开Settings > Agents（/settings/agents），Kandev 会扫描其后端所在主机（不是浏览器电脑）。CLI 安装后选择Rescan重新检测。

第 2 步：配置直通 Profile。打开对应 Agent 的 profile，确认模型、模式、权限开关、CLI 标志与环境变量，并启用 CLI 直通设置。如果你的 Agent 不在内置列表中，可以通过Add custom agent把它注册为一个 Terminal（直通）Agent，命令里的{{model}}会被 profile 中的模型标签替换。内置示例：Pi 的直通命令就是全局安装的pi可执行文件。

第 3 步：创建任务并启动。新建任务时选择该直通 profile，任务启动后 Agent 即在 PTY 终端里以原生界面运行——对直通/TUI profile，后端会把"仅准备会话"升级为完整启动，因为原生 PTY 必须先存在。首次运行向导（Onboarding）里也提供了已检测 profile 的可选 CLI 直通开关。

直通模式下你依然得到的能力

• 任务管理：会话仍属于看板任务，可参与 workflow 步骤流转、子任务、依赖关系与并行执行；
• 工作区隔离：配合 Worktree 执行器，并行的 Agent 各自工作在独立的 git worktree 中，互不冲突；
• 变更审查：Changes 面板集中展示改动，可直接 Push 或创建 Pull Request，审查流程不受终端模式影响；
• 会话恢复：恢复会话时，Kandev 会把 profile 的模型标识转换为--model provider/model#variant，并用--session <id>或--continue让 CLI 续接上下文；
• MCP 直通注入：直通 Agent 也能接入 Kandev 的 MCP 端点，保留原生 CLI 接口的同时获得任务协调工具（不同 CLI 的注入方式不同，见 docs/public/agents-and-profiles.md）。

Kandev 变更审查：diff行级审查与PR创建入口

📱 手机上直接使用原生 TUI

在手机上打开一个 CLI 直通任务，其终端下方会出现一排虚拟按键：Ctrl、Shift、^C、^D、Esc、Tab、方向键等。按键直接发给可见的 Agent 终端，不会生成聊天消息；Ctrl点一次修改下一次输入、点两次常驻。这意味着在移动端你也能以原生键位操作 Agent 的 TUI 界面，详见 docs/public/developer-tools.md。

⚠️ 使用限制与安全提醒

• 直通 profile不提供Kandev 的结构化聊天消息与工具调用展示（docs/public/sessions-and-review.md），任务快照分享功能也不适用于直通会话；
• 直通聊天中输入的#保留为字面文本，不会触发任务/工作项搜索；
• Automation 的选择器不包含直通 Agent profile，自动化场景请优先使用 ACP Agent；
• 安全边界要心里有数：Auto Approve、跳过权限的标志以及无限制的直通会移除 Agent CLI 内的人工闸门，这属于安全决策；Worktree 只是 Git 层面的隔离，不限制进程、文件系统或凭据访问。完整边界建议阅读 docs/public/use-kandev.md 的安全章节。

相关资源

• 官方文档入口：docs/public/use-kandev.md
• Agent 与 Profile 配置（含直通设置）：docs/public/agents-and-profiles.md
• 添加新 Agent CLI 的完整指南：docs/public/add-agent-cli.md
• 会话与审查（直通会话的恢复与限制）：docs/public/sessions-and-review.md
• 功能总览：docs/features.md（"Bring-your-own TUI agents" 与 "Passthrough MCP" 小节）

本地获取 Kandev 源码：

git clone https://gitcode.com/gh_mirrors/ka/kandev

一句话总结：喜欢终端手感的选 CLI 直通，想要结构化交互的选 ACP，两者都能享受 Kandev 的任务看板、worktree 隔离与统一审查流程——按需切换，不必二选一。