Skip to main content

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

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)

Source distribution for opencode-bridge 0.4.3
File Size Uploaded Provenance
opencode_bridge-0.4.3.tar.gz 87.5 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for opencode-bridge 0.4.3
File Interpreter ABI Platform
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page