OpenCode Bridge
MCP server for continuous discussion sessions with OpenCode. Collaborate with GPT-5, Claude, Gemini, and other models through Claude Code.
Quick Start
# 1. Install
uv pip install git+https://github.com/genomewalker/opencode-bridge.git
# 2. Register with Claude Code
opencode-bridge-install
# 3. Use in Claude Code
# The tools are now available - Claude will use them automatically
Features
- Continuous sessions: Conversation history persists across messages
- Multiple models: Access all OpenCode models (GPT-5.x, Claude, Gemini, etc.)
- Agent support: plan, build, explore, general agents
- Variant control: Set reasoning effort (minimal → max)
- File attachment: Share code files for review
- Session continuity: Conversations continue across tool calls
Installation
With uv (recommended)
uv pip install git+https://github.com/genomewalker/opencode-bridge.git
With pip
pip install git+https://github.com/genomewalker/opencode-bridge.git
From source
git clone https://github.com/genomewalker/opencode-bridge.git
cd opencode-bridge
pip install -e .
Register with Claude Code
# Install (registers MCP server)
opencode-bridge-install
# Verify
claude mcp list
# Uninstall
opencode-bridge-uninstall
Available Models
| Provider | Models |
|---|---|
| openai | gpt-5.2-codex, gpt-5.1-codex-max, gpt-5.1-codex-mini |
| github-copilot | claude-opus-4.5, claude-sonnet-4.5, gpt-5, gemini-2.5-pro |
| opencode | gpt-5-nano (free), glm-4.7-free, grok-code |
Run opencode models to see all available models.
MCP Tools
| Tool | Description |
|---|---|
opencode_start |
Start a new session |
opencode_discuss |
Send a message |
opencode_plan |
Start planning discussion |
opencode_brainstorm |
Open-ended brainstorming |
opencode_review |
Review code |
opencode_models |
List available models |
opencode_agents |
List available agents |
opencode_model |
Change session model |
opencode_agent |
Change session agent |
opencode_variant |
Change reasoning effort |
opencode_config |
Show current configuration |
opencode_configure |
Set defaults (persisted) |
opencode_history |
Show conversation history |
opencode_sessions |
List all sessions |
opencode_switch |
Switch to another session |
opencode_end |
End current session |
opencode_health |
Server health check |
Configuration
Environment variables
export OPENCODE_MODEL="openai/gpt-5.2-codex"
export OPENCODE_AGENT="plan"
export OPENCODE_VARIANT="medium"
Config file
~/.opencode-bridge/config.json:
{
"model": "openai/gpt-5.2-codex",
"agent": "plan",
"variant": "medium"
}
Variants (reasoning effort)
minimal → low → medium → high → xhigh → max
Higher variants use more reasoning tokens for complex tasks.
Requirements
- Python 3.10+
- OpenCode CLI installed
- Claude Code
License
MIT
Metadata
Release files for opencode-bridge 0.4.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| opencode_bridge-0.4.3.tar.gz | 87.5 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| opencode_bridge-0.4.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 106.1 kB
Release files / opencode_bridge-0.4.3.tar.gz
| Download URL | opencode_bridge-0.4.3.tar.gz |
|---|---|
| Size | 87.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
37d5defdba8e18a3419f498507412fd56df371c13285cd92e90d24578f88f835
|
|
BLAKE2b-256 checksum How to use checksums |
0b34b7010ef56e1cfcd9f2cf55426bf681ddc8b62ce2f92b4f5ccf7dde11708e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.12
|
Release files / opencode_bridge-0.4.3-py3-none-any.whl
| Download URL | opencode_bridge-0.4.3-py3-none-any.whl |
|---|---|
| Size | 18.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
be5f76a01e5d4e43bdf8397e6f7fc1aeadb9d16aea99410692635a27a5cdb46d
|
|
BLAKE2b-256 checksum How to use checksums |
0bef8b1c4566f5076c508a498c2e0fe006dbd1d2f3894ce4c4900e2f0cd08084
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.12
|
Security for opencode-bridge 0.4.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.