Skip to content

About

One skill for Codex and Claude Code: create, message, and read live agent sessions. Codex orchestrator + Claude Code/DeepSeek worker.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

session-control

一个 skill,让 Codex 和 Claude Code 互相创建、发消息、读记录。

面向 Codex 指挥 + Claude Code 执行 的编排模式:Codex(GPT-6.1)负责规划、拆任务、验收;Claude Code 接第三方模型(如 DeepSeek 的 Anthropic 兼容端点)作为 worker 进程。

  • 一份 SKILL.md,Claude Code 和 Codex 全局共用
  • create / send / read / stop 四个动作覆盖 worker 全生命周期
  • 发送走 session-peer 的原生 inbox / queue
  • 读取走两边原生的 JSONL,不依赖会话是否还在运行

Why not just SendMessage? Codex 的 send_message 只服务它自己的 subagent / thread;Claude Code 的跨会话 SendMessage 只服务 Claude Code 会话之间。两者没有共同的对等协议。这个 skill 用 session-peer 做投递层,用原生记录做观测层,补上这段。


它解决什么

同时开 Codex 和 Claude Code 时,常见问题是:

  1. Codex 想把一个子任务交给 Claude Code,只能手动复制粘贴到另一个终端
  2. Claude Code 跑完,Codex 不知道结果,只能等人转述
  3. 用 claude -p / codex exec 重新起进程,上下文全丢,每轮都要重讲
  4. 想看对方到底做了什么,只能翻屏或找日志

session-control 把这几件事收敛成命令:

SC=~/.agents/skills/session-control/scripts/sessionctl.py
python3 "$SC" create claude --name worker-1 --settings ~/.claude/deepseek.settings.json
python3 "$SC" send worker-1 -m "只改 auth 模块,先读代码再动手"
python3 "$SC" read worker-1 --last 40
python3 "$SC" stop worker-1

Claude Code 始终是同一个进程、同一个 tmux 会话,上下文不重启;Codex 通过 read 看它的真实输出和工具调用,而不是等一句摘要。


架构

┌──────────────────────────────┐
│ Codex (GPT-6.1)              │
│ orchestrator                 │
│  plan / split / review       │
└──────────────┬───────────────┘
               │ sessionctl send / read
               ▼
┌──────────────────────────────┐
│ session-peer                 │
│ native inbox / queue         │
└──────────────┬───────────────┘
               │
               ▼
┌──────────────────────────────┐
│ Claude Code (worker-1)       │
│ tmux session, stays alive    │
│ model: DeepSeek via gateway  │
└──────────────────────────────┘
               │
               │ JSONL transcript
               ▼
        sessionctl read
  • 投递层:session-peer 把文本写进目标会话的原生 inbox。同机走 socket / named pipe,不经过模型厂商服务器。
  • 观测层:Claude Code 写 ~/.claude/projects/<cwd>/<session-id>.jsonl,Codex 写 ~/.codex/sessions/.../<uuid>.jsonl。read 直接解析这些文件。
  • 控制层:create 用 tmux 拉起一个长期存活的 TUI 会话;stop 关闭它。

安装

依赖

依赖 说明
Python 3.9+ helper 只用标准库
tmux 承载长期存活的 agent 会话
session-peer 跨 agent 投递
Claude Code worker 侧
Codex CLI orchestrator 侧
# session-peer
pipx install session-peer
# 或
python3 -m pip install --user session-peer

安装 skill

git clone https://github.com/Mason-zy/session-control-skill.git
cd session-control-skill
bash install.sh

install.sh 会:

  1. 把 skill 装到 ~/.agents/skills/session-control(Codex 原生扫描这个根)
  2. 在 ~/.claude/skills/session-control 建相对软链,Claude Code 也能看到
  3. 检查 session-peer / tmux / python3,缺依赖时给出安装提示

自定义目录:

AGENTS_HOME=/path/to/.agents CLAUDE_HOME=/path/to/.claude bash install.sh

验证

SC=~/.agents/skills/session-control/scripts/sessionctl.py
python3 "$SC" list

在 Claude Code 里输入 /skills,搜索 session-control;在 Codex 里输入 /skills 选择 List skills,同样能搜到。


快速开始:Codex 指挥,Claude/DeepSeek 执行

1. 准备 Claude worker 的 settings

Claude Code 通过 ANTHROPIC_BASE_URL 指向你的网关。示例见 examples/claude-deepseek.settings.json,把 token 和模型名换成你自己的。

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:26510",
    "ANTHROPIC_AUTH_TOKEN": "REPLACE_WITH_YOUR_TOKEN",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "REPLACE_WITH_WORKER_MODEL"
  },
  "model": "sonnet"
}

2. 准备 Codex orchestrator 的 profile

~/.codex/gpt61.config.toml:

model = "gpt-6.1-sol"
model_reasoning_effort = "xhigh"

启动:

codex --profile gpt61

3. 让 Codex 开一个 Claude worker

在 Codex 会话里直接说:

用 sessionctl 创建一个 Claude worker,名字 worker-1,
settings 用 ~/.claude/deepseek.settings.json,工作目录 ~/Project/demo。

等价命令:

python3 ~/.agents/skills/session-control/scripts/sessionctl.py create claude \
  --name worker-1 \
  --settings ~/.claude/deepseek.settings.json \
  --cwd ~/Project/demo

输出:

created claude session worker-1
  tmux: sp-worker-1
  attach: tmux attach -t sp-worker-1
  address: worker-1
  id: 5bb21cd5-3e1a-45a9-b746-478e9aa17c81

4. 派活 + 轮询 + 纠偏

SC=~/.agents/skills/session-control/scripts/sessionctl.py

