Quick Start

Get OpenCode running in under 5 minutes.

Prerequisites

• Node.js 20+ (brew install node)
• Git configured with GitHub access

Installation

# Install OpenCode CLI
curl -fsSL https://opencode.ai/install | bash

# Verify installation
opencode --version

First Session

# Start OpenCode in your project
cd ~/my-project
opencode

# Or run with a direct message
opencode run "Create a REST API with Express"

Using Agents

# List available agents
opencode agent list

# Create a new agent
opencode agent create researcher --model openai/gpt-5.4

# Run with a specific agent
opencode run --agent researcher "Research the latest AI trends"

Using Plugins

# Install a plugin
opencode plugin oh-my-opencode

# Verify plugins
opencode plugin list

Using MCPs

# Configure MCP servers
opencode mcp add filesystem --command npx -y @modelcontextprotocol/server-filesystem /path/to/dir

# List MCPs
opencode mcp list

Essential Commands

Command	Description
/help	Show available commands
/agents	List and switch agents
/models	List and switch models
/tools	Show available tools
/export	Export session data
/compact	Compact conversation context

Next Steps

• Installation Guide — Detailed setup instructions
• Agent Basics — Learn to use agents effectively
• MCP Integration — Connect external tools
• Plugin System — Build custom plugins