Agent Session Manager

在一个终端界面中并行组织、监控和恢复多个 AI 编程 CLI 会话。

Star 数
★ 16
最近更新
1 个月前
License
MIT
主语言
Go

30 秒速览

运行形态
命令行工具
可在哪里用
通用 · 跨平台Codex · Claude Code
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
Linux/macOS 上的 tmux 或 Windows 上的 psmux至少一个受支持的 AI CLI 工具或自定义 CLI 命令Shell / 命令行网络访问本地文件系统
典型场景
同时使用 Claude Code、Codex 和 Gemini CLI 的开发者,希望从一个 TUI 查看各任务的运行、等待、空闲或停止状态。
不适合
  • 不想安装 tmux 或 psmux 的用户,核心会话执行依赖终端复用器
  • 需要图形界面或移动端推送的用户,应改用 ASMGR Desktop
  • 希望终端版与桌面版共享同一会话列表的用户,两者会话存储相互独立

这个 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、自动确认设置、颜色、分组和备注写回本地配置。

  1. 同时使用 Claude Code、Codex 和 Gemini CLI 的开发者,希望从一个 TUI 查看各任务的运行、等待、空闲或停止状态。
  2. 在同一代码目录中处理多个独立任务的工程师,需要为同一代理创建具名并行会话,同时保留各自的上下文。
  3. 维护多个代码库的个人开发者,希望以项目、可折叠分组、收藏和备注整理大量长期会话。
  4. 需要审查代理改动的开发者,可在预览与 Git Session diff 或 Full diff 之间切换,无须先退出管理界面。
  5. 进行方案探索的 Claude Code 用户,可从同一对话分叉到新标签页或新会话,分别尝试不同实现。
  6. 经常返回旧任务的终端用户,可搜索代理与 shell 历史,并恢复受支持代理的既有对话。

如何安装或部署这个 Agent?

运行时需要 Linux/macOS 上的 tmux,或 Windows 上兼容 tmux 命令语言的 psmux。还需安装至少一个受支持的 AI CLI;也可以配置自定义 CLI 命令。macOS 或 Linux 可通过 Homebrew 安装:

brew tap izll/tap
brew install asmgr

Linux 也可运行快速安装脚本:

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?

FollowAgents 源码审查 · FARS-2.1
存在缺口
64/ 100 五分制 3.2 / 5
信任安全 11/29
可靠稳定 8/14
适用触发 15/18
规范维护 14/18
有效结果 12/13
证据核验 4/8
查看各维度的扣分理由
信任安全11 / 29 · 1.9/5

代码和 README 表明它管理 tmux/psmux 会话、读取代理历史、可发送提示,并提供更新和 YOLO 模式;更新与模式刷新会访问网络,YOLO 可降低代理审批限制。README 说明了配置与部分数据来源,更新有确认,缺少更完整的权限、敏感历史保护、依赖审计、外部副作用和恢复机制说明,因此未给高分。发布工作流和 MIT 许可证可见,但发布者身份及维护责任没有得到充分说明。

可靠稳定8 / 14 · 2.9/5

README 和 main.go 对多路复用器前置条件、启动错误及更新错误给出了可理解的说明,go.mod 锁定了直接和间接依赖版本。README 有功能和快捷键描述,但键位说明存在重叠或不一致(例如 Ctrl+F 的历史搜索与 Ctrl+f 的标签跟踪),静态材料也不足以证明依赖持续可用。

适用触发15 / 18 · 4.2/5

文档明确面向使用多种 AI 编码 CLI 的终端开发者,并覆盖 Linux、macOS、Windows、tmux、psmux 及自定义命令。它说明了部分能力边界,例如 Aider 不支持恢复、分叉仅适用于 Claude;自动刷新模式的触发时机也有代码说明。未对所有代理行为和环境差异给出完整限制,因此未满分。

规范维护14 / 18 · 3.9/5

README 按安装、操作、配置和功能组织,包含平台安装步骤、快捷键表、配置样例及若干限制;许可证文件清楚给出 MIT 条款。文档示例显示 v0.7.5,而版本策略、变更日志和明确维护责任在给定材料中不充分,因此相关分数较低。

有效结果12 / 13 · 4.6/5

功能针对多代理终端会话的组织、预览、恢复、搜索和差异查看,文档给出可直接使用的键位与安装命令,能支持实际工作流。其收益较明确,但需额外安装多路复用器和代理 CLI,且自动更新、历史搜索及 YOLO 等功能增加操作和数据管理成本,故成本效益未满分。

证据核验4 / 8 · 2.5/5

README 的安装和配置说明可与 main.go 的启动检查、网络模式刷新和更新确认部分对照;go.mod 与发布工作流也提供有限交叉证据。大量功能声明只有 README 支持,材料未包含相应实现或测试;文档通常区分支持范围与限制,但不足以核验全部行为。

风险与缓解建议
  • YOLO 模式可能改变代理的审批或沙箱行为;启用前应确认具体代理的影响。
  • 历史搜索会读取本地代理对话历史及 shell 历史;这些数据可能含敏感信息。
  • README 提供了 curl 管道安装和内置自更新流程;审阅材料没有展示下载校验或更新回滚细节。
证据充分度:低 评估于 2026年11月8日 审查版本 e8a3be8edfcd
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/agent-session-manager.svg?lang=zh)](https://followagents.com/zh/agents/agent-session-manager)
<a href="https://followagents.com/zh/agents/agent-session-manager"><img src="https://followagents.com/badge/agent-session-manager.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v0.9.2
    发布说明摘录
    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 查看 ↗
  2. v0.9.1
    发布说明摘录
    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 查看 ↗
  3. v0.9.0
    发布说明摘录
    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 模型?
不包含。它管理已经安装的 AI CLI 或自定义命令;相应服务的账户、认证、费用和网络条件仍由用户自行处理。
能否在 Windows 上使用?
可以。Windows 安装器使用原生 psmux 作为多路复用器,不要求 WSL 或 MSYS2;也可通过 ASMGR_TMUX 指向 WSL 或 Cygwin 中 tmux 的绝对路径。
哪些代理能够恢复旧会话?
Claude、Gemini、Codex、OpenCode 和 Amazon Q 支持恢复。Aider 与自定义命令不支持这一功能。
项目之间的会话是否隔离?
是。每个项目拥有独立的会话列表和分组,并有单实例锁;同一项目一次只能由一个 ASMGR 实例打开。
它会修改代码吗?
代码修改由所启动的 AI CLI 或自定义命令完成。ASMGR 负责进程、终端、输入、预览和持久化管理,并可显示会话期间或整个工作区的 Git 未提交差异。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。