Codex subagents
Codex subagents are separate roles with their own prompt that Codex hands part of a task to: reviews, tests, code search. Codex defines them as TOML files in .codex/agents. These are the top 30 by installs. The catalog keeps roles in Markdown, the Claude Code way: for Codex you move the role text into the developer_instructions field.
Ordered by install count from the source, then by repository stars on GitHub. A language model writes each description from the source file; only descriptions that passed the automatic check are listed.
-
1
40,905installs
frontend-developer
frontend-developer — a subagent for building complete frontend applications with React 18+, Vue 3+, and Angular 15+. Handles component architecture, state management, testing, and accessibility.
subagent · VoltAgent Community · MIT
-
2
31,050installs
code-reviewer · Anthropic official
code-reviewer reviews code changes against CLAUDE.md project rules and flags material defects. Run it before a commit or pull request.
subagent · Anthropic · Apache-2.0
-
3
31,050installs
code-reviewer · Anthropic official
The code-reviewer subagent checks code changes for bugs, security issues, and project-rule violations. Use it when a review should focus on findings that matter.
subagent · Anthropic · Apache-2.0
-
4
31,050installs
code-reviewer · VoltAgent Community
code-reviewer reviews code changes for bugs, security flaws and maintenance issues. Use it before merging complex work or auditing a project.
subagent · VoltAgent Community · MIT
-
5
27,069installs
ui-ux-designer
The ui-ux-designer subagent creates interfaces, wireframes, and design systems. Use it for user flows, accessibility work, and consistent UI patterns.
subagent · Seth Hobson · MIT
-
6
23,691installs
backend-architect
backend-architect — a subagent for backend design work: service boundaries, API paradigm choice, database schemas and observability. Useful when the decision comes before the first line of code.
subagent · davila7
-
7
16,078installs
prompt-engineer · Seth Hobson
The prompt-engineer subagent designs and tests prompts for LLM features, agent workflows, and system instructions. Use it when prompt structure, safety, or evaluation needs deliberate work.
subagent · Seth Hobson · MIT
-
8
8,999installs
architect-review
The architect-review subagent checks code changes against a project’s architecture and established patterns. Use it to review structural pull requests or assess a new service design.
subagent · davila7
-
9
406installs
Planner
Planner explores requirements and the codebase, then drafts an implementation plan without changing files. Use it when you want to map the work before coding starts.
subagent · microsoft · MIT
-
10
18,117installs
fullstack-developer
The fullstack-developer subagent carries a feature across the database, API, and frontend layers. Use it when one change needs a consistent end-to-end implementation.
subagent · VoltAgent Community · MIT
-
11
16,078installs
prompt-engineer · VoltAgent Community
The prompt-engineer subagent designs, tests, and improves prompts for LLM production systems. Use it when prompts need evaluation, metrics, or cost tracking.
subagent · VoltAgent Community · MIT
-
12
11,689installs
python-pro · Seth Hobson
python-pro — a subagent for modern Python 3.12+ development, async code, testing, APIs, and performance work. Use it when a project needs deeper Python guidance.
subagent · Seth Hobson · MIT
-
13
10,718installs
security-auditor · Anthropic official
security-auditor is a Claude Code subagent that performs adversarial security reviews on codebases. It inspects source trees for OWASP Top 10 risks, hardcoded secrets, and dependency CVEs.
subagent · Anthropic · Apache-2.0
-
14
9,715installs
test-engineer official
The test-engineer subagent captures legacy behavior in tests and compares it with a rewritten implementation. Use it before changing existing modules.
subagent · Anthropic · Apache-2.0
-
15
9,602installs
typescript-pro
typescript-pro — a subagent for advanced TypeScript types, strict checking, and architecture work. Use it when generics, inference, or decorators need careful design.
subagent · Seth Hobson · MIT
-
16
6,992installs
documentation-expert
The documentation-expert subagent creates, updates, and maintains project documentation, from README files to API references. Use it when docs need structure or a refresh.
subagent · davila7
-
17
6,870installs
task-decomposition-expert
task-decomposition-expert breaks down complex multi-step goals into a structured work breakdown structure with dependency graphs, effort estimates, and handoff plans.
subagent · davila7
-
18
13,459installs
debugger
debugger diagnoses software failures, reads stack traces, and isolates root causes to fix elusive bugs. Helpful when logs alone do not explain a crash.
subagent · VoltAgent Community · MIT
-
19
11,689installs
python-pro · VoltAgent Community
python-pro — a subagent for type-safe Python code across web APIs, system utilities, and complex applications. Use it when async patterns and broad type coverage matter.
subagent · VoltAgent Community · MIT
-
20
7,687installs
ai-engineer
The ai-engineer subagent designs LLM applications, RAG systems, and AI agents. Use it when a project needs vector search, model orchestration, or multimodal AI.
subagent · Seth Hobson · MIT
-
21
6,886installs
search-specialist
search-specialist — a web research subagent that filters sources and cross-checks facts. Use it for deep research, competitive analysis, and trend work.
subagent · Seth Hobson · MIT
-
22
6,052installs
mcp-expert
The mcp-expert subagent for Claude Code designs and configures Model Context Protocol servers, preparing JSON manifests for databases, APIs, and file access.
subagent · davila7
-
23
4,935installs
nextjs-architecture-expert
nextjs-architecture-expert — a Claude subagent for Next.js architecture: App Router, Server Components, Pages Router migration and performance work.
subagent · davila7
-
24
1,439installs
code-architect official
code-architect analyzes codebase patterns to produce architectural blueprints with file lists, component interfaces, data flows, and phased build sequences.
subagent · Anthropic · Apache-2.0
-
25
1,172installs
code-explorer official
code-explorer is a Claude Code subagent that traces how a feature works across an existing codebase. Invoke it to map an implementation before changing it.
subagent · Anthropic · Apache-2.0
-
26
10,718installs
security-auditor · VoltAgent Community
security-auditor audits security controls, vulnerabilities, risks, and compliance gaps across systems, infrastructure, and processes. Use it when you need documented findings.
subagent · VoltAgent Community · MIT
-
27
10,638installs
context-manager
context-manager organizes shared context for multi-agent projects in files, including state, task history, and decisions. Use it when agents need a clear shared workspace.
subagent · VoltAgent Community · MIT
-
28
4,974installs
javascript-pro
javascript-pro — a subagent for Claude Code, Codex and Cursor that handles modern JavaScript: ES6+ features, async patterns, event loop, Node.js and browser APIs. Triggers for JS optimization, async debugging and complex patterns.
subagent · Seth Hobson · MIT
-
29
4,060installs
seo-analyzer
seo-analyzer is a Claude Code subagent for technical SEO reviews and meta tag changes. It can be called to inspect site performance, page structure, and search optimization.
subagent · davila7
-
30
4,038installs
content-marketer
The content-marketer subagent plans content, SEO work, and channel distribution. Use it when an agent needs to research topics, shape campaigns, or adapt materials for several formats.
subagent · Seth Hobson · MIT
How to add a subagent to Codex
The catalog has 2,245 subagents that fit Codex. Codex reads roles from .codex/agents/ in the project and ~/.codex/agents/ for every project. The file is TOML with name, description and developer_instructions. Catalog roles are written in Markdown: name and description come from the frontmatter, and the file body goes into developer_instructions as is. You move it by hand; each card shows the path and a note.
The list matches Claude Code subagents: the roles are the same, only the file they go into differs. More for Codex: skills, plugins, MCP servers.
FAQ
Does Codex have subagents?
Yes. Codex defines a subagent as a TOML file in .codex/agents in the project or ~/.codex/agents for every project. The file has three fields: name, description and developer_instructions.
Do Claude Code subagents work in Codex?
The role does, the file does not: Claude Code uses Markdown in .claude/agents, Codex uses TOML. You move the role text from Markdown into developer_instructions by hand.
Which Codex subagents should I add first?
By installs, the list is led by frontend-developer, code-reviewer and code-reviewer. A subagent pays off on work that fits a separate context: reviews, tests, code search.
Other collections
- Best Claude Code skills
- Best Claude Code plugins
- Best Claude Code subagents
- Best Codex skills
- Best Cursor rules
- Best MCP servers
- MCP servers for Cursor
- Frontend skills
- Testing skills
- Security skills and rules
- SEO and marketing skills
- Design skills
- DevOps skills
- MCP servers for databases
- Browser and scraping MCP servers
- Code review and refactoring skills
- Skills and MCP for game development and 3D
- Video generation and editing skills
- Mobile development skills
- Backend and API skills
- Marketing skills and agents
- Scientific skills for AI agents
- UI/UX design skills
- Writing skills
- Claude Code hooks examples
- Claude Code slash commands
- Best Codex plugins
- GitHub Copilot agent skills
- Gemini CLI extensions and skills
- GitHub Copilot instructions
- MCP servers for Claude Code
- MCP servers for Codex
- MCP servers for VS Code
- Remote MCP servers
- Security MCP servers
- Office skills: slides, PDF, Word, Excel
- Data analysis skills
- Research skills
- Telegram AI agent tools
- 1C AI agent tools
- Cursor skills
- OpenCode skills
- Animation skills
- Presentation skills
- PDF skills
- Software architecture skills
- Planning and spec skills
- Debugging skills
- Audio, voice and music skills
- Branding and logo skills
- Humanizer and AI-text detector skills
- Game design skills
- Product management skills
- SwiftUI and iOS design skills
- HyperFrames skills
- Figma skills
- Blender skills
- Unity skills
- Godot skills