Files
ECC/.codex/user-config.example.toml
T
haelyra 4f5970bf4f fix(codex): ship named CLI profile files with ownership protection
Reproduced issue #3485 on installed Codex CLI 0.162.0. Keep user legacy choices for explicit migration and verify disposable install, repair, reinstall and removal.
2026-10-11 01:55:54 -04:00

117 lines
4.0 KiB
TOML

#:schema https://developers.openai.com/codex/config-schema.json
# ECC user-install reference (a separate TOML document).
# Legacy add-only sync and the native Codex home installer use this file.
# Review these existing defaults and integrations before choosing to install them.
# This is not the project config; .codex/config.toml contains project guidance.
# Neither reference certifies effective permissions or runtime compatibility.
# CLI overrides, supported Codex versions and administrator policy still matter.
# https://developers.openai.com/codex/config-reference
# https://developers.openai.com/codex/multi-agent
# Model selection
# Leave `model` and `model_provider` unset so Codex CLI uses its current
# built-in defaults. Uncomment and pin them only if you intentionally want
# user-level model overrides.
# Existing ECC user-level runtime defaults.
approval_policy = "on-request"
sandbox_mode = "workspace-write"
web_search = "live"
# Optional external notification command, preserved from the user reference.
notify = [
"terminal-notifier",
"-title", "Codex ECC",
"-message", "Task completed!",
"-sound", "default",
]
# Existing ECC instruction key retained for sync compatibility.
# Check the configuration reference for your supported Codex version.
persistent_instructions = "Follow project AGENTS.md guidelines. Use available MCP servers when they can help."
# Optional instruction-file override; consult the supported version's semantics.
# model_instructions_file = "/absolute/path/to/instructions.md"
# MCP servers
# Existing user-install registrations are preserved here as data.
# Installing or running a server is a separate choice; no package pins are changed.
[mcp_servers.github]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
startup_timeout_sec = 30
[mcp_servers.context7]
command = "npx"
# Canonical Codex section name is `context7`; the package itself remains
# `@upstash/context7-mcp`.
args = ["-y", "@upstash/context7-mcp@latest"]
startup_timeout_sec = 30
[mcp_servers.exa]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.exa.ai/mcp"]
startup_timeout_sec = 30
[mcp_servers.memory]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-memory"]
startup_timeout_sec = 30
[mcp_servers.playwright]
command = "npx"
args = ["-y", "@playwright/mcp@latest", "--extension"]
startup_timeout_sec = 30
[mcp_servers.sequential-thinking]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-sequential-thinking"]
startup_timeout_sec = 30
# Additional MCP servers (uncomment as needed):
# [mcp_servers.supabase]
# command = "npx"
# args = ["-y", "supabase-mcp-server@latest", "--read-only"]
#
# [mcp_servers.firecrawl]
# command = "npx"
# args = ["-y", "firecrawl-mcp"]
#
# [mcp_servers.fal-ai]
# command = "npx"
# args = ["-y", "fal-ai-mcp-server"]
#
# [mcp_servers.cloudflare]
# command = "npx"
# args = ["-y", "@cloudflare/mcp-server-cloudflare"]
[features]
# Preserve ECC's explicit multi-agent setting.
multi_agent = true
# Codex 0.134+ reads named profiles from <CODEX_HOME>/<name>.config.toml.
# Install strict.config.toml and yolo.config.toml beside config.toml, then use
# `codex -p strict` or `codex -p yolo`. Defining a file does not select it.
# For an existing home, move legacy [profiles.<name>] settings into that file
# and remove the legacy table and top-level profile selector after review.
# Approval and sandbox policy remain separate; the default above is on-request.
[agents]
# Multi-agent role limits and local role definitions.
# These map to `.codex/agents/*.toml` and mirror the repo's explorer/reviewer/docs workflow.
max_threads = 6
max_depth = 1
[agents.explorer]
description = "Read-only codebase explorer for gathering evidence before changes are proposed."
config_file = "agents/explorer.toml"
[agents.reviewer]
description = "PR reviewer focused on correctness, security, and missing tests."
config_file = "agents/reviewer.toml"
[agents.docs_researcher]
description = "Documentation specialist that verifies APIs, framework behavior, and release notes."
config_file = "agents/docs-researcher.toml"