Skip to main content
Glama
redmikarimo

codex-supervisor

by redmikarimo
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
CODEX_BINNoCodex executable path. Default is 'codex'.codex
CODEX_EVENT_LIMITNoIn-memory event count, clamped to 100–10,000. Default is '1000'.1000
CODEX_ALLOWED_ROOTSYesRepository roots separated by the platform path-list delimiter. Required.
CODEX_ALLOW_NETWORKNoSet to '1' to allow callers to request network access. Default is '0'.0
CODEX_APP_SERVER_ARGSNoAdvanced JSON array replacing every argument passed to 'codex'. Overriding removes the recursion guard; include an equivalent disable override yourself.
CODEX_SUPERVISOR_DEBUGNoSet to '1' to copy Codex app-server stderr to this server's stderr. Default is '0'.0
CODEX_SUPERVISOR_MCP_NAMENoMCP config id disabled in the nested app-server to prevent recursion. Default is 'codex-supervisor'.codex-supervisor

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
codex_startA

Start a new Codex app-server thread and immediately begin a turn in an allowed local repository. Return threadId, turnId, and an event cursor for codex_wait or codex_status.

codex_sendA

Resume an authorized Codex thread when necessary and start a new turn. Use only when no turn is active; use codex_steer for an in-flight turn.

codex_steerA

Append guidance to the currently active turn without creating another turn. Supply expectedTurnId when available to prevent steering the wrong turn.

codex_statusA

Read a thread snapshot, current turn state, pending approvals, latest agent message, latest diff, and recent streamed events.

codex_waitA

Long-poll an active turn until it completes, fails, requests approval, is interrupted, or reaches the timeout. Continue with the returned eventCursor.

codex_interruptA

Request cancellation of an active Codex turn.

codex_list_threadsA

List persisted Codex threads whose working directories are inside CODEX_ALLOWED_ROOTS. Results outside those roots are filtered.

codex_read_threadA

Read a persisted authorized Codex thread. The bridge denies threads outside CODEX_ALLOWED_ROOTS.

codex_list_approvalsA

List pending app-server requests. This release resolves command-execution and file-change approval requests; unsupported request types remain visible.

codex_resolve_approvalA

Explicitly accept, accept for the session, decline, or cancel a pending Codex command-execution or file-change approval.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/redmikarimo/codex-supervisor-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server