什么是Coding Sessions
Coding Sessions 是一个专为长时间运行的 AI 编程代理设计的持久化管理工具，通过在稳定的 tmux 会话中运行 Codex CLI、Claude Code 或 Ralph 循环，确保任务在网关重启等意外情况下不会中断。该工具的核心价值在于解决了传统后台进程因系统清理机制而失效的问题，尤其适用于需要持续执行超过5分钟的复杂编码任务。所有会话均绑定到固定的 socket 路径 `~/.tmux/sock`，避免 macOS 对 `/tmp` 目录的周期性清理导致连接丢失。每个会话都配备自动退出码捕获和通知钩子，一旦任务完成即可通过 openclaw 发送即时系统事件提醒用户。此外，建议将关键命令记录在每日笔记中，以便后续监控、恢复或健康检查时快速定位上下文。
核心功能特点
- 使用稳定 socket（~/.tmux/sock）创建持久化 tmux 会话，防止 macOS 清理 /tmp 导致中断
- 内置完成钩子自动捕获退出状态并触发 openclaw 系统事件通知
- 支持 Codex exec、Ralph 单循环及并行多任务等多种 AI 代理模式
- 提供会话列表、输出查看与存活检测等实时监控命令
- 推荐结合 PRD 文件与 git 历史实现任务追踪与断点续做
适用场景
Coding Sessions 最适合处理那些无法在普通终端窗口中可靠运行的长周期 AI 编程任务。例如，当需要基于产品需求文档（PRD）逐步开发一个完整功能模块时，使用 `ralphy –codex –prd PRD.md` 可让 Ralph 自动拆分任务、执行代码生成、提交变更并通过测试验证，形成闭环工作流。若某个自动化任务曾因网络波动或 API 限流失败，则应将其包装进 Ralph 循环中重新尝试，利用其自动重试机制恢复进度。对于多个独立子任务（如同时实现前端组件、后端接口和数据库迁移），可通过 `–parallel` 参数启动并行会话提升效率。而对于仅需修改单个文件的小规模修复或探索性实验，则可直接调用 `codex exec –full-auto` 快速响应。无论哪种场景，务必在每日笔记中登记会话名称与原始命令，便于后续审计与故障排查。