sesh 是面向编码智能体的多机器线程管理器，每台机器运行一个 Go 二进制加守护进程。智能体身份由窗格标记而非 tmux 会话确定，记录在运行时丢失后仍可保留。
用途与能力：列出、查找、进入、恢复、创建、标记、归档、重命名、重设父级、捕获、发送、委派或检查跨机器的编码智能体线程；支持 --json 供脚本使用，并提供 TUI（命令面板、过滤、视图切换、归档撤销等）。
使用方式：先验证身份，如 TID=$(sesh whoami) || exit 1；守护进程启动的无头或定时任务用 TID=$("$SESH_BIN" whoami) || exit 1。常用命令包括 sesh thread list --all-machines --json、sesh info <id> --json、sesh thread capture --id <id> --lines 80、sesh tail <id> -n 50、sesh tui --all-machines、sesh thread new、sesh thread resume、sesh thread send、sesh thread send-headless、sesh thread command、sesh subscribe、sesh ticket 系列、sesh doctor、sesh mesh。建议用 sesh help-tree 和 sesh <group> <verb> --help 查询用法。
限制与注意：stop 与 delete 需显式非空 --id；delete 会丢弃记录、提升子线程，除非 --force 否则拒绝活动运行时。父级关系需同属主机器，独立工作须用 --no-parent。--machine 走 SSH 或对等 HTTP 路由，HTTP 需本地守护进程。发送为字面 RPC 转向，不保证 ACK 后完成，命令可按请求 UUID 恢复。Claude/Codex/shell 粘贴有 60 秒默认输入守卫，延迟队列在守护进程重启后丢失。不要手动重启受监督的生产守护进程，应使用 supervisorctl restart sesh-daemon。测试须隔离 SESH_HOME、SESH_TMUX_SOCKET、SESH_MASTER_SOCKET、SESH_CODEX_HOME 等环境变量。具体配置、调度、集成等细节请查阅随附参考文档。