Using Shipables skills with OpenAI Codex CLI.

Codex CLI

Codex CLI is OpenAI's command-line coding agent. Shipables installs skills and MCP servers for Codex.

Detection

The CLI detects Codex by checking for:

codex binary in PATH
~/.codex/ directory

File locations

Project-level (default)

Type	Path
Skill files	`.agents/skills/<name>/`
MCP config	`.codex/mcp.json`

Global (`--global`)

Type	Path
Skill files	`~/.agents/skills/<name>/`
MCP config	`~/.codex/mcp.json`

Install example

shipables install Chippers255/ai-commits --codex
shipables install Chippers255/ai-commits --codex --global

MCP configuration

After installing, your .codex/mcp.json will include:

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_CONNECTION_STRING": "postgresql://..."
      }
    }
  }
}

The key used is mcpServers.

Verifying installation

ls .agents/skills/<name>/
cat .codex/mcp.json
shipables doctor