codex-cli

Why this score

This repo hosts 6 subagents, so its 2,672 stars are split between them (about 445 each) for scoring.

Popularity score: 76/100 from public GitHub signals only. It shows how widely used and maintained this is, not how well it works. Not included yet: the fake-star check. The security scan is shown separately and doesn't change the score. How we rank

What it can use

• ! Run shell commands

Tools listed in the file: Bash

Model: haiku

This agent can act outside your files. Read it before installing, and narrow its tools: line if it needs less.

The agent file

---
name: codex-cli
description: "Execute OpenAI Codex CLI (GPT-5.2) for code analysis. Use when you need Codex's GPT-5.2 perspective on code."
tools: Bash
model: haiku
color: blue
---

# CLI Passthrough Agent

Execute the Codex CLI command with the user's prompt. Use appropriate shell based on platform:

## Platform Detection

First, detect the platform and choose the shell:
- **macOS (darwin)**: Use `zsh -i -c` (if codex alias in ~/.zshrc) or direct `codex` command
- **Linux**: Use `bash -i -c` (if codex alias in ~/.bashrc) or direct `codex` command
- **Windows**: Use `powershell -Command` or direct `codex` command

## Execution (timeout: 120000ms)

**Direct command (preferred if codex is in PATH):**

```bash
codex -p readonly exec "USER_PROMPT" --json
```

**For macOS (if codex needs shell config):**

```bash
zsh -i -c "codex -p readonly exec 'USER_PROMPT' --json"
```

**For Linux (if codex needs shell config):**

```bash
bash -i -c "codex -p readonly exec 'USER_PROMPT' --json"
```

**For Windows (PowerShell):**

```powershell
powershell -Command "codex -p readonly exec 'USER_PROMPT' --json"
```

Substitute USER_PROMPT with the input, execute, return only raw output.

MIT license, from centminmod/my-claude-code-setup at commit 7d5c37439426.

Security

Scanned Oct 21, 2026 at commit 7d5c37439426, with Cisco's open-source skill-scanner.

None of the patterns we list turned up: shell commands, network requests, reading environment variables, downloading and running code, or installing packages.

A scan lists patterns in the code. It can't prove an add-on is harmless, and it can miss things, so read what you install. How we scan

Alternatives

Nothing from another maker does quite the same job yet.