Skip to main content

MCP server for continuous OpenCode discussion sessions

Project description

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)

minimallowmediumhighxhighmax

Higher variants use more reasoning tokens for complex tasks.

Requirements

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

opencode_bridge-0.4.3.tar.gz (87.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

opencode_bridge-0.4.3-py3-none-any.whl (18.6 kB view details)

Uploaded Python 3

File details

Details for the file opencode_bridge-0.4.3.tar.gz.

File metadata

  • Download URL: opencode_bridge-0.4.3.tar.gz
  • Upload date:
  • Size: 87.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.12

File hashes

Hashes for opencode_bridge-0.4.3.tar.gz
Algorithm Hash digest
SHA256 37d5defdba8e18a3419f498507412fd56df371c13285cd92e90d24578f88f835
MD5 06d35f2f7041daf3d539df9cffe07919
BLAKE2b-256 0b34b7010ef56e1cfcd9f2cf55426bf681ddc8b62ce2f92b4f5ccf7dde11708e

See more details on using hashes here.

File details

Details for the file opencode_bridge-0.4.3-py3-none-any.whl.

File metadata

File hashes

Hashes for opencode_bridge-0.4.3-py3-none-any.whl
Algorithm Hash digest
SHA256 be5f76a01e5d4e43bdf8397e6f7fc1aeadb9d16aea99410692635a27a5cdb46d
MD5 6d11252d830c8e5abd262212ca03bf9c
BLAKE2b-256 0bef8b1c4566f5076c508a498c2e0fe006dbd1d2f3894ce4c4900e2f0cd08084

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page