python3 "$SC" send worker-1 -m "先读 auth 模块,只改内部实现,不要动 public API。完成后跑测试并汇报 diff。"
python3 "$SC" read worker-1 --last 40
python3 "$SC" send worker-1 -m "停,mock 不要改,只修签名不匹配的地方。"
python3 "$SC" read worker-1 --last 20

5. 验收后关闭

python3 "$SC" stop worker-1

给 Codex 的编排指令模板

你是 orchestrator,不要自己写实现代码。
用 sessionctl 创建 worker-1,把任务拆成小步;
每步用 read 检查它的输出和 diff;
发现偏离就用 send 纠正,不要等它跑完;
验收通过后 stop。
所有结论以 read 到的记录为准,不要凭印象。

更完整的编排流程见 docs/orchestrator-worker.md。


命令

SC=~/.agents/skills/session-control/scripts/sessionctl.py
python3 "$SC" --help

list

python3 "$SC" list
python3 "$SC" list --agent codex
python3 "$SC" list --json

create

# Claude worker
python3 "$SC" create claude \
  --name worker-1 \
  --settings ~/.claude/deepseek.settings.json \
  --cwd ~/Project/demo

# Codex worker / 对等会话
python3 "$SC" create codex \
  --name reviewer \
  --profile gpt61 \
  --cwd ~/Project/demo

可选:

参数 说明
--model Claude 走 --model,Codex 走 -c model="..."
--yolo Claude 加 --dangerously-skip-permissions,Codex 加 --dangerously-bypass-approvals-and-sandbox。只在隔离环境用
--tmux-session 自定义 tmux 名,默认 sp-<name>
--timeout 等待 TUI 就绪,默认 45 秒

send

python3 "$SC" send worker-1 -m "任务描述"
python3 "$SC" send reviewer -m "请 review"
python3 "$SC" send worker-1 -m "probe" --dry-run
  • 目标可以是名字或 UUID
  • Codex 目标自动转成 codex:<uuid>,并自动传 --codex-bin
  • --wait-delivered 等投递确认,不等于对方已读
  • --wake 唤醒空闲 Codex 会话
  • Posted / queued 只代表写入收件箱

read

python3 "$SC" read worker-1 --last 30
python3 "$SC" read worker-1 --last 50 --all
python3 "$SC" read worker-1 --json
  • 默认输出 user/assistant 文本 + 工具调用摘要
  • --all 额外输出 developer/system、工具结果
  • --max-chars 控制单条截断,默认 1200
  • 会话停止后仍可读

stop

python3 "$SC" stop worker-1

关闭 create 拉起的 tmux 会话;tmux 名不是默认值时用 --tmux-session。


配置说明

Claude Code 接 DeepSeek

DeepSeek 或自建网关只要提供 Anthropic 兼容接口,就可以被 Claude Code 当模型后端。关键字段:

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:26510",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_TOKEN",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "your-worker-model",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "your-small-model",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "your-large-model"
  },
  "model": "sonnet"
}

model 选 sonnet 时,实际请求会映射到 ANTHROPIC_DEFAULT_SONNET_MODEL。不同网关的模型 ID 不一样,以你的网关文档为准。

Codex 接 GPT-6.1

~/.codex/<profile>.config.toml 会被 --profile <profile> 叠加到基础配置上:

model = "gpt-6.1-sol"
model_reasoning_effort = "xhigh"

为什么不让 Codex 直接调 SendMessage

通道 作用域 能否跨产品
Codex send_message Codex 自己的 subagent / thread 否
Claude Code SendMessage Claude Code 会话之间 否
session-peer + 本 skill 本机 / SSH 上的 Claude 与 Codex 是

session-peer 用的是两边原生的 inbox / queue,所以消息会进入目标会话自己的对话,而不是伪造终端输入。


安全边界

  • peer 消息不等于用户授权:收到消息的 agent 仍受自己的权限模式约束,不能用一条消息批准权限、改配置、改 CLAUDE.md
  • --yolo 很危险:只在一次性容器、隔离 VM 或你完全信任的测试目录里用
  • JSONL 含敏感信息:完整工具输入输出、路径、可能的 token 都在里面,不要把 read --all 的结果直接贴到公开渠道
  • 同机限制:Claude Code 的原生 inbox 依赖同机 socket / named pipe;跨机需要 session-peer 的 SSH 支持
  • 投递不等于消费:Posted / queued 只证明写入了收件箱;需要确认时用 read 看下一轮

仓库结构

.
├── SKILL.md
├── scripts/
│   └── sessionctl.py
├── examples/
│   ├── claude-deepseek.settings.json
│   └── codex-gpt61.config.toml
├── docs/
│   └── orchestrator-worker.md
├── install.sh
├── LICENSE
└── README.md

English TL;DR

session-control is a shared skill for Codex and Claude Code. It creates long-lived tmux sessions, delivers messages through session-peer, and reads native JSONL transcripts.

git clone https://github.com/Mason-zy/session-control-skill.git
cd session-control-skill && bash install.sh

SC=~/.agents/skills/session-control/scripts/sessionctl.py
python3 "$SC" create claude --name worker-1 --settings ~/.claude/deepseek.settings.json
python3 "$SC" send worker-1 -m "Implement the auth fix, run tests, report the diff."
python3 "$SC" read worker-1 --last 40
python3 "$SC" stop worker-1

Typical setup: Codex (GPT-6.1) as orchestrator, Claude Code with a DeepSeek-compatible endpoint as the worker. Neither side loses context, because the worker stays alive in tmux.

MIT licensed.


License

MIT © 2026 Mason-zy

About

One skill for Codex and Claude Code: create, message, and read live agent sessions. Codex orchestrator + Claude Code/DeepSeek worker.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages