P085 dob323/session-kit

信息卡

项目	内容
仓库	dob323/session-kit
语言 / 许可证	Python / MIT
总星标	⭐ 649（截至 2026-08-26）
创建时间	2026-07-30
榜单	近30天新星榜第35名

一句话定位

"关掉的是终端窗口，不是 AI 编码会话"——用一个稳定编号把散落各终端的 Claude Code 与 Codex 会话收进同一菜单，断线、关窗、SSH 掉线会话都继续活着。

走红原因分析

多 Agent 并行工作流在 2026 年已成主流，但原生工具对"我有几个会话、哪个在等我"毫无视图，session-kit 精准补位；工程质量是第二爆点：三周发了 13 个版本、CI 约 2700 个测试、Linux/macOS 双覆盖，按个人热情项目运营却达到商业级完成度；安全叙事罕见地扎实——身份证明模型、fail closed 原则、"选择器永不被信任为证据"，赢得了安全敏感用户的信任；加上无账号无遥测完全本地化，符合当前隐私审美。

核心功能拆解

统一选择器 `kit`：Claude Code 与 Codex 会话同屏，带名称、编号与颜色；
注意力状态五态：question（阻塞提问）、needs you、working、idle、pending，`a` 键只看需要你的会话；
断线存活：基于 shpool 的持久 shell，本地关窗或 SSH 断开会话继续运行；
每会话独立账户：订阅属于会话而非终端，三个 Claude 订阅可并行；
Closed sessions：关闭时留存完整对话记录供事后读取恢复；
委托工作隔离：机器发起的会话获得独立 git worktree 与分支，关闭时按规则交还副本；

7. 完全本地：无托管账号、无分析遥测、无更新信标。

架构与技术栈浅析

底层弃 tmux 选 shpool：tmux 无法告知哪个 pane 在等答案、也不知道 pane 对应哪段对话，shpool 为每个 shell 提供干净会话使身份"可证明"。安全模型核心是 Provider UUID 加精确进程代数构成身份，任何变更操作前即时重验实时身份谱系，证据缺失或冲突一律拒绝且什么都不改。运行时零服务部署，装在工作机即可。

安装与环境要求

依赖 shpool 0.11.0 与 Claude Code/Codex 之一；Linux 需可读 /proc、systemd 用户管理器、Bash 4+、Python 3.10+；macOS 需 14+ 并有活跃桌面登录。官方推荐让 AI 助手从 GitHub Release artifact 安装并校验 sha256/provenance，依次跑 install.sh --check → install → doctor → services enable → doctor。

快速上手示例

kit                     # 打开选择器
sp new claude           # 新建 Claude Code 会话
sp new codex --worktree feat-x   # 在独立 worktree 中启动 Codex
session-kit doctor      # 体检安装状态

选择器内 Enter/数字打开、k 关闭、n 新建、g 跳到下一个需要你的会话。

进阶使用要点

项目别名、provider/账户/模型配置见 docs/projects.md；跨账户携带对话默认关闭，启用自动切换须设 SESSION_KIT_WATCHDOG_MODE=repair 且作者明确警告其风险自负；更新走不可变 release 加 current 原子切换可回滚；隐私默认值中终端日志与外部通知均为关闭。

典型应用场景

一人多 Agent 并行开发时的统一调度台；
远程 SSH 主机上挂长任务，笔记本随时断连不影响进度；
多订阅账户的配额分流管理；
把重复性工作委托给机器会话并用 worktree 隔离风险。

资源导航

README 含安全模型、五原则、按键表与安装双路径完整说明；docs/projects.md 讲项目配置；SECURITY.md 处理漏洞报告；THIRD_PARTY_NOTICES 列出 shpool 补丁涉及的 Apache-2.0 第三方声明。

dob323/session-kit

信息卡