feat: initial cc plugin codex release

Author: pejmanjohn

.agents/plugins/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "cc-plugin-codex-marketplace",
+  "interface": {
+    "displayName": "CC Plugin Codex Marketplace"
+  },
+  "plugins": [
+    {
+      "name": "claude-companion",
+      "source": {
+        "source": "local",
+        "path": "./claude"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Coding"
+    }
+  ]
+}

.github/workflows/pull-request-ci.yml

@@ -0,0 +1,34 @@
+name: Pull Request CI
+
+on:
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  ci:
+    name: CI
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+      - name: Set up Node.js
+        uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Install Codex CLI
+        run: |
+          npm install --global @openai/codex
+          codex --version
+
+      - name: Run Claude plugin test suite
+        run: npm run test:claude

.github/workflows/release.yml

@@ -0,0 +1,62 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+      - name: Set up Node.js
+        uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Verify tag matches package and plugin versions
+        env:
+          TAG_NAME: ${{ github.ref_name }}
+        run: |
+          node --input-type=module <<'EOF'
+          import { readFileSync } from 'node:fs';
+
+          const expected = process.env.TAG_NAME.replace(/^v/, '');
+          const packageVersion = JSON.parse(readFileSync('package.json', 'utf8')).version;
+          const pluginVersion = JSON.parse(readFileSync('claude/.codex-plugin/plugin.json', 'utf8')).version;
+
+          if (packageVersion !== expected) {
+            throw new Error(`package.json version ${packageVersion} does not match tag ${expected}`);
+          }
+
+          if (pluginVersion !== expected) {
+            throw new Error(`plugin.json version ${pluginVersion} does not match tag ${expected}`);
+          }
+          EOF
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Install Codex CLI
+        run: |
+          npm install --global @openai/codex
+          codex --version
+
+      - name: Run Claude plugin test suite
+        run: npm run test:claude
+
+      - name: Create GitHub release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          TAG_NAME: ${{ github.ref_name }}
+        run: gh release create "$TAG_NAME" --generate-notes --title "$TAG_NAME"

.gitignore

@@ -0,0 +1,6 @@
+node_modules/
+docs/
+dist/
+coverage/
+.DS_Store
+*.log

CONTRIBUTING.md

@@ -0,0 +1,23 @@
+# Contributing
+
+Contributions are welcome.
+
+## Development
+
+```bash
+npm ci
+npm run test:claude
+```
+
+## Expectations
+
+- Keep the plugin Codex-native.
+- Preserve honest positioning around the current installed-plugin hook limitation.
+- Add or update tests for behavior changes.
+- Avoid disturbing unrelated worktree changes.
+
+## Pull Requests
+
+- Keep changes focused.
+- Include verification notes in the PR description.
+- Update docs when behavior, install steps, or user-visible positioning changes.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pejman Pour-Moezzi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

PRIVACY.md

@@ -0,0 +1,26 @@
+# Privacy Policy
+
+CC Plugin Codex is an open-source local plugin. The repository maintainers do not operate a hosted service for this project and do not intentionally collect telemetry from your local use of the plugin.
+
+## What This Project Does
+
+The plugin runs on your machine and can invoke local Codex and Claude CLI tooling. Any prompts, code, logs, or metadata handled by those tools are governed by the policies and settings of those tools and services, not by this repository alone.
+
+## Data We Receive
+
+Project maintainers may receive information you choose to send through:
+
+- GitHub issues
+- pull requests
+- security reports
+- other direct maintainer contact
+
+That information is processed through GitHub and any other platform you use to contact maintainers.
+
+## Third-Party Services
+
+If you use Codex, Claude, GitHub, or other external services with this plugin, their privacy policies apply to the data you send through them.
+
+## Changes
+
+This document may change as the project evolves. Material updates should be made in the repository history.

README.md

