Codex in microManager

microManager runs the Codex CLI you already have installed and signed in, through Codex’s app-server protocol, so each chat is a Codex thread with streamed replies, approvals and model choice. Run several at once, each in its own git worktree, next to Claude Code or any other agent.

Updated

A Codex chat on GPT-6-Luna ending with all 12 tests passing after the npm test runs it was allowed once outside its sandbox, above the terminal drawer with Setup, Run server (still running) and Run tests tabs, Run tests showing each passing test and the totals.
Codex in its own workspace, with the server and the tests started as run scripts in the terminal drawer.

How do I run several Codex agents in parallel?

Create one workspace per task and pick Codex for each. Every workspace is its own git worktree and branch, so the Codex threads never edit the same files, and a workspace can hold more than one Codex chat tab. You review each one’s diff on its own and open a pull request per branch. Claude Code, Grok Build or any other agent can work in the next workspace over. See parallel agents.

How does microManager run Codex?

Each chat starts codex app-server and talks to it over standard input and output with JSON-RPC, the protocol Codex provides for apps that host it. A chat is a Codex thread: microManager starts or resumes the thread, sends your messages as turns, streams the replies and tool activity into the chat, and can interrupt a turn. If the app-server cannot be used, microManager falls back to codex exec --json.

Which codex does it run?

The one on your login shell’s PATH, or the path you set in Settings → Agents. When codex is the npm launcher script, microManager runs the native Codex binary the package installs beside it. If you set a custom Codex path in Conductor, the import carries it over.

How do approvals work?

When Codex asks before running a command or applying a change, a card in the chat shows the request with Allow once, Allow for this session and Reject. The mode picker sets Codex’s sandbox: Ask first lets it write in the workspace and asks for anything more, Accept edits also approves its file changes for you, Plan keeps it read-only, Auto lets Codex’s own reviewer answer its requests, and Bypass permissions gives it full access with no approvals.

Which models and reasoning levels can I use?

The model picker lists the models Codex has cached in ~/.codex/models_cache.json from the moment the app starts, refreshed from the app-server once a Codex chat runs, and takes any model id you type. The model and effort in your ~/.codex/config.toml become the profile’s defaults when you have not chosen others. Effort goes from low through medium, high, xhigh and max to ultra, and the picker offers the levels the chosen model supports.

What tools does Codex get from microManager?

microManager adds its micromanager MCP server to the Codex session through Codex’s own configuration flags, connected through a small stdio bridge to a local endpoint that only that session’s token can use. Codex can then ask you questions, read the workspace diff, leave review comments and read terminal output. See MCP tools.

Is my Codex history kept?

Codex keeps each thread in its own session files under ~/.codex/sessions, compressing older ones to .jsonl.zst, which microManager reads too. When microManager imports a chat that has a thread id, it reads that history (up to the newest 2,000 events) and the next message resumes the same thread.

What do I need?

The Codex CLI installed and signed in, so that codex works in your terminal.

Where to go next

Frequently asked questions

Do I need an OpenAI API key for microManager?

No. microManager starts your codex CLI, which uses whatever sign-in it already has. microManager has no account and never sees your credentials.

Which Codex models can I pick?

The models Codex has cached for your account, read when microManager starts and refreshed from Codex's app-server once a Codex chat runs. For any other model, type its id. The model in your Codex configuration is the default.

Can I continue Codex chats from Conductor?

Yes. Importing brings each Codex chat over with its thread id and loads its history from Codex's own session files, so the next message continues the same thread.

Get microManager

Free, no account, for macOS, Windows and Linux. It runs the agent CLIs you already have installed and signed in.

curl -fsSL https://micromanager.win/install.sh | sh

That installs it on macOS and Linux. On Windows, paste this into PowerShell:

irm https://micromanager.win/install.ps1 | iex