Session Kit – Claude Code 与 Codex 会话的终端仪表板

它是什么 – Session Kit 是一个小型的本地命令行工具，可让您查看、整理并在多个 Claude Code 或 Codex AI 编码会话之间切换。它可在 Linux (systemd) 和 macOS 14+ 上运行，且在终端或 SSH 断开后仍能继续运行。

为何开发此工具 – 作者经常同时运行多个 AI 辅助编码会话。让每个会话保持运行很容易，但要记住哪个会话正在等待输入、哪个仍在工作中，或是哪个已经完成却很困难。Session Kit 提供了一个单一的彩色列表，其中每个会话都有一个固定的编号，您可以输入该编号以返回该会话。

主要功能

• 统一选择器 – 一个屏幕显示所有 Claude Code 和 Codex 会话，并包含编号、名称、提供商、账户、模型、状态和最后活动等列。
• 状态提示 – 会话会被标记为 question、needs you、working、idle 或 pending，让您能轻松找出需要注意的会话。
• 基于编号的跳转 – 按下会话的编号（或按 Enter 选择第一个），工具就会将您附加到该实时会话。
• 承受断线 – 即使您关闭终端或失去 SSH 连接，会话仍会在主机上继续运行。
• 各会话独立账户 – 每个会话可以使用不同的提供商账户/订阅；账户是会话的属性，而非终端的属性。
• 已关闭会话的恢复 – 当您关闭会话时，完整的对话内容会被保存并可在稍后重新打开。
• 委派工作隔离 – 机器端发起的会话会在专用分支上获得自己的 Git 工作树，防止两个工作者编辑相同的文件。
• 安全模型 – UI（选择器）绝不会被视为实时会话的证明。在进行任何变更之前，Session Kit 会重新验证确切的提供商进程 UUID 和世代；如果验证失败，则会拒绝该操作。
• 无遥测 – 所有数据都保留在主机上；没有远程服务、分析或更新探标。

工作原理（高层概念）

1. 您在运行 AI 工作的机器（具备 systemd 的 Linux 或 macOS 14+）上安装 Session Kit。它依赖于 shpool 会话管理器。
2. 运行 kit 会启动选择器 UI。
3. 选择会话（通过编号或 Enter）会重新附加到底层由 shpool 管理且正在运行 Claude Code 或 Codex 的 shell。
4. 当您关闭终端时，shpool 进程会让 AI 会话保持运行；稍后重新连接时会显示相同的会话编号。
5. 所有操作（打开、关闭、移动）都受到短期证明的保护，确保实时的提供商进程与存储的身份相符。

安装 – README 提供了两种方式：

• AI 助手快捷方式 – 提供给 AI 一块命令，以下载最新发布的资产、验证 SHA-256 校验和、运行 ./install.sh --check（只读的预检），然后运行 ./install.sh，接着运行 session-kit doctor 和 session-kit services enable。
• 手动脚本 – 一段简短的 Python 代码会查询 GitHub 发布 API，下载 tarball 和校验和文件、验证它们、解压并运行安装脚本。

典型工作流程

# start the picker
kit

# open a new session (defaults to Claude Code)
sp new claude

# open a Codex session
sp new codex

# see which sessions need a reply
kit   # then press 'a'

# close a session by number
k 3   # from the picker

它不做什么

• 它不是终端多路复用器（非 tmux 的替代品）。
• 它不跟踪 Token 成本，也不提供代码变更的 diff。
• 它不是安全沙箱；它只保护您避免对错误的会话执行操作。

文档与帮助 – 代码库包含一个 docs/ 文件夹，其中提供了针对性的指南：

• install.md – 所有安装路径与 shpool 详细信息。
• usage.md – 如 sp new、sp close、sp account enroll 等命令。
• configuration.md – 颜色、选择器行为、看门狗设置。
• picker-navigation.md – 按键绑定与鼠标操作。
• security-and-data.md – 隐私模型与可选的历史记录存储。

成熟度 – 公开测试版 v0.4.3。核心选择器、身份验证以及 Claude Code/Codex 集成已稳定；项目更新迅速（三周内发布了 13 个版本）。没有正式的支持，但作者会回应问题并推送安全修复。

---

Session Kit 是一个真正的开源实用工具，用于管理多个 AI 编码会话，专为大量使用 Claude Code 或 Codex 且需要可靠方式来跟踪它们的开发者而设计。