claude-agent-bridge

# claude-agent-bridge

MCP bridge for using local Claude CLI as a bounded reviewer and analysis delegate for Codex.

Goals

• Let Codex delegate small, bounded tasks to Claude.

• Keep Codex responsible for final decisions, file edits, commits, deploys, and verification.

• Redact sensitive-looking lines before sending context.

• Save Claude outputs for audit and follow-up review.

• Avoid mixing bridge infrastructure experiments into work repos.

Related MCP server: codex-claude-bridge

Tools

• claude_status: check delegation state.

• claude_set_enabled: enable or disable delegation.

• claude_ask: ask Claude for bounded analysis with optional files.

• claude_review_diff: ask Claude to review current git diff or selected paths.

• claude_read_result: read saved Claude output.

Local Checks

python -m py_compile scripts\claude_delegate.py mcp\claude_mcp_server.py
python -X utf8 -m json.tool .mcp.json
python -m unittest discover -s tests
python scripts\claude_delegate.py status --json

Plugin manifest validation uses the Codex plugin creator validator, which requires PyYAML in the active Python environment.

Actual Claude delegation may need to run outside the managed Codex sandbox:

python scripts\claude_delegate.py --task second-opinion --prompt "Reply with exactly: OK" --timeout-seconds 30 --json

Safety Rules

• Do not send secrets, tokens, webhooks, passwords, API keys, or tickets.

• Do not ask Claude to edit files, run live operations, commit, push, or deploy.

• Pass only the smallest useful diff, file excerpt, or log excerpt.

• Treat Claude output as review input, not authority.