Practical overview
When it fits
Use it when a Codex workflow needs more specialized agent definitions than a single general coding assistant provides, particularly when agents should be scoped globally or to an individual repository.
Who it is for
- Developers using Codex who need specialized task-oriented subagents.
- Teams organizing reusable coding-agent definitions across projects.
- Builders creating a focused Codex workflow from categorized agent components.
Documented uses
- Discover specialized Codex subagents for development tasks.
- Copy selected agent definitions into Codex’s global or project-specific directories.
- Create a project-specific set of subagents from the collection.
- Use categorized entries as material for a coding-agent discovery interface.
Requirements & limits
The repository is publicly accessible on GitHub and identified as MIT-licensed. The documented setup uses Codex custom-agent directories; no pricing or account requirement is established in the available evidence.
- It is a curated collection, not a hosted runtime or standalone application.
- The documented format is Codex-native
.toml. - Global agents use
~/.codex/agents/, while project-specific agents use.codex/agents/and have higher precedence. - Custom subagents must be delegated explicitly rather than being automatically spawned.
- The evidence documents setup and storage paths but not a complete assembled assistant or general integration compatibility.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Add selected subagents to Codex
Set up chosen repository agent definitions in a global or project-specific Codex agent directory.
Before you start
- A Codex environment with custom agent directories supported.
- A cloned copy of the repository.
- Selected
.tomlagent files. - Use
~/.codex/agents/for global agents or.codex/agents/for project-specific agents.
Steps
Clone the repository.
Copy the selected
.tomlfiles into~/.codex/agents/for global availability or.codex/agents/for the current project.Refresh or restart the Codex session if needed.
Delegate to the selected subagent explicitly in prompts.
Expected outcome
Selected subagent definitions are placed in the documented Codex locations for use in the relevant scope.
Guide limitations
- The repository documentation states that Codex does not auto-spawn custom subagents.
- The evidence does not demonstrate a completed assistant assembly or provide broader integration requirements.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 2 October 2026
- Original website title
- VoltAgent/awesome-codex-subagents · Official homepage title · retained in its source language

