# Via npm
npm install -g @opencode-ai/cli

# Via Homebrew
brew install opencode/tap/cli

# Verify
opencode --version

# Anthropic (via API key)
export ANTHROPIC_API_KEY="sk-ant-..."

# OpenAI
export OPENAI_API_KEY="sk-..."

# Google Gemini
export GOOGLE_API_KEY="..."

# DeepSeek (95% cheaper than Anthropic for coding)
export DEEPSEEK_API_KEY="sk-..."

# OpenRouter (300+ models, one API key)
export OPENROUTER_API_KEY="sk-or-..."

{
  "provider": "anthropic",
  "model": "claude-sonnet-4-20250514",
  "providers": {
    "anthropic": {
      "apiKey": "${ANTHROPIC_API_KEY}",
      "baseUrl": "https://api.anthropic.com/v1"
    },
    "openai": {
      "apiKey": "${OPENAI_API_KEY}"
    },
    "deepseek": {
      "apiKey": "${DEEPSEEK_API_KEY}",
      "baseUrl": "https://api.deepseek.com/v1"
    }
  }
}

cd my-project
opencode

⚡ Welcome to OpenCode!

  Choose a provider:
  > 1. Anthropic (recommended for complex coding)
    2. OpenAI
    3. DeepSeek (budget-friendly)
    4. Google Gemini (1M context)
    5. OpenRouter (300+ models)
    
  1. Anthropic
  
  Choose a model:
  > 1. claude-sonnet-4-20250514 ($3/M tokens)
    2. claude-opus-4-20250514 ($15/M tokens)
    
>

# AGENTS.md

## Commands
- `npm run dev` — Start development server at localhost:3000
- `npm run build` — Production build with type checking
- `npx vitest run` — Run all tests
- `npx eslint .` — Lint check

## Project Architecture
- Next.js 14 with App Router and React Server Components
- TypeScript strict mode with path alias @/
- SQLite via better-sqlite3 — no ORM, raw SQL
- Zero API dependencies for now

## Code Style
- Use async/await in server components for data fetching
- Extract business logic from components into lib/ immediately
- Tests go next to the file they test (co-location)