Launch long-running Codex (or Claude Code) coding tasks via tmux on WSL2/Linux, bypassing SIGTERM timeouts. Use this skill INSTEAD OF coding-agent whenever:...
---
name: codex-tmux
description: >
Launch long-running Codex (or Claude Code) coding tasks via tmux on WSL2/Linux, bypassing SIGTERM timeouts.
Use this skill INSTEAD OF coding-agent whenever: (1) the task may take >60s, (2) you need full-auto Codex execution,
(3) you are on WSL2 with a custom OpenAI-compatible proxy (OPENAI_BASE_URL), (4) you want to monitor/steer a
background Codex session mid-run, (5) building or extending the MyClaw project, (6) any multi-file code generation
task. This skill has higher priority than coding-agent for Codex full-auto workflows on this machine.
Triggers: codex tmux, long task, full-auto, MyClaw, background codex, WSL2 coding agent.
---
# Codex via tmux (WSL2 / Custom Proxy)
Preferred pattern for all Codex full-auto tasks on this machine. Avoids SIGTERM, supports mid-run steering.
## Environment (this machine)
```bash
OPENAI_API_KEY="sk-5Ds6eFbTEE1zu5fQ14F4FfB5892b419dB1BfC7292147B9Ef"
OPENAI_BASE_URL="http://152.53.52.170:3003/v1"
```
Always pass both vars. Do NOT rely on shell inheritance — OpenClaw subprocesses don't source `.bashrc`.
## Standard Launch Pattern
```bash
SESSION="codex-<feature>" # e.g. codex-auth, codex-tools
WORKDIR=~/MyClaw # or target repo
tmux new-session -d -s "$SESSION" -c "$WORKDIR" \
"OPENAI_API_KEY='sk-5Ds6e...' OPENAI_BASE_URL='http://152.53.52.170:3003/v1' \
codex --model gpt-5.3-codex --full-auto '$(cat /tmp/task.txt)'"
```
Write long prompts to `/tmp/task.txt` first, then reference via `$(cat /tmp/task.txt)`.
## Monitoring
```bash
# Check if alive
tmux has-session -t "$SESSION" 2>/dev/null && echo running || echo done
# Tail output (last 50 lines)
tmux capture-pane -t "$SESSION" -p | tail -50
# Or via OpenClaw exec:
exec("tmux capture-pane -t codex-auth -p | tail -30")
```
## Mid-run Steering
```bash
tmux send-keys -t "$SESSION" "停一下。先做 API 层,不要改 UI。" Enter
tmux send-keys -t "$SESSION" "类型定义在 src/types.ts,用那个。" Enter
```
## Task JSON Tracking
Write to `/tmp/codex-tasks.json` to track parallel jobs:
```json
{
"id": "feat-tools",
"session": "codex-tools",
"model": "gpt-5.3-codex",
"desc": "实现工具系统 exec/read/write/web_fetch",
"repo": "MyClaw",
"startedAt": 1772433000000,
"status": "running"
}
```
## Completion Check
Poll every 2–3 min via:
```bash
tmux has-session -t "$SESSION" 2>/dev/null || echo "DONE"
git -C "$WORKDIR" log --oneline -3
```
Codex "完成" = tmux session 自动退出 + git commit 存在。
## Cleanup
```bash
tmux kill-session -t "$SESSION" 2>/dev/null
git worktree prune
```
## MyClaw-Specific Notes
- Repo: `~/MyClaw`, GitHub: https://github.com/InuyashaYang/MyClaw
- 模型首选 `gpt-5.3-codex`,轻量测试用 `gpt-4.1-mini`
- 详细已知坑见 → `references/lessons.md`
don't have the plugin yet? install it then click "run inline in claude" again.