Codex
Run bots on the official Codex CLI you install and sign in to yourself.
Codex is a trademark of its owner. Murage isn't affiliated with OpenAI.
When to use it
- You already use Codex and want your bots on it.
- You want a full-featured engine: handing off work, connected apps, the built-in browser, computers, your phone and pictures.
- You want Codex's own commands, like
/reviewand/compact, inside a Murage chat.
Install and sign in
Step 1
Find the engine
Open SettingsModels & enginesEngines and find Codex.
You're done when: you can see the Codex row and its status line.
Step 2
Install it
If it says Not detected, press Install Codex. That's one press. Murage downloads Codex's own release from OpenAI's GitHub page, checks it, installs it into its own folder while the card counts up ("Downloading … of … MB"), makes sure it runs, and only then switches to it. This works on macOS, Linux and 64-bit Windows, with no Terminal and no Node.js or npm.
You're done when: the download has finished and the card shows Sign in to Codex.
Step 3
Sign in
If the status says Detected · sign-in required, press Sign in to Codex on the same card. Choose Open sign-in and finish the Codex sign-in in your browser. Murage shows "Waiting for you in the browser" until you do, then "Signed in to" and your account. You can also ask Ember in chat on your computer to sign you in. Then Murage checks that Codex gives a real reply.
You're done when: you finished the Codex sign-in.
Step 4
Check again
Back in Murage, choose Check again.
You're done when: the status reads Detected · signed in.
Updates
The Codex row has Check for engine updates. When a newer version exists, you'll see Engine update available and an Update button. Murage keeps your current Codex until the new version is installed and verified, so a failed update leaves you where you were. Stop running tasks before updating.
What works
- Tools: all of Murage's tools, including handing work to other bots, memory search, your own MCP servers, connected apps, the built-in browser, cloud and local computers, this computer (with your approval) and a USB-connected Android phone.
- Pictures you attach go straight to the model.
- Model picking: Codex's own models, the Flux Router tiers, models from an OpenAI key in SettingsModels & engines, and local models that pass Murage's test for Codex-style tools.
- Effort: low, medium, high, xhigh and max in Bot settingsModel. Codex applies a level to the whole conversation, so pick it before you start.
- Engine commands: type
/to see Codex's own commands, such as/reviewand/compact, alongside Murage's. A command never interrupts a turn that's running.
Known limits
- Plan limits. Your Codex account's limits apply. Murage makes no claim about what your plan includes.
- Voice needs its own keys. A ChatGPT or Codex subscription doesn't pay for voice calls. Voice needs Flux Router credits or your own voice keys.
- Local models need a test. Local models only appear for Codex after they pass the Codex (responses) check in SettingsModelsLocal models.
Troubleshooting
You see
401 UnauthorizedDo this
Codex isn't signed in, or its sign-in expired. Check with codex login status in a terminal, sign in again with codex login --device-auth, then restart Murage.
You see
codex CLI not foundDo this
Install Codex, restart Murage, or choose Set CLI… and pick the codex program yourself.
You see
Engine installation could not be verified or activated. Your previous engine is unchanged.Do this
Finish running tasks, check your connection, then try Install Codex again.
You see
Managed installation is not supported for this engine on this platform. Use its setup guide.Do this
Use the install command instead, or View setup guide.
You see
Could not check for engine updates.Do this
Murage couldn't reach the package registry. Try again later.
You see
A model failsDo this
Pick a model your account actually has, refresh the list in Bot settingsModel after updating Codex, and try the same model in Codex on its own.