awesome-codex-subagents README

The project's README from github.com/VoltAgent/awesome-codex-subagents. As one markdown file: README.md.

codex

The awesome collection of 172+ Codex subagents across 13 categories.

Awesome Subagent Count Last Update Discord


Awesome Codex Subagents

This repository serves as the definitive collection of Codex Subagents, specialized AI assistants designed for specific development tasks. Written specifically for Codex and aligned with the official docs.

Installation

Use Codex custom agent directories exactly as documented:

  1. Clone this repository.
  2. Copy the .toml agent files you want into one of the directories above.
  3. Restart or refresh your Codex session if needed.
  4. Delegate explicitly in prompts (Codex does not auto-spawn custom subagents).

Examples:

mkdir -p ~/.codex/agents
cp categories/01-core-development/backend-developer.toml ~/.codex/agents/
mkdir -p .codex/agents
cp categories/04-quality-security/reviewer.toml .codex/agents/

If you use agent configuration in Codex, keep it in .codex/config.toml under [agents] as described in the official docs.

Sponsors

Crawlbase Crawlbase is web data infrastructure trusted by 70,000+ developers. Its Crawling API, MCP server, and integrations give AI agents live access to any webpage — with JavaScript rendering, proxy rotation, and anti-bot protection.
SerpApi SerpApi is a Web Search API for your AI apps. Available in Markdown and JSON for any integration.

👉 You can feature your product here and reach developers using AI coding agents like Claude Code, Codex, Gemini, and more.

Become a Sponsor

Subagent Storage Locations

Type Path Availability Precedence
Project Subagents .codex/agents/ Current project only Higher
Global Subagents ~/.codex/agents/ All projects Lower

Note: When naming conflicts occur, project-specific subagents override global ones.

Subagent Structure

Each subagent uses a Codex-native .toml format:

name = "subagent-name"
description = "When this agent should be invoked"
model = "gpt-5.6-luna"
model_reasoning_effort = "medium"
sandbox_mode = "read-only"

[instructions]
text = """
You are a [role description and expertise areas]...

[Agent-specific checklists, patterns, and guidelines]...
"""

Smart Model Routing

Each subagent includes a model field that automatically routes it to the right model -- balancing quality and cost:

Model When It's Used Examples
gpt-5.6-sol Deep reasoning -- architecture reviews, security audits, financial logic security-auditor, architect-reviewer, fintech-engineer
gpt-5.6-terra Implementation, diagnostics, evaluation, and multi-step professional analysis docker-expert, test-automator, scientific-literature-researcher
gpt-5.6-luna Bounded search, extraction, routing, drafting, and lightweight synthesis search-specialist, docs-researcher, agent-installer

Sandbox Mode Philosophy

Each subagent's sandbox_mode field controls filesystem access:

Categories

01. Core Development

Essential development subagents for everyday coding tasks.

02. Language Specialists

Language-specific experts with deep framework knowledge.

03. Infrastructure

DevOps, cloud, and deployment specialists.

04. Quality & Security — Testing, security, and code quality experts (19 agents)

04. Quality & Security

05. Data & AI — Data engineering, ML, and AI specialists (14 agents)

05. Data & AI

06. Developer Experience — Tooling and developer productivity experts (14 agents)

06. Developer Experience

awesome-codex-subagents (VoltAgent/awesome-codex-subagents)

Searching Database…

Что это?Отобранная коллекция из 170+ определений специализированных субагентов для OpenAI Codex, охватывающих задачи разработки: программирование, инфраструктуру, безопасность, данные/AI и опыт разработчиков.
Это инструмент или просто набор конфигов?Это набор конфигурационных файлов .toml, а не приложение или скрипт для запуска; каждый файл определяет субагента, которого Codex загружает из своих каталогов агентов.
Как установить и использовать этих субагентов?Склонируйте репозиторий, скопируйте нужные .toml-файлы в ~/.codex/agents/ (глобально) или .codex/agents/ (для проекта), затем перезапустите или обновите сессию Codex и явно обращайтесь к субагенту в промпте.
Нужно ли что-то ещё, кроме самого Codex?Достаточно уже настроенного Codex; при желании можно добавить конфигурацию маршрутизации агентов в секцию [agents] файла .codex/config.toml.
Codex сам выберет подходящего субагента?Нет, Codex не создаёт пользовательских субагентов автоматически, поэтому нужного субагента нужно явно указывать в промпте.
Влияет ли приоритет проекта/глобальных настроек на то, какой субагент запустится?Да, когда субагент уровня проекта и глобальный субагент носят одно имя, приоритет у проектного.
Как работает маршрутизация моделей для каждого субагента?В каждом .toml-файле есть поле model, направляющее его на один из трёх уровней: gpt-5.6-sol для глубоких рассуждений (например, security-auditor, architect-reviewer), gpt-5.6-terra для реализации и диагностики (например, docker-expert, test-automator) и gpt-5.6-luna для лёгких задач поиска/извлечения (например, search-specialist, agent-installer).
Как организованы субагенты?Они сгруппированы в 13 категорий, таких как Core Development, Language Specialists, Infrastructure, Quality & Security, Data & AI и Developer Experience, каждая со своим набором агентов.
Что такое sandboxmode и почему это важно?Каждый субагент задаёт поле sandboxmode, управляющее доступом к файловой системе: read-only для ревьюеров и аудиторов, которые только анализируют, и workspace-write для разработчиков и инженеров, которым нужно создавать или изменять файлы.
Можно ли выбирать, какие субагенты доступны в проекте, а какие глобально?Да, агентов можно хранить в .codex/agents/ для использования только в проекте или в ~/.codex/agents/ для доступа во всех проектах; при конфликте имён приоритет у агентов проекта.
Creator
VoltAgent
Size
0.1 MB
Stars
6.4K
Updated
CommitOct 05
Age
7mo
Commits · 90 Days