This repository contains my sensible defaults for Codex CLI.
npm install -g @openai/codexOr with Homebrew:
brew install openai/tap/codexAGENTS.md— Global instructions (read every session)config.toml— Global settings (model, approval mode, MCP servers)agents/— Custom agent definitions (TOML, assembled from shared + frontmatter)skills/— Skill definitions (SKILL.md format, assembled from shared + frontmatter)rules/— Custom rule filesshared/— Shared AI config submodule (dotbrains/shared-ai-config)frontmatter/— Codex-specific TOML frontmatter for agentsPLUGINS.md— External MCP servers and plugins (details)RULES.md— Rule definitions and usage (details)
| Agent | Purpose |
|---|---|
tech-lead |
Orchestrates complex workflows across specialist agents |
architect-designer |
High-level design, pattern selection, structural planning |
implementation-specialist |
Precise, scoped coding tasks with zero architectural drift |
requirements-clarifier |
Transforms vague requirements into actionable specifications |
test-automation-engineer |
Comprehensive test coverage, execution, and failure diagnosis |
task-decomposer |
Breaks overwhelming complexity into sequential action items |
| Skill | Purpose |
|---|---|
ship |
Commit, push, and open a PR |
The contents of this repository should be placed in your $HOME.
git clone --recursive https://github.com/dotbrains/codex.git $HOME/.codexAgent and skill body content is shared with Claude Code and OpenCode via the shared-ai-config submodule. To update after shared content changes:
git submodule update --remote shared
./shared/assemble.sh codexThis project is licensed under the PolyForm Shield License 1.0.0 -- see LICENSE for details.