Skip to content

Codex CLI

Prerequisites

  1. Node.js 18+
  2. Codex CLI installed and authenticated - See the Codex CLI repository for installation

Install & Run

bash
# Install daemon
npm install -g @cmdctrl/codex-cli

# Register
cmdctrl-codex-cli register -s https://api.cmd-ctrl.ai

# Start
cmdctrl-codex-cli start

Session Discovery

The daemon automatically discovers existing Codex CLI sessions from ~/.codex/sessions/. Sessions started outside Cmd+Ctrl appear in your dashboard with full message history.

Troubleshooting

"Not registered" - Run cmdctrl-codex-cli register -s https://api.cmd-ctrl.ai

"Codex not found" - Ensure codex is in your PATH: which codex

Connection issues - Check status with cmdctrl-codex-cli status, try re-registering