DevTeam CLI 为本地编码智能体设计的终端工具

DevTeam CLI是一个为本地编码智能体设计的终端工具，通过统一的终端用户界面（TUI），让用户能够并行管理和协调多个Claude Code、Codex或Gemini智能体进行开发。DevTeam CLI利用Git worktrees启动多任务并行开发，提供内置的差异查看器以审阅智能体提交的代码更改并直接添加反馈，实时高亮显示需要用户介入的智能体，详细展示每个智能体的工作进度（如代码差异行数、功能推送及GitHub PR状态），支持在各自工作树中运行程序以便快速测试。用户可以为不同功能自由选择智能体类型，能极大提升开发效率，还能配置专用GitHub账户让智能体自动创建PR。

• 支持并行启动多个智能体，可选择Claude Code、Codex或Gemini等不同类型的智能体，分别负责不同功能开发，通过git worktrees实现各智能体工作环境隔离，避免代码冲突。

• 内置差异查看器，能直观展示各智能体的代码修改情况，包括新增、删除的代码行数。开发者还能添加评论，这些评论会直接反馈给对应的智能体，方便智能体根据建议调整代码。

• 智能体若在开发过程中需要开发者输入信息，会在UI界面中高亮显示，开发者能快速定位并及时提供反馈，避免智能体因等待输入而停滞。

• 实时展示各智能体的开发进度，包括代码差异行数、功能是否已推送、GitHub PR检查结果及状态等，让开发者对整体开发情况一目了然。

• 允许在每个worktree中运行程序或服务器，开发者能直接在对应环境中测试智能体开发的功能，无需额外切换环境。

DevTeam CLI安装指南

在安装DevTeam CLI前，需确保环境满足两个前提条件：已安装Node.js 18及以上版本，且tmux已安装并配置到系统PATH中。满足条件后，可通过以下两种方式安装：

方式一：全局安装

打开终端，输入以下命令，即可通过npm全局安装DevTeam CLI，安装完成后会自动添加“devteam”命令到系统中：

npm i -g @agent-era/devteam

方式二：通过脚本安装

先克隆该项目仓库，进入仓库目录后，运行提供的安装脚本，具体命令如下：

# 克隆仓库（此处假设已配置git环境）
git clone https://github.com/agent-era/devteam.git
# 进入仓库目录
cd devteam
# 运行安装脚本
./install.sh

简单指令开启协作

DevTeam CLI的使用方式灵活，可根据实际需求选择不同的启动方式：

基础启动

进入存放git项目的顶层目录，直接运行“devteam”命令，工具会默认以当前目录作为项目根目录：

cd ~/projects
devteam

指定项目目录启动

若需指定特定项目目录，有两种方式可选。一种是通过“--dir”参数指定路径，另一种是通过设置PROJECTS_DIR环境变量指定路径，具体命令如下：

# 通过--dir参数指定
devteam --dir /path/to/projects
# 通过环境变量指定
PROJECTS_DIR=/path/to/projects devteam

实用使用建议

为确保开发安全与效率，使用时可参考以下建议：

• 在虚拟机中运行该工具，给智能体在虚拟机沙箱内赋予较广的操作权限，既能满足智能体开发需求，又能避免对本地核心环境造成影响。

• 为智能体配置一个专用的GitHub账号，智能体可直接使用该账号自动创建PR，减少手动操作步骤。

• 在项目的CLAUDE.md或AGENTS.md文件中添加开发规范，例如要求智能体为每个功能添加测试用例，并为每个功能单独创建PR，确保开发流程规范统一。