Welcome to OpenCode

The open source AI coding agent

OpenCode is an open source AI coding agent that accelerates your software development workflow. Available as a terminal-based interface, desktop app, or IDE extension, it brings AI assistance directly into your development environment.

OpenCode is 100% open source and works with multiple LLM providers including Claude, OpenAI, Google, and local models.

Why OpenCode?

Provider Agnostic

Not locked into any single provider. Use Claude, OpenAI, Google, or local models. Switch providers anytime.

Terminal First

Built by terminal enthusiasts. Optimized for modern terminals with full keyboard navigation and customization.

LSP Support

Out-of-the-box Language Server Protocol support provides intelligent code understanding and context.

Flexible Architecture

Client/server design enables remote operation. Run on your machine, control from anywhere.

Key Features

Intelligent Agents

OpenCode includes specialized agents for different tasks:

• Build Agent - Full development with all tools enabled
• Plan Agent - Analysis and planning without making changes
• General Subagent - Complex research and parallel tasks
• Explore Subagent - Fast, read-only codebase exploration

Switch between agents with the Tab key or invoke them via @ mentions.

Powerful Tools

1. File Operations

   Read, write, and edit files with context-aware assistance. Supports glob patterns and content search.

2. Shell Integration

   Execute commands directly through the terminal. Full bash command support.

3. Custom Commands

   Create reusable commands for repetitive tasks. Use /command syntax to run them instantly.

4. MCP Servers

   Extend functionality with Model Context Protocol servers. Connect to databases, APIs, and more.

Collaborative Features

Share Conversations: Share your OpenCode sessions with your team using the /share command. Conversations are private by default.

Version Control Integration: Built-in Git support makes it easy to track changes, create commits, and manage branches.

Undo/Redo: Made a mistake? Use /undo to revert changes instantly. Redo them with /redo.

Workflow Patterns

Plan, Review, Build

1. Switch to Plan Mode

   Press Tab to enter Plan mode. Describe your feature or change.

2. Review the Plan

   OpenCode creates a detailed implementation plan without touching code.

3. Build It

   Press Tab again to switch to Build mode. Say “go ahead” to implement.

Ask Questions

Use the @ key to fuzzy search and reference files:

How is authentication handled in @src/auth/index.ts

Add Features

Provide context and examples for best results:

Add a delete confirmation modal. Use the same pattern as @src/modals/ConfirmModal.tsx
but customize the message and button styles.

Make Changes

Direct requests work great for straightforward modifications:

Update the API endpoint in @config/api.ts to use the production URL

Customization

Themes

Choose from multiple built-in themes or create your own color schemes.

Keybinds

Customize keyboard shortcuts to match your workflow and muscle memory.

Formatters

Configure code formatters like Prettier, ESLint, or language-specific tools.

What’s Next?

Installation

Install OpenCode using your preferred package manager

Quick Start

Get your first session running in under 5 minutes

New to AI coding agents? Check out the Quick Start guide for a hands-on tutorial.