explaingit

voltagent/awesome-codex-subagents

★ 4,631Audience · developerComplexity · 1/5Setup · easy

TLDR

A collection of 130+ ready-made TOML configuration files for OpenAI Codex subagents that handle specialized tasks like security review, database migrations, API docs, and language-specific code work.

Mindmap

mindmap
  root((Codex Subagents))
    Categories
      Security review
      Database work
      Testing
      Documentation
    Languages
      Go and Rust
      Python and Java
      Many others
    Features
      Model routing
      Read vs write agents
    Setup
      Clone repo
      Copy TOML files
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Add a security-audit subagent to your Codex sessions to automatically flag vulnerabilities in your code.

USE CASE 2

Delegate database migration writing to a purpose-built subagent instead of asking a general AI.

USE CASE 3

Mix language-specific agents for Go, Rust, Python, or Java to get expert-level review for each language in your codebase.

Tech stack

TOML

Getting it running

Difficulty · easy Time to first run · 5min

Requires OpenAI Codex access, setup is copying TOML files to your Codex agent directory.

In plain English

This repository is a curated collection of over 130 pre-built configuration files for Codex subagents. Codex is an AI coding tool from OpenAI, and subagents are specialized assistants within it that you can call on to handle specific tasks, such as reviewing code for security issues, writing database migrations, or drafting API documentation. Instead of a single AI trying to do everything, you delegate work to the subagent best suited for the job. Each subagent is defined in a small configuration file that describes the agent's role, which AI model it should use, and what instructions it follows. The files use the TOML format, which is a simple plain-text format similar to a settings file. You copy the ones you want into a specific folder on your computer, and Codex will recognize them as available agents in your sessions. The collection is organized into categories covering everyday coding work, language-specific expertise (Go, Rust, Python, Java, and many others), database work, quality and security review, infrastructure, documentation, testing, data engineering, and fintech. Each entry lists what the agent does and links to its configuration file. The repository includes a model routing system where each agent specifies whether to use a heavier, more thoughtful model for tasks like security audits or a faster lighter model for scanning and research. Agents are also marked as either read-only (they analyze but do not change files) or write-enabled (they can create and modify files). Installation requires cloning the repository and copying the desired configuration files into your Codex agent directory.

Copy-paste prompts

Prompt 1
Show me the TOML config for a Codex subagent that reviews code for security vulnerabilities and explain how to install it in my agent directory.
Prompt 2
I want a Codex subagent that writes database migrations. Which config from awesome-codex-subagents should I use and how do I set it up?
Prompt 3
Set up multiple Codex subagents so one handles code review and another handles writing tests, show me how to configure both and pick the right model for each.
Prompt 4
Which subagents in this collection are read-only versus write-enabled and when should I use each type?
Open on GitHub → Explain another repo

← voltagent on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.