Agent-Manager开源TUI终端管理器:支持Claude Code/Codex/OpenCode本地AI Agent轻量部署

Agent-Manager开源:专为Claude Code、Codex 与 OpenCode 等本地 AI Agent 设计的轻量级 TUI 终端管理器
不用再在十几个终端窗口间狂按 Alt+Tab。Agent-Manager 上线 GitHub,一个面向本地 AI Agent 开发的类 tmux TUI 管理器——支持 Claude Code、Codex、OpenCode 等基于本地 LLM 的 Agent 框架,单二进制运行,零依赖。
cargo install agent-manager,然后执行 am,5 秒内启动:分屏、快捷键控制、实时 CPU/内存监控、结构化日志聚合全都有。
它用 Rust 编写,底层是 crossterm + tui-rs,不依赖 ncurses 或 Web 技术栈。通过 SIGUSR1/SIGUSR2 与子进程通信,不劫持 stdin/stdout/stderr,兼容所有 POSIX-compliant 的 Agent 启动脚本——包括龙虾生态中基于 OpenClaw Runtime 封装的实例。
为什么本地 Agent 开发者需要这个工具?
CLI 调试多 Agent 早就成了体力活:跑一个 Claude Code Agent,通常要开三个终端——一个起 Ollama 或 llama.cpp,一个启 Agent 主进程,一个 tail -f 日志。五个 Agent?标签页卡死、窗口堆叠、输出互相覆盖是常态。
Agent-Manager 把“每个 Agent 对应一个可视区域”变成现实:
- Ctrl+J/K 切换焦点
- Ctrl+S 暂停输出(不终止进程)
- Ctrl+R 重启当前会话
- Ctrl+Q 软终止(发送 SIGTERM,支持优雅退出)
日志不是简单拼接。它自动识别 JSONL 格式事件流(例如 {"event":"step_start","agent_id":"coder-v2","step":"plan"}),按时间戳合并,error/warn 字段高亮显示。实测在 4 核 MacBook Pro 上同时管理 8 个 OpenCode 实例,内存常驻仅 42MB。
技术实现:轻量,但没妥协
Agent-Manager 不改写任何 Agent 逻辑,只做“智能外壳”:
- 用
fork+exec启动子进程,注入一个 <20 行的 bash hook 脚本,捕获 stdout/stderr 并注入唯一session_id - 所有日志通过 Unix socket 直接推给主进程,绕过文件 I/O
- 资源监控模块直接读取
/proc/pid/stat(Linux)或sysctl(macOS),每 500ms 刷新一次 CPU 使用率与 RSS 内存,误差 ±3%
对 streaming 输出友好:自动识别 data: {...} SSE 格式,剥离前缀后结构化解析,让 “正在生成测试用例…” 这类中间反馈实时出现在对应分屏里。
GitHub 仓库提供:
- 预编译二进制(x86_64 / aarch64)
- VS Code Dev Container 配置
- 龙虾 CLI 插件示例:
yitb agent attach --tui
👉 Binance · OKX · Gate.io · HTX · Bitget
实际影响:从盯屏到精准定位
某 AI 基建团队将 Agent-Manager 接入内部 Claude Code 自动化测试流水线:
- 之前:3 人轮值盯 12 个终端,排查超时失败平均耗时 27 分钟
- 之后:单人用
/fail命令一键筛选全部 error 日志,快速定位到某个 Agent 的 context overflow 问题,修复周期压缩至 8 分钟
更关键的是可复现性:
am export --session=prod-20240521导出完整会话快照:含环境变量、启动参数、全量日志、资源曲线- CI 可回放验证,无需重现场景
对龙虾用户,Agent-Manager 已原生支持 OpenClaw v0.4+ 的 agent.yaml Manifest:自动读取 name、description、health_check_endpoint,本地调试体验直逼生产级可观测性。
它解决什么问题?
云厂商推托管 Agent 服务,但真实研发流程里,92% 的 Claude Code / PaperCoder 类项目仍始于本地快速验证。
工具链存在明显断层:模型层有 llama.cpp,推理层有 vLLM,Agent 编排层有 LangGraph——唯独缺一个把它们串起来、看得见、控得住的终端操作面板。
Agent-Manager 不是另一个 Orchestrator。它不替代任何框架,只让每一次 Claude 调用、每一个 Codex step、每一条 OpenCode trace 变得:
- 可触(焦点切换即操作)
- 可停(暂停输出不中断进程)
- 可溯(带时间戳的日志 + 资源曲线 + 快照导出)
TUI 不是复古。当 AI Agent 从 Demo 走向工程化,低延迟、高确定性的交互就是刚需。
立即试用:
git clone https://github.com/agent-manager/agent-manager && cd agent-manager && cargo run --release路线图已公开:v0.5.2 将支持与 OpenClaw Runtime 一键集成。欢迎提交你的 Agent 启动模板到 awesome-agent-manager —— 真正的效率提升,始于一次干净的终端。