Agent Session Manager
在一个终端界面中并行组织、监控和恢复多个 AI 编程 CLI 会话。
- Star 数
- ★ 16
- 最近更新
- 1 个月前
- License
- MIT
- 主语言
- Go
- FA 评分
- 64/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 同时使用 Claude Code、Codex 和 Gemini CLI 的开发者,希望从一个 TUI 查看各任务的运行、等待、空闲或停止状态。
- 不适合
- 不想安装 tmux 或 psmux 的用户,核心会话执行依赖终端复用器
- 需要图形界面或移动端推送的用户,应改用 ASMGR Desktop
- 希望终端版与桌面版共享同一会话列表的用户,两者会话存储相互独立
- 源码审查
- 64/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
Agent Session Manager(ASMGR)是一个以 Go 和 Bubble Tea 构建的本地终端界面,通过 tmux(Windows 使用 psmux)管理 AI 编程助手进程。它原生支持 Claude Code、Gemini CLI、Aider、OpenAI Codex、Amazon Q 和 OpenCode,也能运行自定义 CLI 命令。用户可以把会话按项目和分组隔离,在同一目录中并行启动多个实例,并在单个会话内创建多个代理或终端标签页。界面提供带 ANSI 颜色的实时输出预览、活动状态检测、提示发送、会话恢复、跨历史搜索以及 Git 差异查看。配置、项目元数据、会话、分组和备注保存在本地文件系统中;产品边界是用户自己的终端、代码目录和本地多路复用器,而不是托管式云代理服务。
运行 asmgr 后,程序先显示项目选择器,并从 ~/.config/agent-session-manager/ 下的 projects.json、默认 sessions.json 或项目专属 projects/<project>/sessions.json 读取持久化状态。session/ 组件负责会话生命周期、PTY 与 tmux 集成、项目存储、状态检测和各代理的历史发现;ui/ 使用 Bubble Tea、Bubbles 和 Lip Gloss 渲染列表、预览、对话框、帮助、分屏和颜色选择器。用户选择 Claude、Gemini、Aider、Codex、Amazon Q、OpenCode 或自定义命令后,ASMGR 在 tmux/psmux 会话或标签页中启动并管理相应进程,同时抓取输出用于实时预览,并允许向运行中的进程发送提示。它可以发现并恢复 Claude、Gemini、Codex、OpenCode 和 Amazon Q 的既有对话;全局搜索还会读取 Claude、Aider、OpenCode 及 shell 历史。对于 Git 工作目录,差异视图可输出从会话启动时的 HEAD 起算的 Session diff,或全部未提交变更的 Full diff。它还会把会话名称、路径、代理类型、恢复 ID、自动确认设置、颜色、分组和备注写回本地配置。
- 同时使用 Claude Code、Codex 和 Gemini CLI 的开发者,希望从一个 TUI 查看各任务的运行、等待、空闲或停止状态。
- 在同一代码目录中处理多个独立任务的工程师,需要为同一代理创建具名并行会话,同时保留各自的上下文。
- 维护多个代码库的个人开发者,希望以项目、可折叠分组、收藏和备注整理大量长期会话。
- 需要审查代理改动的开发者,可在预览与 Git Session diff 或 Full diff 之间切换,无须先退出管理界面。
- 进行方案探索的 Claude Code 用户,可从同一对话分叉到新标签页或新会话,分别尝试不同实现。
- 经常返回旧任务的终端用户,可搜索代理与 shell 历史,并恢复受支持代理的既有对话。
如何安装或部署这个 Agent?
运行时需要 Linux/macOS 上的 tmux,或 Windows 上兼容 tmux 命令语言的 psmux。还需安装至少一个受支持的 AI CLI;也可以配置自定义 CLI 命令。macOS 或 Linux 可通过 Homebrew 安装:
brew tap izll/tap
brew install asmgrLinux 也可运行快速安装脚本:
curl -fsSL https://raw.githubusercontent.com/izll/agent-session-manager/main/install.sh | bash若需从源码构建,要求 Go 1.24 或更高版本:
git clone https://github.com/izll/agent-session-manager.git
cd agent-session-manager
go build -o asmgr .
cp asmgr ~/.local/bin/Windows 用户可从 Releases 下载 asmgr_<version>_windows_amd64_setup.exe。安装程序按用户安装、把 asmgr 加入 PATH,并可在 winget 可用时协助安装 psmux;安装后需要打开新终端。
如何使用这个 Agent?
首次确保 tmux 或 psmux 以及所选 AI CLI 已在 PATH 中,然后启动:
asmgr在项目选择器中进入现有项目、创建项目,或选择不使用项目。进入会话列表后,按 n 创建会话,使用 Enter 启动并附加,或按 s 仅启动;a 可替换当前实例或创建具名并行实例。按 t 添加代理或普通终端标签页,p 向运行中的会话发送提示,r 浏览并恢复受支持代理的历史对话。按 D 切换差异视图、F 在 Session diff 与 Full diff 之间切换,Ctrl+F 搜索全局历史。附加到会话后可用 Ctrl+q 快速脱离;主界面按 F1 或 ? 查看完整快捷键说明。
这个 Agent 有哪些优点和局限?
- 同一界面原生管理六种具名 AI 编程 CLI 及任意自定义命令,减少多代理工作流对单一供应商的绑定。
- 支持同目录并行实例、多标签页、项目隔离、分组、收藏和持久备注,适合会话数量较多的长期开发工作。
- 实时 ANSI 输出预览、逐标签活动状态、提示发送和会话恢复把观察与控制集中在 TUI 中。
- 内置 Session diff、Full diff、分屏比较和跨代理历史搜索,覆盖代理执行后的检查与追溯环节。
- 提供 Homebrew、Windows 安装器、Linux 脚本、deb、rpm 和源码构建等多种安装路径。
- 核心执行依赖 tmux;Windows 必须使用 psmux,或自行通过
ASMGR_TMUX指向 WSL/Cygwin 下的 tmux。 - 用户仍需单独安装、配置并承担各 AI CLI 的认证、网络访问及服务成本;ASMGR 本身不提供模型。
- 恢复能力并不一致:Aider 和自定义命令不支持会话恢复,Claude 会话分叉也仅适用于 Claude。
- 全局历史搜索只覆盖 Claude、Aider、OpenCode 和 Terminal,且仅搜索 ASMGR 项目目录,未涵盖所有受支持代理。
- 桌面版与终端版分别保存会话,无法把同一会话列表直接共享给两个界面。
这个 Agent 与同类方案有什么区别?
项目说明其灵感来自 Claude Squad。与仅围绕单一代理的会话工具相比,ASMGR 明确支持 Claude Code、Gemini CLI、Aider、OpenAI Codex、Amazon Q、OpenCode 和自定义命令。仓库还提供独立的 ASMGR Desktop 作为图形化替代方案;桌面版使用 Wails 和 Svelte,并增加真实终端、差异查看器、文件浏览器和移动推送通知,但两个版本的会话数据彼此独立。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Agent Session Manager 当前 | 64 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 16 | 1 个月前 | Go | Codex · Claude Code |
| Agent Deck | 74 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 1.2k | 今天 | Go | Codex · Claude Code |
| Agent Manager | 75 · 表现良好 | 命令行工具免费 | ★ 646 | 1 天前 | Go | Codex · Claude Code |
| Agent of Empires | 79 · 表现良好 | 命令行工具免费 | ★ 3.9k | 今天 | Rust | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
代码和 README 表明它管理 tmux/psmux 会话、读取代理历史、可发送提示,并提供更新和 YOLO 模式;更新与模式刷新会访问网络,YOLO 可降低代理审批限制。README 说明了配置与部分数据来源,更新有确认,缺少更完整的权限、敏感历史保护、依赖审计、外部副作用和恢复机制说明,因此未给高分。发布工作流和 MIT 许可证可见,但发布者身份及维护责任没有得到充分说明。
README 和 main.go 对多路复用器前置条件、启动错误及更新错误给出了可理解的说明,go.mod 锁定了直接和间接依赖版本。README 有功能和快捷键描述,但键位说明存在重叠或不一致(例如 Ctrl+F 的历史搜索与 Ctrl+f 的标签跟踪),静态材料也不足以证明依赖持续可用。
文档明确面向使用多种 AI 编码 CLI 的终端开发者,并覆盖 Linux、macOS、Windows、tmux、psmux 及自定义命令。它说明了部分能力边界,例如 Aider 不支持恢复、分叉仅适用于 Claude;自动刷新模式的触发时机也有代码说明。未对所有代理行为和环境差异给出完整限制,因此未满分。
README 按安装、操作、配置和功能组织,包含平台安装步骤、快捷键表、配置样例及若干限制;许可证文件清楚给出 MIT 条款。文档示例显示 v0.7.5,而版本策略、变更日志和明确维护责任在给定材料中不充分,因此相关分数较低。
功能针对多代理终端会话的组织、预览、恢复、搜索和差异查看,文档给出可直接使用的键位与安装命令,能支持实际工作流。其收益较明确,但需额外安装多路复用器和代理 CLI,且自动更新、历史搜索及 YOLO 等功能增加操作和数据管理成本,故成本效益未满分。
README 的安装和配置说明可与 main.go 的启动检查、网络模式刷新和更新确认部分对照;go.mod 与发布工作流也提供有限交叉证据。大量功能声明只有 README 支持,材料未包含相应实现或测试;文档通常区分支持范围与限制,但不足以核验全部行为。
- YOLO 模式可能改变代理的审批或沙箱行为;启用前应确认具体代理的影响。
- 历史搜索会读取本地代理对话历史及 shell 历史;这些数据可能含敏感信息。
- README 提供了 curl 管道安装和内置自更新流程;审阅材料没有展示下载校验或更新回滚细节。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
See [CHANGELOG.md](https://github.com/izll/agent-session-manager/blob/main/CHANGELOG.md) for what changed in this release, described from a user's point of view. Changelog * 198fadb6502194a7f8c45d34155d1188ae10f5e3 docs(changelog): describe the 0.9.2 release * 8c5ec4a2d957bf232bd2f84cacfee0be903d1dc6 feat(codex): start Codex without its background server * 77a21e5cbb6b1370f14fa1cf87ceb914d42d60ec fix(codex): use the bypass flag Codex still has Full Changelog: https://github.com/izll/agent-session-manager/compare/v0.9.1...v0.9.2在 GitHub 查看 ↗ -
发布说明摘录
See [CHANGELOG.md](https://github.com/izll/agent-session-manager/blob/main/CHANGELOG.md) for what changed in this release, described from a user's point of view. Changelog * 80fb0be2c370c2d6b0430e54bedf2082c101d9c9 docs(changelog): describe the 0.9.1 release * 533181b6246d960795662dad6dcd3b63e76a3062 fix(status): show Codex's work instead of its model name * 7829be4b8ae72ce2ca890704db8842adf82228a7 fix(tmux): set window options with -w so a dead pane stays在 GitHub 查看 ↗ -
发布说明摘录
See [CHANGELOG.md](https://github.com/izll/agent-session-manager/blob/main/CHANGELOG.md) for what changed in this release, described from a user's point of view. Changelog * f0140b6eab14d8e37f422cb1e3d42512ff85c51c build: add a Windows installer that offers to install psmux * 624f166d62eea74024acd6e58ee6e98af4083b74 feat: run on Windows, through psmux在 GitHub 查看 ↗
常见问题
ASMGR 是否包含或托管 AI 模型?
能否在 Windows 上使用?
ASMGR_TMUX 指向 WSL 或 Cygwin 中 tmux 的绝对路径。哪些代理能够恢复旧会话?
项目之间的会话是否隔离?
它会修改代码吗?
谢谢反馈,我们会据此改进页面。