@@ -0,0 +1,111 @@
+# CC Plugin Codex
+
+Use Claude from inside Codex for code reviews or to delegate tasks to Claude Code.
+
+This repository is the source for the Codex-native Claude Companion plugin bundle. It is meant to be a reverse port of [`openai/codex-plugin-cc`](https://github.com/openai/codex-plugin-cc): the original brings Codex into Claude Code, while this project brings Claude-backed review and delegation workflows into Codex.
+
+The installable plugin bundle lives under [`claude/README.md`](./claude/README.md).
+
+## What You Get
+
+- `$claude-review` for a normal read-only Claude review from Codex
+- `$claude-adversarial-review` for a steerable challenge review
+- `$claude-rescue`, `$claude-status`, `$claude-result`, and `$claude-cancel` to delegate and manage longer-running Claude tasks
+- `$claude-setup` to verify Claude Code readiness and report the current review-gate limitation honestly
+
+## Requirements
+
+- Codex with plugin support
+- Claude Code installed and available as `claude`
+- Node.js 18.18 or later for development and tests
+
+## Install
+
+```bash
+git clone https://github.com/pejmanjohn/cc-plugin-codex.git
+cd cc-plugin-codex
+./scripts/install.sh
+```
+
+The installer uses Codex's official `plugin/install` backend against this repo's local marketplace file, so you do not need to edit any Codex marketplace configuration by hand.
+
+## Verify
+
+Open Codex:
+
+```bash
+codex
+```
+
+If you normally use the Codex Mac app and it is already open, restart it instead.
+
+Then start a new thread and run:
+
+```text
+$claude-setup
+```
+
+After install, you should see the bundled Claude Companion skills in Codex. The full bundle-level usage guide lives in [`claude/README.md`](./claude/README.md).
+
+## Update
+
+```bash
+git pull
+./scripts/install.sh
+```
+
+## Uninstall
+
+```bash
+./scripts/uninstall.sh
+```
+
+## Usage
+
+### `$claude-review`
+
+Runs a normal read-only Claude review on your current work or against a base ref.
+
+### `$claude-adversarial-review`
+
+Runs a more skeptical review that questions implementation choices, tradeoffs, and failure modes.
+
+### `$claude-rescue`
+
+Delegates a foreground or background task to Claude and stores durable job state for follow-up.
+
+### `$claude-status`, `$claude-result`, `$claude-cancel`
+
+Shows running and recent jobs, returns the stored final output, or cancels an active background task.
+
+### `$claude-setup`
+
+Checks whether Claude Code is installed and usable, and reports the current stop-time review-gate limitation.
+
+## Current Limitation
+
+The plugin is usable today, but it is not fully functionally equivalent to `openai/codex-plugin-cc`.
+
+The missing piece is the automatic stop-time review gate. Codex supports repo-level and user-level hooks, but validated installed-plugin runs still did not execute bundled plugin hooks after official install, so this plugin reports that limitation honestly instead of pretending the gate works.
+
+## Releases
+
+This repo uses simple tag-based releases.
+
+- Keep [`package.json`](./package.json) and [`claude/.codex-plugin/plugin.json`](./claude/.codex-plugin/plugin.json) on the same semantic version.
+- Create a tag like `v0.1.0`.
+- Push the tag to GitHub.
+
+The release workflow will verify the tag matches both version files, run the Claude plugin test suite, and publish a GitHub release with generated notes.
+
+## Development
+
+```bash
+npm ci
+npm run test:claude
+```
+
+Helpful files:
+
+- [`claude/README.md`](./claude/README.md)
+- [`claude/.codex-plugin/plugin.json`](./claude/.codex-plugin/plugin.json)

SECURITY.md

@@ -0,0 +1,15 @@
+# Security Policy
+
+If you believe you have found a security issue in CC Plugin Codex, please avoid posting sensitive details in a public issue.
+
+## Reporting
+
+Prefer GitHub's private security reporting features if they are enabled for this repository. If private reporting is unavailable, contact the repository owner directly through GitHub before disclosing details publicly.
+
+## Scope
+
+This project invokes third-party tooling such as Codex and Claude CLI. Issues in those upstream tools may need to be reported to their respective maintainers.
+
+## Response
+
+Best-effort triage will be provided, but no response-time guarantee is offered.

TERMS.md

@@ -0,0 +1,23 @@
+# Terms of Use
+
+CC Plugin Codex is provided under the MIT License and is made available on an "as is" basis, without warranties or guarantees.
+
+## Use At Your Own Risk
+
+You are responsible for:
+
+- reviewing the plugin before using it in your environment
+- complying with the terms of Codex, Claude, GitHub, and any other services you connect
+- monitoring usage limits, pricing, and data handling for external tools the plugin invokes
+
+## No Service Commitment
+
+This repository is an open-source project, not a managed service. Maintainers may change, pause, or discontinue development at any time.
+
+## No Warranty
+
+To the maximum extent permitted by law, the maintainers disclaim warranties of merchantability, fitness for a particular purpose, non-infringement, and uninterrupted availability.
+
+## Liability
+
+The maintainers are not liable for damages, data loss, outages, security incidents, or costs arising from use of the project.