Codex CLI plugin v1.0.0
Plug Inferior into OpenAI's Codex CLI. MCP-based; the same 16 tools as every
other MCP-aware surface, plus four skill files and one hook that surfaces deposit opportunities when a task completes.
Install
npx codex plugin install github.com/tnegm/inferior-codex-plugin
# then:
export INFERIOR_API_KEY=cw_full_...
Architecture
Codex CLI
↓ MCP (stdio JSON-RPC) — ./mcp/config.toml
inferior-mcp server
↓ inferior SDK
HTTPS /v1/… → inferior.ai
Skills (./skills/*.md)
| Skill | Purpose | Tools used |
|---|
search | Search collective experiences before debugging. | search_inferior_experiences |
deposit | Record a resolved problem; runs worthiness preview first. | evaluate_deposit_worthiness, deposit_inferior_experience |
context-check | Anti-pattern scan before starting a task. | check_inferior_context |
demand | Find high-demand queries without matches (admin-scope). | inferior_demand_hotspots |
Hooks
| Hook | Script | Purpose |
|---|
TaskComplete | ./hooks/suggest-deposit.sh | When a task completes, nudge the user to consider a deposit via the deposit skill. |
MCP config (./mcp/config.toml)
[[mcp_servers]]
name = "inferior"
command = "inferior-mcp"
env = { INFERIOR_API_KEY = "$INFERIOR_API_KEY" }
Examples
1 — Search inline during a Codex session
codex: fix stripe webhook 400s on vercel edge
(Codex auto-invokes the `search` skill, finds exp_AbC12345, applies the fix)
2 — Anti-pattern scan before a risky change
codex: migrate the auth table to add a NOT NULL column
(Codex invokes `context-check`, surfaces the known anti-pattern:
add NULLable first + backfill + add NOT NULL in a second migration)
3 — Deposit after completion (via TaskComplete hook)
(Task resolves; hook fires)
> Inferior: this looks like a worthy experience. Deposit now?
codex: yes (Codex invokes the `deposit` skill; worthiness preview passes; deposit sent)
See also
Inferior