codex-setup

codex-setup is an agent for coding agents from AndrewAltimit/template-repo. It costs 0 tokens per session (2,260 once invoked), scanned B, original, Unlicense.

A setup and usage guide for OpenAI Codex, an AI coding agent that can turn natural-language instructions into code. The provided guide says this integration is disabled in its project and describes how it could be re-enabled.

In plain words
What is it for?
Use it to understand the project's Codex configuration, disabled integrations, and documented re-enablement steps.
Why use it?
It explains the repository's current position on Codex and identifies the configuration changes needed before using the integration again.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/andrewaltimit/template-repo/codex-setup
Clone the repo
git clone --depth 1 https://github.com/AndrewAltimit/template-repo
Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,260 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.02260
Opus 5 $0.00000 $0.01130
Sonnet 5 $0.00000 $0.00452
Haiku 4.5 $0.00000 $0.00226

Measured 3d ago against content hash ad524aafa5ca, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade B, and why

codex-setup scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Unrestricted tool accessmediumExcessive agency

A wildcard tool grant or "run any command" leaves no least-privilege boundary at all.

**Security Notice**: Codex can execute arbitrary code. The MCP integration defaults to **safe sandboxed mode** to protect your system.
docs/agents/codex-setup.md · 310 lines

How it starts

The opening of the file, as written. The whole thing — 310 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Codex Agent Setup and Configuration

THIS INTEGRATION IS DISABLED

OpenAI has entered partnerships with governments that conduct mass surveillance and enable autonomous weapons. All OpenAI/Codex/GPT integrations in this project have been disabled as of March 2026. The mass surveillance exposure alone makes any OpenAI product an unacceptable security risk for pipelines handling proprietary or sensitive code.

We strongly recommend Anthropic models (Claude) as the primary AI backend. If you choose to re-enable OpenAI integrations despite these risks, do so with extreme caution, full awareness of the data exposure implications, and only if you truly understand what you are opting into.

To re-enable: restore the codex key in .mcp.json, change docker-compose profiles back from codex-disabled to services/codex, and restore the if condition in pr-validation.yml.

This guide covers the setup and usage of OpenAI Codex as an AI agent in the repository.

Overview

Codex is OpenAI's AI system that translates natural language to code. It powers GitHub Copilot and can be used as a standalone CLI tool for code generation, completion, and refactoring tasks.

Important: Sandbox Configuration

Security Notice: Codex can execute arbitrary code. The MCP integration defaults to safe sandboxed mode to protect your system.

Default Safe Mode (Recommended)

By default, the Codex MCP server runs with:

  • --sandbox workspace-write: Restricts file system access to workspace only
  • --full-auto: Bypasses manual approvals but maintains sandbox restrictions

This is the recommended configuration for most users.

Sandboxed VM Mode (Advanced)

If you're running in an already-sandboxed environment (VM, container, or isolated system), you can enable bypass mode:

# Set environment variable BEFORE starting the MCP server
export CODEX_BYPASS_SANDBOX=true

# This enables --dangerously-bypass-approvals-and-sandbox
# ONLY use this in sandboxed VMs or containers!

Read the full file on GitHub · 310 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 310 lines · 0 tokens per session scan B ad524aafa5ca

Subscribe to this mod's changes

codex-setup is an agent published in the GitHub repository AndrewAltimit/template-repo (131 stars, last pushed 1mo ago), licensed Unlicense. It costs nothing until one of its globs matches a file; then it loads 2,260 tokens. A static security scan graded it B with 1 finding (unrestricted tool access). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.