OpenCode Documentation
Complete OpenCode reference documentation, synced from the official repository. Includes configuration, providers, tools, MCP servers, and more.
📚Core
Intro
Get started with OpenCode.
Config
Using the OpenCode JSON config.
Providers
Using any LLM provider in OpenCode.
Network
Configure proxies and custom certificates.
Enterprise
Using OpenCode securely in your organization.
Troubleshooting
Common issues and how to resolve them.
Migrating to 1.0
What's new in OpenCode 1.0.
🚀Usage
TUI
Using the OpenCode terminal user interface.
CLI
OpenCode CLI options and commands.
Web
Using OpenCode in your browser.
IDE
The OpenCode extension for VS Code, Cursor, and other IDEs
Zen
Curated list of models provided by OpenCode.
Share
Share your OpenCode conversations.
GitHub
Use OpenCode in GitHub issues and pull-requests.
GitLab
Use OpenCode in GitLab issues and merge requests.
OpenCode Plan vs Build Mode
Compare OpenCode Plan and Build, switch with Tab, configure agent permissions, and move from a reviewed plan to tested code changes.
⚙️Configure
Tools
Manage the tools an LLM can use.
Rules
Set custom instructions for opencode.
Agents
Configure and use specialized agents.
Models
Configuring an LLM provider and model.
Themes
Select a built-in theme or define your own.
Keybinds
Customize your keybinds.
Commands
Create custom commands for repetitive tasks.
Formatters
OpenCode uses language specific formatters.
Permissions
Control which actions require approval to run.
OpenCode LSP Setup and Troubleshooting
Enable OpenCode LSP, configure language servers, and troubleshoot “LSPs are disabled” with practical checks for TypeScript, Python and Go.
MCP servers
Add local and remote MCP tools.
ACP Support
Use OpenCode in any ACP-compatible editor.
Agent Skills
Define reusable behavior via SKILL.md definitions
Custom Tools
Create tools the LLM can call in opencode.