Codex Agents/Subagents Library

A Codex-only library of 36 project-scoped custom subagents for software development, review, planning, design, DevOps, debugging, and Buffer content operations.

The agents live in .codex/agents/*.toml and follow the Codex custom agent schema: name, description, and developer_instructions, with role-based model, model_reasoning_effort, sandbox_mode, and nickname_candidates defaults.

Quick Start

1. Install and authenticate Codex.
2. Clone or open this repository at the project root.
3. Start Codex from this folder so it can load .codex/agents/ and .codex/config.toml.
4. Ask Codex to spawn a subagent explicitly:

Spawn python_expert to refactor this parser with type hints and pytest coverage.
Spawn security_auditor to review this branch for auth and input-validation risks.
Spawn orchestrator to plan a full-stack authentication feature and delegate specialist work.

Codex only spawns subagents when explicitly asked. The project config keeps direct child spawning enabled with max_depth = 1 and caps concurrent threads at max_threads = 6.

Agent Catalog

Orchestration

Agent	Description	Sandbox	Model
Orchestrator	Coordinates complex multi-agent software workflows and integrates specialist outputs.	workspace-write	gpt-5.4
Workflow Manager	Designs sequential and parallel execution workflows with dependencies, retries, and handoffs.	workspace-write	gpt-5.4
Project Manager	Plans sprints, backlogs, stakeholder updates, risks, and delivery milestones.	read-only	gpt-5.4

Full-Stack Development

Agent	Description	Sandbox	Model
Frontend Developer	Builds modern web interfaces with React, Vue, Angular, TypeScript, state management, and accessibility.	workspace-write	gpt-5.4-mini
Backend Developer	Builds APIs, authentication, authorization, validation, database access, and server-side business logic.	workspace-write	gpt-5.4-mini
Full-Stack Expert	Implements complete features across frontend, backend, database, tests, and integration boundaries.	workspace-write	gpt-5.4
Mobile Developer	Builds cross-platform and native mobile features with React Native, Flutter, iOS, and Android patterns.	workspace-write	gpt-5.4-mini
API Designer	Designs REST, GraphQL, OpenAPI contracts, versioning strategy, and API documentation.	workspace-write	gpt-5.4
Database Architect	Designs schemas, data models, indexes, migrations, and query optimization strategies.	workspace-write	gpt-5.4

Language Experts

Agent	Description	Sandbox	Model
Python Expert	Implements modern Python with type hints, pytest, async patterns, and framework best practices.	workspace-write	gpt-5.4-mini
JavaScript Expert	Implements modern JavaScript and TypeScript across React, Node.js, testing, and build tooling.	workspace-write	gpt-5.4-mini
Rust Expert	Implements Rust with ownership, borrowing, async, error handling, and performance-aware design.	workspace-write	gpt-5.4-mini
Go Expert	Implements idiomatic Go services with concurrency, interfaces, error handling, and testing.	workspace-write	gpt-5.4-mini
Java Expert	Implements Java and Spring Boot code with Maven or Gradle, JUnit, and enterprise patterns.	workspace-write	gpt-5.4-mini
SQL Expert	Writes and optimizes SQL queries, indexes, relational schemas, migrations, and execution plans.	workspace-write	gpt-5.4-mini

Testing & Quality

Agent	Description	Sandbox	Model
E2E Tester	Creates end-to-end tests with Playwright, Cypress, Selenium, page objects, and CI integration.	workspace-write	gpt-5.4-mini
A/B Test Ideas	Generates experiment hypotheses, variants, metrics, guardrails, and product test plans.	read-only	gpt-5.4-mini
Code Reviewer	Reviews changes for correctness, maintainability, regressions, security risk, and missing tests.	read-only	gpt-5.4
Security Auditor	Audits code and designs for OWASP risks, auth flaws, data exposure, and dependency issues.	read-only	gpt-5.4
Test Generator	Creates unit, integration, contract, and regression tests with appropriate mocks and coverage focus.	workspace-write	gpt-5.4-mini

Design & UI/UX

Agent	Description	Sandbox	Model
UI/UX Designer	Designs user flows, wireframes, interaction patterns, information architecture, and usability improvements.	workspace-write	gpt-5.4-mini
Figma to HTML	Converts Figma designs or screenshots into accessible HTML, CSS, React, and design tokens.	workspace-write	gpt-5.4-mini
Responsive Design	Improves mobile-first responsive layouts, breakpoints, touch targets, accessibility, and cross-browser behavior.	workspace-write	gpt-5.4-mini
Design System	Builds component libraries, design tokens, theming, accessibility standards, and usage documentation.	workspace-write	gpt-5.4-mini

Productivity

Agent	Description	Sandbox	Model
Enhanced Planner	Creates multi-step implementation plans with dependencies, milestones, risks, and success criteria.	read-only	gpt-5.4-mini
Research Agent	Researches technical options, documentation, tradeoffs, and current best practices with source citations.	read-only	gpt-5.4-mini
Task Breakdown	Breaks epics and large asks into stories, tasks, estimates, dependencies, and acceptance criteria.	read-only	gpt-5.4-mini
Doc Generator	Writes README files, API docs, architecture notes, migration guides, and user-facing documentation.	workspace-write	gpt-5.4-mini

DevOps

Agent	Description	Sandbox	Model
Docker Expert	Creates and reviews Dockerfiles, compose files, image optimization, build caching, and container security.	workspace-write	gpt-5.4-mini
Kubernetes Expert	Creates and troubleshoots Kubernetes manifests, Helm charts, scaling, networking, and RBAC.	workspace-write	gpt-5.4
CI/CD Expert	Builds CI/CD workflows for GitHub Actions, GitLab CI, test gates, deployment, and rollback.	workspace-write	gpt-5.4
Terraform Expert	Builds Terraform modules, state management, cloud resources, variables, outputs, and environment patterns.	workspace-write	gpt-5.4

Debugging

Agent	Description	Sandbox	Model
Debug Detective	Investigates errors, stack traces, logs, failure modes, and likely root causes.	read-only	gpt-5.4
Performance Optimizer	Finds bottlenecks and improves runtime, queries, memory, bundle size, and latency.	read-only	gpt-5.4
Legacy Modernizer	Plans and executes incremental modernization, refactors, migrations, and technical debt reduction.	workspace-write	gpt-5.4

Integrations

Agent	Description	Sandbox	Model
Buffer API Expert	Automates Buffer GraphQL workflows for social posting, scheduling, retrieval, editing, analytics, and campaigns.	workspace-write	gpt-5.4-mini

Validation

./scripts/validate-agents.sh

The validator checks that all 36 TOML files parse, use required Codex fields, match underscore filenames, avoid legacy fields, and use supported model/sandbox settings.

Documentation

• Getting Started
• Create Custom Codex Subagents
• Agent Guide
• Examples
• Orchestration Patterns
• Best Practices
• Troubleshooting
• Testing
• Contributing

License

MIT. See LICENSE.