Skip to content

Start with Codex

wisp runs Codex in the background, one worktree per task, on your own ChatGPT plan or OpenAI key.

What you need

The codex command. wisp also finds the standalone installer’s copy, and the Codex inside the ChatGPT desktop app on macOS (on Windows that copy can’t be run from outside the app).

Terminal window
npm i -g @openai/codex

Sign in

Open Settings (the person button in the top bar, or ⌘K → Settings) → Agents → Sign in next to Codex. Open the sign-in page, enter the code wisp shows, and wait: wisp sees when you’re done. A key instead? Press Keys and paste it.

In the browser (wisp --browser, or your cloud wisp) it’s the same window, menus and keys.

Settings → Agents: each harness with its accounts and sign-in state, and an Add key buttonSettings → Agents: each harness with its accounts and sign-in state, and an Add key button

Pick it, its model and its effort

wisp reads Codex’s own model list. Effort: minimal, low, medium, high, xhigh.

Click the harness chip in the New task footer (N), pick Codex, then a model and a thinking level. On a running task, the same chip in the reply box changes it for the next follow-up.

Modes work as everywhere: Plan changes nothing, Edits asks before commands, Full auto never asks (--mode plan|edits|auto).

What wisp adds for Codex

  • Several accounts: Settings → Agents → Add another Codex account. Each keeps its own limits.
  • Usage windows: wisp reads Codex’s 5-hour and weekly windows, and any banked resets. Settings → Usage → Check Codex while work waits asks Codex every 10 minutes how they stand, so held work goes as soon as a window resets. Nothing is spent.
  • Automations stop at: Codex can have its own line, so your ChatGPT chats keep room on a shared plan.
  • Questions from Codex reach you in wisp and the run waits.

Open in Codex

Open the task’s ⋯ at its top right → Open in › Open in Codex (key T). Codex opens in a terminal in the side panel.

Next: Budgets and usage, MCP from your harness.