OpenCode Desktop Integration

OpenCode Desktop is the GUI desktop app version of OpenCode — an open-source AI coding agent with a full visual interface for managing providers, models, and sessions. OffRail is a built-in provider, so setup takes under a minute with no config files required.

Prerequisites

• OpenCode Desktop installed — download for Windows or macOS
• An OffRail API key — sign up free (no credit card required)

Installation

Download OpenCode Desktop from opencode.ai/download and install it for your platform:

• macOS (Apple Silicon) — .dmg installer
• macOS (Intel) — .dmg installer
• Windows — .exe installer

You can also install on macOS via Homebrew:

1brew install --cask opencode-desktop

1brew install --cask opencode-desktop

Setup

Step 1: Open Providers Settings

Launch OpenCode Desktop. Click the Providers section in the left sidebar under Server. You'll see the list of built-in providers:

Step 2: Find OffRail

Click Show more providers at the bottom of the list, or click + Connect on any entry to open the provider search. Type LLM in the search box — OffRail will appear under "Other":

Select OffRail from the list.

Step 3: Enter Your API Key

OpenCode will show the Connect OffRail dialog. Paste your OffRail API key (starts with orl_) and click Continue:

Sign up or log in to your OffRail dashboard and navigate to API Keys to get your key.

Step 4: Select a Model

Once connected, open the model picker from the chat input bar. Type llm to filter OffRail models — you'll see all available models including Claude Opus 4.7, Claude Sonnet 4.6, DeepSeek, Gemini, and more:

Step 5: Start Building

Select a model and start chatting. All requests route through OffRail — you'll see usage, costs, and logs in your dashboard:

Why Use OffRail with OpenCode Desktop?

• 200+ models — Claude, GPT, Gemini, Llama, DeepSeek, and more from 40+ providers
• One API key — Stop managing separate keys for each provider
• Cost tracking — See exactly what each session costs in your dashboard
• Response caching — Repeated requests hit cache automatically
• Automatic fallback — If a provider is down, requests route to an alternative
• Volume discounts — Check discounted models for savings up to 90%

Switching Models

You can switch models at any time from the model picker in the chat input bar. Click the current model name, type llm to filter to OffRail models, and select a new one. The switch takes effect immediately for the next message.

Troubleshooting

OffRail doesn't appear in provider list

Click Show more providers at the bottom of the Providers page to expand the full list, then search for "LLM".

Authentication errors

Make sure your API key starts with orl_ and is active. Check your dashboard to confirm the key is valid.

Models not loading after connect

Try disconnecting and reconnecting the provider from Settings > Providers. If models still don't load, check your internet connection and verify the key is valid.