// Delegate coding tasks to the OpenAI Codex CLI for features, refactoring, PR reviews, and batch fixes. Requires the codex CLI and typically a git repository.
DeepNote knowledge base: persistent interlinked markdown wiki with ingest, query, lint, link graph and history.
Delegate coding tasks to the OpenCode CLI for feature work, refactoring, PR review, and autonomous-style runs. Requires opencode installed where the agent can execute shell commands.
| name | codex |
| description | Delegate coding tasks to the OpenAI Codex CLI for features, refactoring, PR reviews, and batch fixes. Requires the codex CLI and typically a git repository. |
| version | 1.0.0 |
| license | MIT |
| metadata | {"clawcode":{"tags":["Coding-Agent","Codex","OpenAI","Code-Review","Refactoring"],"related_skills":["coding-standards","python-patterns","opencode"]}} |
Use OpenAI Codex as an external coding agent when the user wants Codex specifically.
Do not confuse these entry points (they are not interchangeable):
| Entry | Role |
|---|---|
/codex-cli (TUI slash) | One-shot probe or command via codex_cli_bridge: merged stdout/stderr, not a PTY session and not multi-turn TUI control. Default args often --version. |
bash | One-shot shell in agent turns, e.g. codex exec '…'. |
terminal + process (Agent tools) | Multi-turn driving of Codex: terminal with background=true (and pty=true on POSIX with clawcode[terminal-pty]), then process for poll / submit / kill. Codex expects a git repo; for scratch dirs use mktemp -d && git init. Windows local PTY is limited—full TUI automation use WSL/Linux. |
Optional: pip install 'clawcode[terminal-pty]' for ptyprocess on POSIX.
npm install -g @openai/codex (command name codex on PATH).git init for greenfield scratch.codex explicitly.codex exec '...' via bash in the project workspace./codex-cli after /claw (default codex --version); same terminal stack as /claude-cli / /opencode-cli.| Goal | What to use |
|---|---|
| Quick probe | /codex-cli only—single run, not multi-run TUI. |
| One-shot exec | bash or terminal foreground: codex exec 'task' with working_directory in a git repo. |
| Long / background | terminal (background=true, pty=true where supported) + process. Optional check_interval on terminal for TUI completion notifications (see CLAW_SUPPORT_MAP.md). |
terminal(command="codex exec 'Add dark mode toggle to settings'", workdir="~/project", pty=true)
Scratch with new repo:
terminal(command="cd $(mktemp -d) && git init && codex exec 'Build a snake game in Python'", pty=true)
terminal(command="codex exec --full-auto 'Refactor the auth module'", workdir="~/project", background=true, pty=true)
process(action="poll", session_id="<id>")
process(action="log", session_id="<id>")
process(action="submit", session_id="<id>", data="yes")
process(action="kill", session_id="<id>")
| Flag | Effect |
|---|---|
exec "prompt" | One-shot run, exits when done |
--full-auto | Sandboxed; auto-approves file changes in workspace |
--yolo | No sandbox (dangerous; use with care) |
pty=true for interactive Codex sessions on POSIX; without PTY many CLIs misbehave./codex-cli does not replace terminal/process for long interactive work.