把本地正在运行的 Codex / Claude Code 会话带到飞书，离开电脑后继续聊，回来仍是同一个任务。
你在 Codex Desktop、Codex CLI 或 Claude Code 中开始一个任务后，项目会自动创建专属飞书群。之后可以在电脑和飞书之间来回切换，不会新开会话，也不会丢失原来的上下文。
Codex / Claude Code 开始任务
↓
自动创建专属飞书群
↓
本地消息与最终回复同步到群里
↓
在飞书回复，继续同一个本地会话
- 真正续接原会话：飞书回复会恢复已有 rollout / session，不是把历史复制给一个新 Agent。
- 一个任务一个群：不同项目和任务互不串线，群名会跟随真实任务标题更新。
- 电脑与手机随时切换：Codex Desktop、CLI、Claude Code 和飞书可以轮流推进同一任务。
- 消息不会因临时故障消失：本地队列会持久保存消息，并在网络或服务恢复后重试。
- 凭据留在本机：复用现有 cc-connect 配置，不额外复制飞书密钥。
| 你的工作方式 | 是否适合 |
|---|---|
| 先在电脑上启动 Agent，之后想用手机继续 | 适合 |
| 希望每个本地任务拥有独立飞书群 | 适合 |
| Codex 和 Claude Code 共用一个飞书 Bot | 适合 |
| 只想从飞书发起一个全新任务 | 直接使用 cc-connect 更简单 |
| 需要 Slack、Telegram 或 Windows 自动安装 | 暂不支持 |
本项目不是另一个聊天机器人。飞书连接、消息收发和 Agent 进程仍由 cc-connect 负责；本项目补上的是“发现本地会话、自动建群、绑定原会话、可靠同步”这一层。
当前版本是 Experimental Alpha，自动安装仅支持 macOS。完整运行需要：
- Python 3.11+
- 已安装并可正常使用的 Codex 或 Claude Code
- 一个配置好的飞书应用
- 项目锁定版本的 patched cc-connect
这不是单独执行一次 pip install 就能工作的工具。推荐让 Codex 或 Claude Code 按仓库中的 Agent 指南完成环境检查和安装：
请安装这个仓库。先阅读 AGENTS.md 和 docs/DEPLOYMENT.md，检查现有环境与服务，
备份相关配置，完成 patched cc-connect 构建、Hook 和 worker 安装，
最后运行 doctor 与 Codex / Claude Code 双向验收。不要覆盖来源不明的现有服务。
如果你准备手动安装，核心流程是：
# 构建项目锁定并测试过的 cc-connect
./scripts/build-cc-connect.sh
# 配置 cc-connect 与 Codex 后，安装 worker 和 Hooks
./scripts/install.sh
# 检查配置、权限、Socket 和运行版本
~/.local/share/agent-chat-session-sync/venv/bin/agent-chat-session-sync doctor配置、部署旧服务和真实双向验收都有安全边界，执行前请阅读完整部署指南。
当前版本 v0.5.0-alpha.1 已支持：
- Codex Desktop / CLI 与飞书双向续接
- Claude Code 与飞书双向续接
- 本地会话自动建群、改名、失效后重建
- Codex 与 Claude Code 共用一个 Bot 时的精确路由
- macOS LaunchAgent 常驻运行
- SQLite 消息持久化、重试、去重和重启恢复
- Codex 原生 permission profile 与 App Server 生命周期
目前的主要限制：自动安装只覆盖 macOS；必须维护项目锁定的 cc-connect patch；产品仍处于 Alpha 阶段，不建议直接用于无法容忍中断的关键工作流。
MIT License