Skip to content
Back to search

codex-team

MarketplaceWorks with Claude CodeGitHub

Claude orchestrates OpenAI Codex agents

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/grosa787--codex-team/badge.svg)](/listings/grosa787--codex-team)

HTML

<a href="/listings/grosa787--codex-team"><img src="/api/listings/grosa787--codex-team/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

In Claude Code:

/plugin marketplace add grosa787/codex-team
/plugin install codex-team@codex-team

Or from a terminal:

claude plugin marketplace add grosa787/codex-team
claude plugin install codex-team@codex-team

The plugin loads in **new** sessions (agents and hooks register at session start). No restart of Claude Desktop is needed; just open a new session. If the repository is private, `git` must be authenticated for GitHub (for example `gh auth login`).

Check: in a new session, ask "which Codex models are available?" or run `bash "<plugin dir>/scripts/codex-job.sh" models`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 12 lines
  1. {
  2. "name": "codex-team",
  3. "owner": { "name": "grosa787" },
  4. "description": "Claude orchestrates OpenAI Codex agents",
  5. "plugins": [
  6. {
  7. "name": "codex-team",
  8. "source": "./",
  9. "description": "Claude plans, delegates and verifies; OpenAI Codex (your ChatGPT subscription) implements. Mixed Claude and Codex agents in one Workflow, live model catalog, per-task model routing, token accounting."
  10. }
  11. ]
  12. }
