This reference covers detailed configuration for the official codex plugin. For setup and routing decisions, start with Codex harness.

Plugin config surface

All Codex harness settings live under plugins.entries.codex.config.

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          discovery: {
            enabled: true,
            timeoutMs: 10000,
          },
          appServer: {
            mode: "guardian",
          },
        },
      },
    },
  },
}

Top-level fields:

Field Default Meaning
discovery enabled Model discovery settings for Codex app-server model/list. See Codex model discovery.
appServer managed stdio app-server Transport, command, auth, approval, sandbox, and timeout settings. The ordinary harness defaults to agent-scoped state. See Codex app-server transport.
codexDynamicToolsLoading "searchable" Use "direct" to put Apus dynamic tools directly in the initial Codex tool context. See Codex dynamic tools.
codexDynamicToolsExclude [] Additional Apus dynamic tool names to omit from Codex app-server turns. See Codex dynamic tools.
codexPlugins disabled Native Codex plugin/app support, including opt-in access to connected account apps. See Native Codex plugins.
computerUse disabled Codex Computer Use setup. See Codex Computer Use.
sessionCatalog enabled Native Codex session discovery for the sidebar. Set enabled: false to disable it, or set homes to include additional local Codex stores. See Codex session catalog and supervision.
supervision disabled Agent-facing native-session transcript and write-control policy. See Codex supervision.

Where each section moved

Every section of the single-page version now lives on this page or on one of the nine child pages below. The anchors from the single-page version still resolve here.

Codex session catalog and supervision

Codex session catalog and supervision — Native Codex session discovery and agent-facing supervision settings.

Codex app-server transport

Codex app-server transport — App-server transport selection, the appServer field table, and local testing env overrides.

Codex approval and sandbox modes

Codex approval and sandbox modes — YOLO and guardian approval presets, and sandboxed native execution paths.

Codex auth and environment isolation

Codex auth and environment isolation — Codex auth selection order, credential handling, and environment isolation.

Codex dynamic tools

Codex dynamic tools — How Apus dynamic tools are exposed to Codex app-server turns.

Codex timeouts and turn settlement

Codex timeouts and turn settlement — Dynamic tool timeout order, turn execution budgets, and local settlement.

Codex model discovery

Codex model discovery — Codex app-server model discovery, offline hints, and catalog rules.

Codex restricted turns

Codex restricted turns — When a tool policy restricts the Codex native surface, and what ring zero adds.

Codex workspace bootstrap files

Codex workspace bootstrap files — Which workspace bootstrap files reach a Codex turn, and how they are carried.

Related