CodexBridge Admin

Connection profile

Use this for the next start. Current tunnel URLs appear here when the launcher knows them.

not saved yet

Current Server URL No public URL detected for this run

No public tunnel is saved; local MCP clients can use the local URL.

Connection

Choose how ChatGPT reaches this local MCP server. Stable providers use the saved hostname; quick Cloudflare generates the URL at launch.

Tunnel Public hostname Port Mode

No public tunnel is saved; local MCP clients can use the local URL.

Runtime policy

Save the default access level for the next launch. These settings do not mutate the process that is already running.

Bash Write mode Tool mode Codex sessions Codex directory Bash session

Require matching bash session id

Read-only this run

Bash transcriptcompact

Widget originhttps://naplesblue.github.io

/root/.codexbridge/profiles/d46d1597c8b42f0af1a2d225.json

Tokens stay hidden. Restart CodexBridge for saved profile changes to apply.

Quick path

For a new local admin session, do these in order.

1Check the profile

Save the tunnel, port, mode, bash, write, tool, Codex sessions, and working directory defaults for the next launch.

2Copy the Server URL

Use the current public URL shown in the profile when available, or the one printed by the terminal after launch.

3Open ChatGPT settings

Create an app connection, choose Server URL, paste the public URL, and use no extra authentication.

4Restart for policy changes

Saved profile changes apply when CodexBridge starts again. This keeps the live server predictable.

Current session

Workspace/srv/codexbridge/workspaces

Local MCPhttp://0.0.0.0:8789/mcp

Write modeagent

Tool modestandard

Bash modeoff

Transcriptcompact

Bash sessionnot set

Codex sessionsoff

Widget domainhttps://naplesblue.github.io

AuthDisabled

Connect ChatGPT

Create an app connection that points at the public Server URL copied by the terminal.

1Open ChatGPT settings and create an app connection.
2Set Connection to Server URL.
3Paste the public CodexBridge URL from the terminal.
4Use No Authentication / None; the private token is already in the copied URL.

Open ChatGPT settings

CLI controls

Copy these when you need to restart with a different runtime policy. They do not mutate the running process from the browser.

Re-run setup wizard

Use the CLI for broader profile edits that are intentionally not exposed here.

codexbridge setup

Copy local MCP URL

Useful for a local MCP client. ChatGPT usually needs the public tunnel URL copied by the terminal.

http://0.0.0.0:8789/mcp

Start without bash

Restart with file tools but no ChatGPT-triggered bash tool.

codexbridge start --root '/srv/codexbridge/workspaces' --no-bash

Require explicit bash target

Restart so bash calls must include this matching session_id.

codexbridge start --root '/srv/codexbridge/workspaces' --bash-session 'main' --require-bash-session

Show Codex session list

Restart with read-only local Codex session metadata in full tool mode.

codexbridge start --root '/srv/codexbridge/workspaces' --tool-mode full --codex-sessions metadata

Read Codex transcripts

Restart with bounded local transcript reads from Codex JSONL history.

codexbridge start --root '/srv/codexbridge/workspaces' --tool-mode full --codex-sessions read

Use full bash transcript

Restart with the raw stdout/stderr transcript instead of compact tool cards.

codexbridge start --root '/srv/codexbridge/workspaces' --bash-transcript full

Allowed roots

/srv/codexbridge/workspaces

CodexBridge rejects workspace access outside these roots.