# Codex CLI Subagent Transport

> Use only when native subagent execution is unavailable and the caller needs one deterministic Codex CLI run with repo-local artifacts and a manifest-based result contract.

- Skill: `shaowei-g/codex-cli-subagent-transport` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add shaowei-g/codex-cli-subagent-transport`
- Raw SKILL.md: https://api.skillmd.com/api/skills/shaowei-g/codex-cli-subagent-transport/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: shaowei-g (https://skillmd.com/u/shaowei-g)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/shaowei-g/codex-cli-subagent-transport

---


# Codex CLI Subagent Transport

Use this skill only for delegated transport. It does not own routing, phase judgment, acceptance, repair, or specialist semantics.

## Load First

- `./references/manifest-based-run-contract.md`

## Authority Boundary

- This skill owns only the mechanics of one Codex CLI execution.
- The caller owns prompt content, delegated scope, response validation, acceptance, and retry policy.
- This skill must not infer feature state, phase readiness, or acceptance from logs.

## Required Inputs

Provide these values explicitly:

- repo root
- feature slug
- assigned phase
- assigned subagent
- prompt file
- model when non-default
- run id when the caller wants deterministic naming
- run root when the caller overrides the default repository-local run location

## Required Outputs

Every run must materialize:

- repo-local run directory
- `prompt.md`
- `response.md`
- `exec.log`
- `manifest.env`
- `manifest.json`
- printed path assignments for the caller

## Invocation

Preferred invocation:

```bash
bash ./scripts/run_codex_cli_subagent.sh \
  --repo-root /abs/path/to/repo \
  --feature <feature-slug> \
  --phase <assigned-phase> \
  --subagent <assigned-subagent> \
  --prompt-file /abs/path/to/prompt.md
```

## Stop Rule

- Run exactly one `codex exec` call.
- Always emit manifest files and printed path assignments after the run finishes.
- Do not retry, reroute, or reinterpret the result inside this skill.
- Treat `response.md` as the only authoritative payload and `exec.log` as diagnostics only.