herdr 使用教程

herdr是一款终端原生的AI编程代理多路复用器，像tmux管理终端一样管理你的多个AI编码代理，支持SSH远程访问，关闭笔记本也不会丢失工作状态。 快速开始 访问herdr的GitHub发布页面，下载对应操作系统（macOS/Linux/Windows预览版）的二进制文件，或通过包管理器安装（macOS用brew install herdr，Linux用对应包管理器）。安装完成后在终端输入herdr即可启动。首次运行会引导你配置AI代理后端，支持Claude Code、Cursor等主流AI编程工具，按提示选择并完成认证即可。 核心功能演示 功能一：创建多个代理会话。启动herdr后，按快捷键c创建新会话，为会话命名（如前端重构、后端API、数据库迁移），每个会话独立运行一个AI编程代理。按数字键1-9在不同会话间快速切换，每个会话都有独立的对话上下文和工作目录，互不干扰。 功能二：实时状态监控。herdr主界面顶部显示所有会话的状态标签：blocked（等待输入）、working（正在执行）、done（已完成）。颜色编码让你一眼看清哪些代理需要关注、哪些正在忙碌。按s键可以查看当前会话的详细执行日志，了解代理正在做什么。 功能三：SSH远程访问。在远程服务器上运行herdr serve启动远程模式，然后在本地终端执行ssh -t server herdr attach即可连接。即使关闭笔记本电脑断开SSH连接，服务器上的代理会话仍然继续运行。重新连接后所有状态完整保留，真正实现随时随地接管工作。 实际使用案例 场景一：并行处理多个开发任务。你在开发一个全栈项目，同时让一个代理重构前端组件、另一个代理编写后端API、第三个代理优化数据库查询。通过herdr在三个会话间轮转检查进度，哪个完成了就Review一下，哪个需要补充信息就输入指令，效率远高于逐个串行处理。 场景二：远程服务器上的长时间任务。你在云服务器上让AI代理跑一个大型代码迁移任务，预计需要几个小时。通过herdr管理这个任务，关掉电脑去吃饭，回来后重新连接SSH，代理已经完成了大部分工作，状态和结果都在，无缝衔接继续工作。 常见问题 问：herdr支持哪些AI编程代理？答：目前支持Claude Code、Cursor Agent、Aider等主流终端AI编程工具，通过配置文件可以添加其他支持CLI调用的代理。具体兼容列表见项目文档。 问：多个代理同时运行会冲突吗？答：每个代理会话有独立的工作目录和进程空间，不会冲突。但建议让不同代理操作不同文件或模块，避免同时修改同一文件导致合并冲突。 问：Windows支持怎么样？答：Windows目前是预览版，核心功能可用但可能存在一些终端兼容性问题，推荐在macOS或Linux上获得最佳体验。 小贴士 1. 给每个会话起有意义的名字，比如功能模块或任务类型，比用默认编号更容易管理，长时间使用时尤其重要。 2. 善用herdr的会话持久化特性，对于耗时较长的任务，放心关闭终端去做别的事情，下次打开继续即可。 3. 搭配tmux使用效果更佳，在tmux中运行herdr，既能管理多个代理会话，又能同时保留普通终端窗口处理其他工作。