Skip to main content
🚧 Expanding soon — full Codex CLI integration documentation is in progress.

​
BossMode + Codex CLI

OpenAI’s Codex CLI is a terminal-native agent runner. The BossMode-Codex integration connects your Codex CLI sessions to BossMode’s governance layer — standing orders enforced, moves logged, and results surfaced in your Daily Report.

​
How it works

BossMode provides a Codex-compatible MCP server that injects operational context into every Codex CLI session. When you run a Codex task, BossMode:
  1. Provides your standing orders as system constraints
  2. Supplies buyer profiles and business context
  3. Logs every action to the audit feed
  4. Queues output for approval per your governance settings

​
Setup

Install the BossMode MCP server: 
npm i -g @acelabs/bossmode-mcp-server
Configure Codex CLI to use it. In ~/.codex/config.json: 
{
  "mcpServers": {
    "bossmode": {
      "command": "bossmode-mcp-server",
      "env": {
        "BOSSMODE_API_TOKEN": "bm_live_your_token"
      }
    }
  }
}

​
Using BossMode context in Codex

Once connected, reference BossMode in your Codex prompts: 
codex "Using the BossMode context, draft a re-engagement email for leads who completed 
       the trust score but haven't booked a call in 7 days."
Codex pulls standing orders and buyer profiles automatically via the MCP server.

​
Logging back to BossMode

Codex executions are logged via the MCP server automatically when logAllMoves: true in your BossMode settings. Manual logging from a Codex session: 
# After Codex completes a task
bossmode-mcp-server log \
  --capo capo_marketing \
  --action "email-drafted" \
  --description "Re-engagement email drafted for 7-day trust-score leads"

​
Your ChatGPT Plus subscription

If you’re using Codex CLI with your ChatGPT Plus subscription, BossMode governance works the same way — it’s inference-provider agnostic. Set OPENAI_API_KEY per Codex CLI docs and BOSSMODE_API_TOKEN for governance. The only limitation is that BossMode’s Trust Intelligence score generation uses Gemini (for AvatarCzar). All other governance features work with any inference provider.

​
Requirements

  • Codex CLI v0.8.0 or higher
  • BossMode Pro account
  • BOSSMODE_API_TOKEN set in your environment
  • OPENAI_API_KEY for Codex CLI inference