Codex CLI¶

Codex CLI gets full learnship capabilities including real parallel subagents and the complete workflow suite.

Install¶

npx learnship --codex --global

Installs to ~/.codex/learnship/.

Invoke commands¶

Codex CLI uses a $learnship- prefix (dollar sign + hyphen):

$learnship-ls
$learnship-new-project
$learnship-discuss-phase 1
$learnship-plan-phase 1
$learnship-execute-phase 1
$learnship-verify-work 1
$learnship-quick "fix the login bug"
$learnship-help

Skills¶

Skills are installed as context files:

~/.codex/learnship/skills/
├── agentic-learning/
│   ├── SKILL.md
│   └── references/
└── impeccable/
    ├── SKILL.md
    └── [21 sub-skills]/

Reference explicitly to invoke:

Use the agentic-learning skill: learn [topic]
Run the impeccable /audit skill on this component

Parallel subagents¶

Codex CLI supports real parallel subagents. Enable:

.planning/config.json

{ "parallelization": true }

Capabilities¶

Feature	Status
Slash commands	✅ `$learnship-*` prefix
`@agentic-learning` skill	✅ Context file
`impeccable` skill suite	✅ Context file
Parallel subagents	✅ opt-in
Wave execution	✅ opt-in
Specialist agent pool	✅

Tip

Codex CLI uses $learnship- (dollar sign prefix) rather than /learnship: or /learnship-. This matches Codex CLI's native skill invocation convention.

Tip

AGENTS.md is not auto-loaded on Codex CLI the way it is on Windsurf or Claude Code. Run /new-project once per project — it generates an AGENTS.md at your project root. Codex CLI reads AGENTS.md when commands explicitly reference it, but for fully automatic context loading, keep AGENTS.md in the project root and your agent will encounter it via the workflows.