Skip to content

Commit c557d2a

Browse files
dguidoclaude
andauthored
Bundle codex-mcp-server into second-opinion plugin (#95)
Add .mcp.json to auto-start the codex-mcp-server when the plugin is installed, providing codex_ask, codex_exec, and codex_review MCP tools. The MCP tool descriptions are self-documenting — no separate skill docs needed. Bump version to 1.5.0. Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 9fb1ec1 commit c557d2a

File tree

6 files changed

+25
-5
lines changed

6 files changed

+25
-5
lines changed

.claude-plugin/marketplace.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -245,8 +245,8 @@
245245
},
246246
{
247247
"name": "second-opinion",
248-
"version": "1.4.0",
249-
"description": "Runs code reviews using external LLM CLIs (OpenAI Codex, Google Gemini) on uncommitted changes, branch diffs, or specific commits",
248+
"version": "1.5.0",
249+
"description": "Runs code reviews using external LLM CLIs (OpenAI Codex, Google Gemini) on uncommitted changes, branch diffs, or specific commits. Bundles codex-mcp-server for direct MCP tool access to Codex.",
250250
"author": {
251251
"name": "Dan Guido"
252252
},

.gitignore

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,3 +31,5 @@ build/
3131

3232
# MCP server config (contains API keys)
3333
.mcp.json
34+
# Allow plugin-bundled MCP configs (no secrets, just uvx commands)
35+
!plugins/**/.mcp.json

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -86,7 +86,7 @@ cd /path/to/parent # e.g., if repo is at ~/projects/skills, be in ~/projects
8686
| [gh-cli](plugins/gh-cli/) | Intercept GitHub URL fetches and redirect to the authenticated `gh` CLI |
8787
| [git-cleanup](plugins/git-cleanup/) | Safely clean up git worktrees and local branches with gated confirmation workflow |
8888
| [modern-python](plugins/modern-python/) | Modern Python tooling and best practices with uv, ruff, and pytest |
89-
| [second-opinion](plugins/second-opinion/) | Run code reviews using external LLM CLIs (OpenAI Codex, Google Gemini) on changes, diffs, or commits |
89+
| [second-opinion](plugins/second-opinion/) | Run code reviews using external LLM CLIs (OpenAI Codex, Google Gemini) on changes, diffs, or commits. Bundles codex-mcp-server. |
9090
| [workflow-skill-design](plugins/workflow-skill-design/) | Design patterns for workflow-based Claude Code skills with review agent |
9191

9292
### Team Management

plugins/second-opinion/.claude-plugin/plugin.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "second-opinion",
3-
"version": "1.4.0",
4-
"description": "Runs code reviews using external LLM CLIs (OpenAI Codex, Google Gemini) on uncommitted changes, branch diffs, or specific commits",
3+
"version": "1.5.0",
4+
"description": "Runs code reviews using external LLM CLIs (OpenAI Codex, Google Gemini) on uncommitted changes, branch diffs, or specific commits. Bundles codex-mcp-server for direct MCP tool access to Codex.",
55
"author": {
66
"name": "Dan Guido"
77
}

plugins/second-opinion/.mcp.json

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
{
2+
"mcpServers": {
3+
"codex-mcp-server": {
4+
"command": "uvx",
5+
"args": ["codex-mcp-server"]
6+
}
7+
}
8+
}

plugins/second-opinion/README.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -47,3 +47,13 @@ Inline arguments pre-fill the scope and focus, skipping redundant questions.
4747
## How It Works
4848

4949
Shells out to `codex review` and/or `gemini` CLI with high-capability model configurations. When both tools are selected (the default), runs Codex first then Gemini, presenting results side by side for comparison.
50+
51+
## Codex MCP Tools
52+
53+
This plugin bundles a [codex-mcp-server](https://github.com/trailofbits/codex-mcp) that auto-starts when the plugin is installed, providing three MCP tools:
54+
55+
- **codex_ask** — ask Codex a question inline, swapping in an OpenAI model mid-session
56+
- **codex_exec** — send a raw prompt to Codex with full control over the input
57+
- **codex_review** — review a git diff for bugs, security issues, and correctness
58+
59+
These tools work independently of the `/second-opinion` slash command. Use them when you want direct, programmatic access to Codex without the interactive prompt workflow.

0 commit comments

Comments
 (0)