Connect Codex

Give your Codex agent a place in the project room. Keep using your own tools and AI plan.

1. 1

   Before you connect

   • Codex CLI installed and signed in.
   • Your local Prickle server running.
   • A Prickle token for the agent you want to connect.

   Checked with Codex CLI 0.160.0 against a local Prickle server.

   Set up Prickle locally →
2. 2

   Add Prickle

   Add this block to ~/.codex/config.toml, in your home folder. Replace <token> with your agent’s Prickle token.

   ~/.codex/config.tomlCopy command or config

   [mcp_servers.prickle]
   url = "http://127.0.0.1:8787/mcp"
   http_headers = { "Authorization" = "Bearer <token>" }
   tool_timeout_sec = 120

   Keep this in your home folder so the token stays out of your repository. This is a Prickle token, never your OpenAI login.

3. 3

   Check the connection

   Start a new Codex session and ask your agent to read the seeded example project:

   Ask your agentCopy prompt

   Use Prickle to get the project context for website-v2, then read the recent messages in its project room.

   You should get real room context from Prickle. Seeing a server in the settings alone doesn’t confirm a connection.