cc-plugin-codex 0.1.4__py3-none-any.whl

cc_plugin_codex-0.1.4.dist-info/METADATA

@@ -0,0 +1,223 @@
+Metadata-Version: 2.4
+Name: cc-plugin-codex
+Version: 0.1.4
+Summary: Call Claude Code from Codex for bounded, independent code review and second opinions
+Project-URL: Homepage, https://github.com/briandconnelly/cc-plugin-codex
+Project-URL: Repository, https://github.com/briandconnelly/cc-plugin-codex
+Project-URL: Issues, https://github.com/briandconnelly/cc-plugin-codex/issues
+Project-URL: Changelog, https://github.com/briandconnelly/cc-plugin-codex/blob/main/CHANGELOG.md
+Project-URL: Security, https://github.com/briandconnelly/cc-plugin-codex/blob/main/SECURITY.md
+Author: Brian Connelly
+License-Expression: MIT
+License-File: LICENSE
+Keywords: claude,code-review,codex,mcp,plugin
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development
+Requires-Python: >=3.11
+Requires-Dist: anyio>=4
+Requires-Dist: fastmcp>=3.4
+Requires-Dist: pydantic>=2
+Description-Content-Type: text/markdown
+
+# cc-plugin-codex
+
+Ask Claude Code for an independent code review or second opinion, straight from Codex.
+
+`cc-plugin-codex` is review-only: Claude reviews, critiques, and advises. It does not edit
+your code, run shell commands, or get write tools. It is the mirror image of
+[`openai/codex-plugin-cc`](https://github.com/openai/codex-plugin-cc), which lets Claude call
+Codex.
+
+## Quickstart
+
+You need:
+
+- Codex
+- the `claude` CLI, installed and authenticated
+- `uvx`
+- `git`
+
+Check the basics:
+
+```sh
+claude --version
+claude /login
+uvx --version
+git --version
+```
+
+Add this repository as a Codex marketplace, then install the plugin from it:
+
+```sh
+codex plugin marketplace add briandconnelly/cc-plugin-codex
+codex plugin add cc-plugin-codex
+```
+
+Restart Codex after installing. Then ask Codex:
+
+> Ask Claude to run `claude_status`.
+
+`claude_status` is free. It checks whether the `claude` CLI is installed, authenticated, and
+compatible, and shows the defaults a paid call would use.
+
+## Distribution
+
+The Codex plugin install path is the primary user-facing path. The bundled MCP config pins the
+server to a versioned Git tag so installed users update deliberately.
+
+The Python package publishes the MCP server entry point for direct use and release provenance.
+After a PyPI release, the server can also be launched with:
+
+```sh
+uvx --from cc-plugin-codex==0.1.4 cc-plugin-codex-mcp
+```
+
+## Use it
+
+Once `claude_status` reports `ready: true`, ask Codex in plain language:
+
+> Ask Claude to review my current diff. Pass `workspace_root` as this repository.
+
+Passing `workspace_root` matters. It keeps reviews pointed at your project instead of the
+plugin install directory when the MCP client does not provide a repo root.
+
+Other useful prompts:
+
+- "Ask Claude to review my staged changes for security issues."
+- "Have Claude attack this plan for weaknesses."
+- "Get an independent second opinion from Claude on this design."
+- "Start a background Claude review of this branch against main."
+
+Codex uses the plugin skill to choose the right tool and arguments. Direct MCP calls are also
+available:
+
+| Tool | Use | Cost |
+| --- | --- | --- |
+| `claude_review_changes` | Review a git diff now | paid |
+| `claude_review_changes_async` | Start a background diff review | paid |
+| `claude_adversarial_review` | Pressure-test a plan, claim, or change | paid |
+| `claude_ask` | Ask for a free-form second opinion | paid |
+| `claude_status` | Check readiness and defaults | free |
+| `claude_review_dry_run` | Preview diff/context before a review | free |
+
+Diff review scopes are `working_tree`, `staged`, and `branch`.
+
+```json
+claude_review_changes({
+  "workspace_root": "/absolute/path/to/your/repo",
+  "scope": "staged",
+  "focus": "security"
+})
+```
+
+For a long review, launch it in the background:
+
+```json
+claude_review_changes_async({
+  "workspace_root": "/absolute/path/to/your/repo",
+  "scope": "branch",
+  "base": "main"
+})
+```
+
+Poll with `claude_job_status`, then fetch the result with `claude_job_result`.
+
+## Safety and cost
+
+- Paid tools run Claude and send code or prompts to Anthropic, billed through your existing
+  `claude` login or `ANTHROPIC_API_KEY`.
+- Free tools only inspect local state, preflight a request, or manage background jobs.
+- Claude never receives write or Bash tools from this plugin.
+- `access=toolless` is the default: Claude receives gathered context as text and cannot read
+  more files. `access=readonly` lets Claude use `Read`, `Grep`, and `Glob` for extra context.
+- Secret redaction is best-effort defense in depth. Use `access=toolless` when a workspace may
+  contain secrets.
+- `max_budget_usd` is a best-effort Claude CLI stop threshold, not a hard cap. Results report
+  actual spend in `meta.cost_usd` when available.
+- Reviews default to `effort=xhigh` for depth. Lower `effort` to `high` or `medium` for routine
+  reviews when cost matters.
+
+If a requested diff scope has no changes, the review tools return a passing result without
+invoking Claude.
+
+## Common knobs
+
+Every setting is optional. These are the knobs most users are likely to change:
+
+| Variable | Default | Purpose |
+| --- | --- | --- |
+| `CC_PLUGIN_CODEX_ACCESS` | `toolless` | `toolless` or `readonly` |
+| `CC_PLUGIN_CODEX_CLAUDE_CONFIG` | `inherit` | `inherit`, `scoped`, or `bare` |
+| `CC_PLUGIN_CODEX_EFFORT` | `xhigh` | `low`, `medium`, `high`, `xhigh`, or `max` |
+| `CC_PLUGIN_CODEX_MAX_BUDGET_USD` | `1.00` | best-effort per-call budget threshold |
+| `CC_PLUGIN_CODEX_MODEL` | unset | Claude model; unset uses the CLI default |
+| `CC_PLUGIN_CODEX_TIMEOUT_SECONDS` | `180` | per-call timeout, clamped to 10-600 seconds |
+| `ANTHROPIC_API_KEY` | unset | required only for `config_mode=bare` |
+
+Set these in the environment you launch Codex from. The bundled MCP config forwards the common
+cost, safety, model, timeout, and API-key variables to the server.
+
+`config_mode=inherit` uses your normal Claude environment without persisting a session.
+`scoped` drops user-global settings and user MCP servers but keeps `CLAUDE.md`. `bare` strips
+`CLAUDE.md`, memory, and hooks, and requires `ANTHROPIC_API_KEY`.
+
+## Troubleshooting
+
+Start with:
+
+> Ask Claude to run `claude_status`.
+
+Then:
+
+- If `claude_authenticated` is false, run `claude /login`.
+- If the workspace looks wrong, pass `workspace_root` explicitly.
+- If a review is large or expensive, run `claude_review_dry_run` first.
+- If a background job id is lost, use `claude_job_list`.
+- If `config_mode=bare` fails, confirm `ANTHROPIC_API_KEY` is set in the environment that
+  launches Codex.
+
+## Advanced reference
+
+Every tool returns a structured `ok`/`error` envelope. Paid results include usage metadata and
+cost when the Claude CLI reports it. The tool contract is experimental and pre-1.0; clients can
+pin `meta.fingerprint` to detect agent-visible changes.
+
+The Claude CLI compatibility assumptions are centralized in
+[`src/cc_plugin_codex/cli_contract.py`](./src/cc_plugin_codex/cli_contract.py) and documented
+in [`COMPATIBILITY.md`](./COMPATIBILITY.md).
+
+## Local development
+
+Run the MCP server from a checkout:
+
+```sh
+codex mcp add cc-plugin-codex -- uv run --directory "$(pwd)" cc-plugin-codex-mcp
+```
+
+Run tests:
+
+```sh
+uv run pytest
+```
+
+The full suite enforces a 95% coverage floor. For one-file iteration:
+
+```sh
+uv run pytest tests/test_jobs.py --no-cov
+```
+
+Live Claude integration tests are excluded by default:
+
+```sh
+uv run pytest -m integration --no-cov
+```
+
+They require the `claude` CLI and make a small paid API call.

cc_plugin_codex-0.1.4.dist-info/RECORD

@@ -0,0 +1,16 @@
+cc_plugin_codex/__init__.py,sha256=dRZubbvcfmBzE9dIqzdajurmT8w8vsiMPrsNv9iIIT8,166
+cc_plugin_codex/claude.py,sha256=xpCVX8Ylz0jmUx4tlX3WpjuMocA7r-7ofe86CtxOewo,10967
+cc_plugin_codex/cli_contract.py,sha256=oEdWV4PRSPyT8XKBE8cYJ8UflVirV33HtKc9LGVgxkw,5084
+cc_plugin_codex/config.py,sha256=AyjpFhYyKtrjn3xkmOpKdZLMVHgyekSgn6E8xbTecvs,6066
+cc_plugin_codex/context.py,sha256=ysFUt3bW9AoRdbXJYfQcnBRFzvvaoRINylx2lDvm0dk,7147
+cc_plugin_codex/jobs.py,sha256=qO9ezGeWfqMwt28ilDXs9ARtVMdN3xp-r2N4P-ZYvGw,19092
+cc_plugin_codex/normalize.py,sha256=HqOBaJOnJ_wicB0nZZ_6oxLkYUkwOokfPrf_UcAyOJU,8885
+cc_plugin_codex/preflight.py,sha256=DCjDrAMWh8TAu5ec_IsfBII_OT2Yh8ICJGv7C4oiMSo,3555
+cc_plugin_codex/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cc_plugin_codex/schemas.py,sha256=htzWVuRJiOh6-bMhONDoXigrgbQw4ZCJqUkqBDXVIPg,12233
+cc_plugin_codex/server.py,sha256=cPRCduRX6bcoCqW6gPhdeiFLddD7pKR19zRkps5zxtY,56665
+cc_plugin_codex-0.1.4.dist-info/METADATA,sha256=CDVzt-n9kxMPH3dNDir-cxWje37WbD3ty7z_DJ5v09U,7819
+cc_plugin_codex-0.1.4.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+cc_plugin_codex-0.1.4.dist-info/entry_points.txt,sha256=tZ2kvGG-lX8q1X3x_d1rJ1ikHalOpYYhiDHLPttlYy4,68
+cc_plugin_codex-0.1.4.dist-info/licenses/LICENSE,sha256=YaQJd4_ERECQwwGfgX3yGHhQt-dpLRCS_o2jlDxKjOs,1071
+cc_plugin_codex-0.1.4.dist-info/RECORD,,

cc_plugin_codex-0.1.4.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

cc_plugin_codex-0.1.4.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+cc-plugin-codex-mcp = cc_plugin_codex.server:main

cc_plugin_codex-0.1.4.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Brian Connelly
+
+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.