chatgpt-agent — Claude Code plugin: what it does, how to install
chatgpt-agent is a Claude Code and Codex plugin that brings ChatGPT into review, planning, editing, and implementation tasks. It uses ZIP, MCP, or GitHub access.
MIT ★ 1,596 updated 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install chatgpt-agent@awesome-codex-pluginsWhat chatgpt-agent does
chatgpt-agent sends a bounded slice of project context to ChatGPT and brings back an answer or a change set. Its roles split the work by outcome: reviewer checks code, research, or claims; advisor compares options and plans; editor revises prose; implementer changes software within the selected route's permissions.
ZIP is the default route and needs no MCP setup. MCP gives ChatGPT access to one configured local workspace through a Connector, while the GitHub route works with an authorized branch or pull request. Installing the plugin does not fetch or start the MCP Bridge; $chatgpt-agent-setup configures it. The Bridge can use a Cloudflare Named Tunnel, a Quick Tunnel, or an existing HTTPS endpoint. ChatGPT or Cloudflare sign-in may require user participation. Python helpers use the standard library and do not need pip packages.
What it helps with
- review code changes for correctness and regressions
- compare migration options and produce a bounded plan
- revise a document while preserving its authorial voice
- apply a source-code change through an authorized route
Example prompts for the agent
- Review these changes for correctness and regressions.
- Compare the migration options and recommend a bounded plan.
- Edit
docs/guide.mdfor a first-time user.
How to install chatgpt-agent
Plugin marketplace
/plugin marketplace add hashgraph-online/awesome-codex-plugins/plugin install chatgpt-agent@awesome-codex-pluginsStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about chatgpt-agent
How do I install chatgpt-agent in Claude Code?
Add the marketplace with /plugin marketplace add hashgraph-online/awesome-codex-plugins, then install the plugin with /plugin install chatgpt-agent@awesome-codex-plugins.
What does chatgpt-agent do?
It puts ChatGPT into a Codex workflow for code and content review, planning, document editing, or implementation. The source can come through a ZIP packet, an MCP workspace, or an authorized GitHub route.
What does chatgpt-agent need to work?
ZIP mode does not require MCP. Local MCP access needs a configured Bridge and Connector, using a Cloudflare Named Tunnel, Quick Tunnel, or managed HTTPS endpoint; ChatGPT or Cloudflare sign-in may require user participation.
Source text
chatgpt-review-agent-skill · MIT
# ChatGPT Agent for Codex [English](README.md) | [简体中文](README.zh-CN.md) > Four focused roles. Three clear routes. Keep ChatGPT connected to the work in Codex. Use ChatGPT as a **reviewer, advisor, editor, or implementer** in your Codex workflow. Send a bounded ZIP packet when that is enough, connect a local workspace with MCP when you want direct access, or work against an authorized GitHub ref. ## Work with the right role and route - **Configure MCP with the setup Skill.** It prepares the Bridge runtime and platform prerequisites, then configures one Bridge and Connector for the selected workspace. Choose a Cloudflare Named Tunnel when you have a Cloudflare-managed domain; without one, use a Quick Tunnel that updates the same workspace Connector when its address changes. - **Choose a role for the task.** Get review and verification, reasoning and planning, prose editing, or software implementation from focused role instructions. - **Choose a route for the source.** Use ZIP for local files without MCP setup, MCP for direct access to one configured workspace, or the authorized GitHub route for a remote repository or PR. ZIP and MCP remain independent choices; neither silently switches to the other. ## Install Add the Codex marketplace and install the plugin: ```bash codex plugin marketplace add TohmaN233/chatgpt-review-agent-skill codex plugin add chatgpt-agent@chatgpt-agent ``` In the Codex app, open **Plugins → Add Marketplace**, enter `TohmaN233/chatgpt-review-agent-skill`, then install **ChatGPT Agent**. Start a new chat after installation. Plugin installation adds its packaged Skills and resources. It does not download or start the MCP Bridge. Start with `$chatgpt-agent-setup`; ZIP is the default, and MCP is configured only when you explicitly choose it. To install the Skills separately with the Skills CLI, run: ```bash npx skills add TohmaN233/chatgpt-review-agent-skill --skill chatgpt-agent --skill chatgpt-agent-setup ``` From a local checkout, `setup.cmd` on Windows and `bash setup.sh` on macOS/Linux install only the Skills. The Python helpers use only the Python standard library; they require no `pip` packages or Python lockfile. ## Choose a role | Role | Use it to… | | --- | --- | | `reviewer` | Find actionable issues in code, research, or writing; verify claims and acceptance criteria against evidence. | | `advisor` | Answer a reasoning question, compare options, or build a bounded plan. | | `editor` | Revise prose and documents while preserving the author's intent and voice. | | `implementer` | Change software behavior or source code within the selected route's write permissions. | Examples: ```text $chatgpt-agent Review these changes for correctness and regressions. $chatgpt-agent Compare the migration options and recommend a plan. $chatgpt-agent Edit docs/guide.md for a first-time user. $chatgpt-agent Implement the requested change and report what you verified. ``` ## Choose a route | Route | Best for | Access and output | | --- | --- | --- | | **ZIP** (default) | A local task that can be answered from selected files | Codex builds a bounded packet and sends it to ChatGPT. No MCP or Connector setup is needed. ChatGPT can return an answer or patch; Codex applies local changes. Works with ChatGPT Pro models when included in your subscription. | | **MCP** (opt in) | Direct ChatGPT access to one local workspace | A workspace Connector reads local files. Sessions start read-only; requested report or source writes need the appropriate task-scoped grant. ZIP remains available for other tasks. | | **GitHub (beta)** | A remote repository, branch, or PR | Uses the authorized GitHub host integration and a pinned source revision. Review is read-only; implementation targets an authorized task branch. | For MCP, the setup Skill prepares the Bridge package and missing prerequisites. If you have a Cloudflare-managed domain, choose a Named Tunnel for a stable address. If you do not, choose a Quick Tunnel; when its address changes after a restart, setup updates that workspace's existing Connector. A user-managed HTTPS endpoint can also be reused. ChatGPT or Cloudflare sign-in may require your participation. ## How the roles and routes fit together Choose the role by the result you want and the route by where the evidence lives. The reviewer can review a ZIP packet, the configured local workspace, or a GitHub PR. The advisor can reason over a packet or plan from local/GitHub evidence. The editor and implementer can return bounded patches in ZIP mode or make authorized changes through MCP or a GitHub task branch. ## More - [ZIP packet workflow](docs/workflows/PACKET.md) - [MCP local workspace tasks](docs/workflows/LOCAL.md) - [GitHub routes](docs/workflows/GITHUB.md) - [MCP setup](docs/setup/ONE_COMMAND.md) - [Route model](docs/ROUTE_MODEL.md) MIT License · Maintained by [@TohmaN233](https://github.com/TohmaN233).
© TohmaN233 · MIT · hashgraph-online/awesome-codex-plugins