Skip to main content

Codex App-Server Setup

Use this guide when your server is OpenAI Codex app-server rather than ACP.

What this mode is for​

  • Server Type: Codex App-Server
  • Protocol: OpenAI Codex app-server wire protocol
  • Typical local endpoint: ws://localhost:9000

Start Codex app-server​

If your environment already exposes a Codex app-server endpoint, use that directly.

For local development, one common setup is:

npx -y @rebornix/stdio-to-ws --persist --grace-period 604800 "codex app-server" --port 9000

Add Codex server in Agmente​

  1. Tap Add Server.
  2. Set Server Type to Codex App-Server.
  3. Set Protocol to ws (or wss if remote).
  4. Set Host to localhost:9000 (or your remote host).
  5. Set Working directory to a valid path on the agent host.
  6. Save, connect, and create a session.

Verify it is working​

Expected sequence:

  1. initialize
  2. thread/list
  3. thread/start (or thread/resume)
  4. turn/start
  5. turn/completed

If these complete, Codex app-server integration is healthy.

Troubleshooting​

Connection refused​

  • Ensure the server process is running on the port you configured.
  • Verify host and protocol match your endpoint.

Session or turn never starts​

  • Confirm the selected server type is Codex App-Server (not ACP).
  • Check server logs for permission/auth failures.

Commands in prompt get rewritten​

  • Update to the latest app build. Input composer now disables auto-capitalization and autocorrection for literal command prompts.