Skip to main content
plugin CX Codex

ateam — Claude Code and Claude Code plugin: AI team roles, install

ateam turns Claude into a six-role team: researcher, PM, architect, dev, QA and reviewer, joined into a configurable pipeline.

MIT ★ 1,596 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install ateam@awesome-codex-plugins
Open on GitHub

What ateam does

Six roles, each with its own job. @Researcher digs through docs and earlier attempts, @Pm turns the goal into specs and an order of work, @Architect sketches the design and names the risks. Coding goes to @Dev, tests to @Qa, and @Reviewer checks correctness plus security. Summon one role by mention, or the whole group with @ATeam.

The pipeline is configurable: stages, routing to roles, isolation, verification, retries and resume from the last completed step. doctor, status and trace show what happened, and standups, reports and portable evidence bundles come along. Opt in and you also get schema-validated handoffs with SHA-256 provenance, decision logs, tripwires and scope audits.

On Claude you run the repo's install script, enable the plugin under Plugins > Local Plugins and restart Claude. Roles only show up if the project carries .codex/agents/*.toml; without that file set, mentions like @Architect stay unresolved until a new thread is opened.

What it helps with

  • take a feature from research to code review in one run
  • get a spec and an architecture pass before coding starts
  • keep a QA role that writes tests and catches regressions
  • resume a run from the last completed stage
  • pull a trace and evidence bundle to audit the run

Example prompts for the agent

  • Build the team for this project with @ATeam build my team.
  • Have @Architect review this API design and list the risks.
  • Hand the race condition in src/queue.py to @Dev and ask @Qa for a test that covers it.

How to install ateam

Plugin marketplace

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install ateam@awesome-codex-plugins

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about ateam

How do I install ateam in Claude Code?

Add the marketplace with /plugin marketplace add hashgraph-online/awesome-codex-plugins, then install the plugin: /plugin install ateam@awesome-codex-plugins.

What does ateam do?

It gives Claude six specialist roles (researcher, PM, architect, dev, QA, reviewer) that run as one pipeline, with configurable stages, verification and resume.

Why don't the @Architect and @Dev roles show up?

Check that the project contains .codex/agents/*.toml, then open a new thread or restart Claude so it reloads the workspace agents.

Source text

codex-agenteam · MIT
<p align="center">
  <img src="assets/agenteam-banner.png" alt="AgenTeam — Role-based AI team for Codex" width="100%">
</p>

<p align="center">
  <a href="https://github.com/yimwoo/codex-agenteam/releases"><img src="https://img.shields.io/github/v/release/yimwoo/codex-agenteam?color=2563EB&label=version&style=flat-square" alt="Version"></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-2563EB?style=flat-square" alt="MIT License"></a>
  <a href="https://github.com/yimwoo/codex-agenteam/stargazers"><img src="https://img.shields.io/github/stars/yimwoo/codex-agenteam?color=2563EB&style=flat-square" alt="Stars"></a>
  <a href="https://github.com/yimwoo/codex-agenteam/issues"><img src="https://img.shields.io/github/issues/yimwoo/codex-agenteam?color=2563EB&style=flat-square" alt="Issues"></a>
</p>

<p align="center">
  <strong>A full AI development team — researcher, PM, architect, dev, QA, and reviewer — as native Codex agents, orchestrated through a configurable pipeline.</strong>
</p>

---

## Quick Start

```bash
curl -fsSL https://raw.githubusercontent.com/yimwoo/codex-agenteam/main/install.sh | bash
```

Restart Codex, go to **Plugins > Local Plugins**, install AgenTeam, then:

```
@ATeam build my team
```

If the role picker does not show `@Architect`, `@Dev`, and the others right
away, confirm the project has `.codex/agents/*.toml`, then open a new thread
or restart Codex so it reloads workspace agents.

---

## Your Team

| Role | Mention | Job |
|------|---------|-----|
| Researcher | `@Researcher` | Investigates docs, trends, prior art |
| PM | `@Pm` | Prioritizes work, writes specs |
| Architect | `@Architect` | Designs systems, identifies risks |
| Dev | `@Dev` | Writes production code |
| Qa | `@Qa` | Writes tests, catches regressions |
| Reviewer | `@Reviewer` | Reviews for correctness and security |

```
@Architect review this API design
@Dev fix the race condition in src/queue.py
@ATeam add user authentication
```

---

## Documentation

- [**Setup & Installation**](docs/setup.md) — prerequisites, install, update
- [**Configuration**](docs/configuration.md) — roles, profiles, model routing, two-layer config
- [**Pipeline & Profiles**](docs/pipeline.md) — stages, gates, verification, resume, CI repair
- [**CLI Reference**](docs/cli.md) — all skills and runtime commands
- [**HOTL Integration**](docs/hotl.md) — structured execution with the HOTL plugin
- [**Benchmarking**](benchmarks/README.md) — reproducible strategy comparisons from run evidence

## Current Capabilities

- **Run control:** configurable stages, role routing, isolation, verification,
  retries, rework, gates, and resume.
- **Compatibility and observability:** `doctor`, `status`, `trace`, standups,
  reports, and portable evidence bundles.
- **Portable planning:** deterministic workspace-agent export plus
  evidence-backed benchmark conversion and reporting.
- **Structured handoffs:** opt-in schema-validated role results with SHA-256
  provenance, downstream prompt reuse, and trace/evidence metrics.
- **Governed delivery:** optional decision logs, tripwires, scope audits, and
  approval evidence for larger or longer-lived work.

These capabilities are additive. Quick fixes and standard pipelines remain
lightweight unless you enable structured handoffs or governed delivery.

---

## Contributing

Found a bug or have a role idea? [Open an issue](https://github.com/yimwoo/codex-agenteam/issues) or submit a PR.

## License

MIT © [Yiming Wu](https://github.com/yimwoo)

© Yiming Wu · MIT · hashgraph-online/awesome-codex-plugins

Similar plugins

All plugins for Agent setup: memory, context, orchestration →

From the same set391

The whole set →
codex-multi-auth codex-multi-auth is a Claude Code and Codex plugin for managing ChatGPT accounts used by the official Codex CLI. It switches accounts and checks their health. CX Codex ★ 1,596repo stars codex-howto codex-howto is a plugin for Claude Code and Codex with nine skills that take Codex tasks from scoping through tests and diff review to an evidence handoff. It takes work beyond code generation. CX Codex ★ 1,596repo stars codex-auto-resume codex-auto-resume monitors Codex usage limits on Windows, waits for the reset time, and automatically resumes the exact same conversation via codex queue. Built for overnight tasks. CX Codex ★ 1,596repo stars codex-agents-workflow codex-agents-workflow is a Claude Code plugin for building and running reusable agent workflows. It supports workflow setup with configurable roles and providers, plus recoverable runs. CX Codex ★ 1,596repo stars codetruss The codetruss plugin for Claude Code and Codex sets agent file boundaries, runs local analyzers on code changes, and creates signed review receipts. CX Codex ★ 1,596repo stars codebase-recon The codebase-recon plugin reads a repository’s Git history to map the project before you inspect its code. Use it to spot risky files, knowledge concentration, and shifts in team activity. CX Codex ★ 1,596repo stars clueless clueless is a plugin for Claude Code that makes the agent act as if nobody will review its work. It puts irreversible steps first and includes one check when you can't judge the result yourself. CX Codex ★ 1,596repo stars click click runs incremental test verification for Claude Code and Codex. Skips untouched checks, reruns affected code, and returns one-line receipts instead of full logs. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open