菜单
Starts a new interactive local OpenAI Codex CLI session (codex TUI) in the project directory. Use when the user wants a new Codex session, codex CLI, terminal Codex, or local Codex agent (not cloud).
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Recursive epic automation — one agent session per slice, chained via ralph-chain-next.sh. BOOTSTRAP: config + chain + STOP — NEVER product code. WORKER: one child issue per session, then chain. "Implement epic with Ralph" means bootstrap and chain, not ship the epic in the bootstrap chat. One slice per worker session only; do not batch child issues in one session.
Starts a new Cursor Cloud Agent session via the Cloud Agents API and returns the session URL. Use when the user wants a Cursor cloud session, cloud agent, remote Cursor worker, AFK Cursor run, or mentions CURSOR_API_KEY and a new cloud VM.
Starts a new interactive local Claude Code CLI session in the project directory. Use when the user wants a new Claude Code session, claude CLI, terminal Claude, or local Claude agent (not cloud).
Starts a new interactive local Cursor Agent CLI session (agent command) in the project directory. Use when the user wants a new local Cursor session, Cursor CLI agent, terminal agent, or to run agent on this machine (not cloud).
Starts a new Oz (Warp) cloud agent run via the Oz API and returns the session link. Use when the user wants an Oz cloud session, Warp cloud agent, remote-oz worker, or mentions WARP_API_KEY and OZ_ENVIRONMENT_ID.
Run the full Playwright E2E suite and publish the HTML report with all test screenshots to GitHub Pages. Use when the user asks to run E2E tests and publish/share/view screenshots on mobile, update GitHub Pages with E2E results, or run the E2E suite from Cursor Cloud.
| name | start-local-codex-session |
| description | Starts a new interactive local OpenAI Codex CLI session (codex TUI) in the project directory. Use when the user wants a new Codex session, codex CLI, terminal Codex, or local Codex agent (not cloud). |
Launch the interactive Codex CLI TUI with codex. Full-screen terminal UI for conversational coding in the repo.
Not the same as:
codex exec — non-interactive run for scripts/CI (Ralph local-codex worker)codex cloud subcommand (separate from this local TUI)| Requirement | Notes |
|---|---|
codex on PATH | Codex CLI |
| Auth | codex login on first use |
| Project directory | Prefer repo root; or codex --cd /path/to/repo |
cd "$(git rev-parse --show-toplevel)"
codex
With an initial prompt:
codex "Map the API routes and suggest test gaps"
Low-friction defaults for local work (from Codex docs):
codex --sandbox workspace-write --ask-for-approval on-request
codex exec (Ralph) not a new TUI session.--cd — Set working root to the git repo.codex or codex "initial prompt"./new or /clear (see slash commands).tmux wrapper below if the session should outlive SSH.| Goal | Command |
|---|---|
| New interactive session | codex |
| Resume picker | codex resume |
| Most recent in cwd | codex resume --last |
| Resume by id + prompt | codex resume <ID> "continue …" |
| Fork conversation | codex fork (see codex fork --help) |
Exit: Ctrl+C or /exit inside the TUI.
SESSION_NAME="codex-$(basename "$(git rev-parse --show-toplevel)")"
tmux new-session -d -s "$SESSION_NAME" -c "$(git rev-parse --show-toplevel)" -- codex
echo "Attach: tmux attach -t $SESSION_NAME"
Ralph local-codex worker:
codex exec --sandbox workspace-write --ask-for-approval never "Your prompt"
.agents/skills/ralph.config.json with "worker": "local-codex" + .ralph/scripts/ralph-chain-next.sh (see .ralph/README.md)