RadarTopicsBuildersWeeklyReads
Open Source Radar
VoltAgent/

awesome-codex-subagents

GitHubWebsite

A large collection of Codex subagents organized into categories, with installation guidance and TOML-based configurations for Codex agents. The repo claims 171+ subagents across 13 categories, tracked with MIT license and active maintenance as of 2026-07-10.

5.9kstars
646forks
6issues
MITlicense
2026since
Star historydaily snapshots by VibeCrowd

Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).

Alternatives & relatedmatched by topic overlap
Reviewgenerated from repository data · Aug 5, 2026

What it is

The repository is a collection of Codex Subagents, specialized AI assistants intended for development tasks. It documents a structure where each subagent uses a Codex-native .toml format and includes a model routing scheme and sandbox modes. It also provides how-to instructions for using Codex custom agent directories.

How it works

Subagents are defined as individual .toml files containing name, description, model, model_reasoning_effort, sandbox_mode, and an [instructions] text block. A model field routes to either gpt-5.4 or gpt-5.3-codex-spark depending on the task (deep reasoning vs fast scanning). Sandbox_mode controls filesystem access with read-only or workspace-write options.

Getting started

Installation steps are provided:

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 show copying specific agent TOML files into ~/.codex/agents or .codex/agents and the corresponding directory setup commands:

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 using agent configuration in Codex, place it in .codex/config.toml under [agents] as described in the official docs.

Recent releases

RELEASES (latest 0):

  • none

Traction

Stars: 5912 Forks: 646 Open issues: 6

Behind the repo

Linked to VoltAgent organization; sponsors section mentions Ego Lite sponsorship details, but no external startup/company link beyond organization and sponsor references.

Caveats

License: MIT Created: 2026-03-17 Last push: 2026-07-10 Languages: -

SharePost on XLinkedIn
All trending reposRevenue-verified startups →