X9 Codex Delegation

Delegate from Claude Code to Codex

Use x9-browser-session for browser routing. Use the plugin route when it is available; the raw CLI remains a fallback for an explicitly requested delegation.

The onboarding declaration is the machine-readable onboarding contract.

When Claude and OpenAI/Codex are backed by separate subscriptions or usage pools, delegation can distribute substantial work instead of exhausting only the Claude allowance. Treat that as a user-specific routing benefit, not a promise of lower cost: API billing, plan limits, and available runtimes vary.

Choose the route

• Implementation or fixes: use the installed codex:codex-rescue subagent when available. It is write-capable; the active project's local-change authority applies.
• Read-only review or one-shot analysis: use the plugin route when callable, otherwise raw codex exec.
• Logged-in browsing: delegate the whole bounded browse-and-return task and follow the browser adapter. Shell read-only mode does not change the separately approved browser authority.
• Plugin commands marked user-only: report the exact command for the user; do not pretend it was invoked programmatically.

Raw fallback

Read references/codex-cli.md and use its one-shot or resume recipe after checking the current command help. That reference owns exact flags and known differences between exec and resume; this skill owns the delegation contract, not the volatile command surface. Prefer the model configured in ~/.codex/config.toml unless the user explicitly chooses another.

Brief contract

Pass a self-contained outcome, relevant files/sources, constraints, authority, deliverable, and completion bar. Add these failure rules when tools or current facts are load-bearing:

• Report failed or cancelled calls exactly; do not substitute memory.
• Surface an unresolved fork only when it materially changes the result.
• Attach evidence appropriate to the task: paths/diff/tests for code; URLs and exact facts for research.

Verify delegated work

For write-capable work, the delegate's report is advisory:

1. Inspect git status and the full relevant diff; preserve unrelated changes.
2. Run focused verification in the orchestrator's environment.
3. Confirm the result matches the brief rather than only the delegate's narration.

Stop retrying when the same blocking cause repeats, the budget is exhausted, or a fresh run cannot add evidence. Report the blocker instead of using a universal round count.

Record the delegation

Logging is off by default. Append to ~/.local/share/x9/codex-delegation-log.md only when the user explicitly opts in for the current task/session or an existing user-owned policy records that choice. Delegation must work normally without a log; do not ask again when the current scope already contains the answer.

When logging is enabled, read the current table header before writing and keep each row to minimal non-sensitive telemetry: route, actual model/effort when observable, wall-clock time, Codex tokens, whether rework was needed, and a generic success/failure outcome. Never record task content, secrets, repository names, or personal paths. Use н/д for unavailable data and ? when rework is not known yet; never invent telemetry. Do not replace an existing file or follow a symlink; report that logging was skipped instead.

The log is optional permanent operational history, not a completion gate. A missing or unwritable log must not fail the delegated task.

Done

• The actual Codex model/runtime is inherited or explicitly confirmed when load-bearing.
• Tool failures and degraded results are visible.
• Write results have orchestrator-owned diff review and verification evidence.
• When logging was enabled, the minimal telemetry row is recorded or the logging failure is visible.