Skip to main content
NeVibeCode · collection · 30 · list updated

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. 1

    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

    40,905installs
  2. 2

    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

    31,050installs
  3. 3

    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

    31,050installs
  4. 4

    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

    31,050installs
  5. 5

    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

    27,069installs
  6. 6

    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

    23,691installs
  7. 7

    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

    16,078installs
  8. 8

    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

    8,999installs
  9. 9

    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

    406installs
  10. 10

    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

    18,117installs
  11. 11

    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

    16,078installs
  12. 12

    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

    11,689installs
  13. 13

    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

    10,718installs
  14. 14

    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

    9,715installs
  15. 15

    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

    9,602installs
  16. 16

    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

    6,992installs
  17. 17

    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

    6,870installs
  18. 18

    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

    13,459installs
  19. 19

    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

    11,689installs
  20. 20

    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

    7,687installs
  21. 21

    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

    6,886installs
  22. 22

    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

    6,052installs
  23. 23

    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

    4,935installs
  24. 24

    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

    1,439installs
  25. 25

    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

    1,172installs
  26. 26

    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

    10,718installs
  27. 27

    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

    10,638installs
  28. 28

    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

    4,974installs
  29. 29

    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

    4,060installs
  30. 30

    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

    4,038installs

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

Project sponsors

Companies that keep this analytics open