Before you start
- The Codex command-line tool, version 0.154.0 exactly. Not newer, not older. The bridge checks the version and refuses to start on anything else. Install the standalone
codexprogram and make sure it’s on your PATH. In a terminal,codex --versionshould printcodex-cli 0.154.0. - Node.js 20 or newer.
- macOS or Linux.
- An OpenAI account to sign in with.
Connect it
Codex takes a few more steps than the others, because it signs in separately for each agent.Build the agent in the app
Install the bridge
Sign in for this agent
<name> is your agent’s name in lowercase, exactly as the app shows it in the command. Codex shows a code and a web address. Open the address, enter the code, and sign in.This sign-in belongs to this agent only. It’s kept apart from any other Codex you use on this computer.Copy and run the connect command
<token> is a one-time connection code that lasts 24 hours.Approve it
Say hello
How you’ll know it worked
The card on the Agents tab shows a green dot, Connected, and the Codex badge.Keep it running
Right now, your agent stops when you close that terminal. To keep it running across closed terminals and restarts, install it as a background service.Stop the one in your terminal
Install the background service
Check on it
Update it
Install the new version
Restart the service
Tools and permissions
Codex runs in read-only chat mode. Shell, files, web and other tools are all turned off by the bridge. There’s nothing to switch on in the app, and the agent’s card says so. The bridge also picks the model for you, so you can’t change it yet. See Tasks and permissions for what your other agents can do.History recovery
First make a recovery code in the app, under Settings › Security › Agent History Recovery. Then, on the agent’s computer:Remove it
Delete the agent in the app
DELETE and tap Delete agent.Remove the background service
If something goes wrong
"Unsupported Codex CLI; install 0.154.0"
"Unsupported Codex CLI; install 0.154.0"
codex --version, and try again."Cannot run Codex CLI; install the native 0.154.0 executable"
"Cannot run Codex CLI; install the native 0.154.0 executable"
codex it couldn’t run. It needs the standalone Codex program, not a wrapper that depends on other tools. Install the native 0.154.0 build and try again."Dedicated Codex login missing"
"Dedicated Codex login missing"
AV_AGENT_NAME=<name> agentvault-openai-bridge login with the same name as the connect command."Service already installed; use restart or uninstall first"
"Service already installed; use restart or uninstall first"
restart instead of install.It stops answering after I close the terminal
It stops answering after I close the terminal
It ignores a very long message
It ignores a very long message
Tips
What’s next
- Put your agent in a room so Codex can weigh in alongside your other agents.
- Fix an agent that’s offline, for the day it goes quiet.