README.md · README · 110 lines
  1. # codex-team
  2. **English** · [Русский](README.ru.md)
  3. A Claude Code plugin that turns OpenAI Codex into worker agents under Claude. Claude is the architect and reviewer: it reads the project, splits the task, writes briefs, dispatches agents, checks every result itself and sends fixes back. Codex (or Claude subagents, or both mixed) does the implementation. Codex runs through your locally installed Codex CLI and your ChatGPT subscription, so no OpenAI API key is needed.
  4. ## Features
  5. - **Codex as a Claude agent.** `codex-team:codex-worker` takes a brief, runs `codex exec`, and returns Codex's report with a `THREAD_ID`. A follow-up with `THREAD_ID:` continues the same Codex session, so fixes keep their context.
  6. - **One Workflow, any mix of agents.** Plan (Claude) → Build in parallel waves (Codex or Claude executor → Claude review → fix round) → Integrate (Claude). Executors can be `codex`, `claude` or `mixed`; each agent shows up in the Workflow panel (Claude Code CLI and Claude Desktop) labelled with its model and reasoning level.
  7. - **Live model catalog.** Models and reasoning levels come from `codex debug models`, never from a hard-coded list. A new OpenAI model is usable as soon as your Codex CLI sees it. A session-start hook gives Claude the current list.
  8. - **Per-task routing.** You choose which Codex model and level serve simple, standard and complex tasks, and which models to avoid. Claude asks you on first use. The planner may override a default for a task that needs it and must say why; avoided models are rejected.
  9. - **New-model awareness.** When the catalog gains a model, Claude looks up prices and benchmarks, tells you, and asks whether to update the routing.
  10. - **Token accounting for Codex.** Every report has a `TOKENS` line; the Workflow logs tokens per agent and returns totals per model; `codex-job.sh usage` sums all runs.
  11. ## Requirements
  12. - [Claude Code](https://claude.com/claude-code) 2.1.275 or later (CLI or Claude Desktop).
  13. - [Codex CLI](https://github.com/openai/codex) in `PATH`, signed in with ChatGPT: `codex login status` → "Logged in using ChatGPT".
  14. - `jq`, `bash`, `git`.
  15. ## Install
  16. In Claude Code:
  17. ```
  18. /plugin marketplace add grosa787/codex-team
  19. /plugin install codex-team@codex-team
  20. ```
  21. Or from a terminal:
  22. ```bash
  23. claude plugin marketplace add grosa787/codex-team
  24. claude plugin install codex-team@codex-team
  25. ```
  26. The plugin loads in **new** sessions (agents and hooks register at session start). No restart of Claude Desktop is needed; just open a new session. If the repository is private, `git` must be authenticated for GitHub (for example `gh auth login`).
  27. Check: in a new session, ask "which Codex models are available?" or run `bash "<plugin dir>/scripts/codex-job.sh" models`.
  28. ## Use
  29. ### One-off, in plain words
  30. > Do this with Codex: add pagination to the orders API and cover it with tests.
  31. Claude uses `/codex-team:orchestrate`: it reads the project, splits the work into tasks with disjoint files, sends briefs to Codex workers in parallel, reads the real diffs, runs the checks, and returns problems to the same Codex thread.
  32. ### As a Workflow
  33. ```
  34. /codex-team:workflow
  35. Задача: what to build or change, with all requirements
  36. Папка: /absolute/project/path (default: current project)
  37. Проверка: npm test (default: planner finds one)
  38. Исполнители: codex | claude | mixed (default: codex)
  39. Codex: модель=<slug>, effort=<level> (default: your routing)
  40. Claude: модель=opus|sonnet|haiku|fable, effort=low|medium|high|xhigh|max
  41. Параллельно: 3 Правок: 2
  42. Ревью: sonnet (model for review agents)
  43. ```
  44. Every field except the task may be omitted. Free text is read as the task. The card is the same format Claude uses to launch the Workflow, so you and Claude speak the same language. Field names are Russian by design; the values and the rest are language-neutral.
  45. ### First run: routing
  46. If no routing exists, Claude asks which model and level to use per task tier and saves it to `~/.config/codex-team/routing.json`:
  47. ```bash
  48. bash "<plugin dir>/scripts/codex-job.sh" routing # show
  49. bash "<plugin dir>/scripts/codex-job.sh" routing --ack # mark current catalog models as known
  50. ```
  51. Example of a routing: simple → a cheap model, standard → a strong model at `high`, complex → the same model at `xhigh`; expensive models in `avoid`.
  52. ## Components
  53. | Component | Name | What it does |
  54. |---|---|---|
  55. | Agent | `codex-team:codex-worker` | Relays one brief to Codex, waits, returns the report and `THREAD_ID`. Brief lines: `THREAD_ID:`, `MODEL:`, `EFFORT:`, `SANDBOX:`. |
  56. | Skill | `/codex-team:orchestrate` | Claude as architect and reviewer over Codex workers. |
  57. | Skill | `/codex-team:workflow` | Runs `workflows/codex-team.js` from the launch card. |
  58. | Script | `scripts/codex-job.sh` | `start`, `wait`, `log`, `cancel`, `list`, `models`, `routing`, `usage`. Jobs live in `~/.cache/codex-team/jobs`. |
  59. | Hook | SessionStart | Injects the live model list and your routing into the session. |
  60. ### Workflow arguments
  61. `task`, `cwd` (absolute), `pluginRoot` are required, plus `routing` (the output of `codex-job.sh routing --json`) unless both `codexModel` and `codexEffort` are given. Optional: `check`, `executors`, `codexModel`, `codexEffort`, `claudeModel`, `claudeEffort`, `maxParallel` (3), `maxFixRounds` (2), `reviewModel`.
  62. Use it from your own workflow scripts:
  63. ```js
  64. await workflow({scriptPath: '<plugin dir>/workflows/codex-team.js'}, {task, cwd, pluginRoot, routing})
  65. // or mix agents directly
  66. agent(brief, {model: 'opus', effort: 'high'}) // Claude
  67. agent('MODEL: <slug>\nEFFORT: <level>\n' + brief, {agentType: 'codex-team:codex-worker'}) // Codex
  68. ```
  69. ## Notes and limits
  70. - Codex runs with the sandbox and approval settings from your `~/.codex/config.toml` unless a brief sets `SANDBOX:`. Check them before running on a project you care about.
  71. - Parallel workers share one working tree; the planner gives them disjoint files. For overlapping work use git worktrees.
  72. - Each Codex worker consumes your ChatGPT plan's Codex limits.
  73. - Claude Desktop's Workflow card shows no token counts; Codex tokens appear in the Workflow log, reports and `codex-job.sh usage`.
  74. - A Workflow started in a session that was opened before the plugin was installed still works (it reads the agent definition from disk); direct `Agent` calls to `codex-team:codex-worker` need a new session.
  75. ## License
  76. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.