OpenCode Warp Agent Plugin

A minimal OpenCode plugin that integrates with Warp.dev's Agent API, providing access to all Warp models including thinking configurations.

Installation

1. Add the plugin to ~/.config/opencode/opencode.json:

   {
     "plugin": ["opencode-warp-agent@latest"]
   }

2. Set your API key as an environment variable:

   export WARP_API_KEY="your-warp-api-key"

3. Add models to your OpenCode configuration:

   {
     "provider": {
       "warp": {
         "models": {
           "claude-4.5-sonnet": {
             "name": "Claude 4.5 Sonnet",
             "limit": { "context": 200000, "output": 8192 },
             "modalities": { "input": ["text"], "output": ["text"] },
             "variants": {
               "off": { "thinkingConfig": { "enabled": false } },
               "thinking": { "thinkingConfig": { "enabled": true } }
             }
           },
           "gpt-5.2": {
             "name": "GPT-5.2",
             "limit": { "context": 128000, "output": 4096 },
             "modalities": { "input": ["text"], "output": ["text"] },
             "variants": {
               "low": { "thinkingLevel": "low" },
               "medium": { "thinkingLevel": "medium" },
               "high": { "thinkingLevel": "high" },
               "xhigh": { "thinkingLevel": "xhigh" }
             }
           }
         }
       }
     }
   }

Available Models

• auto - Auto (Responsive, Cost-Efficient, Genius)
• claude-4-sonnet - Claude 4 Sonnet
• claude-4.1-opus - Claude 4.1 Opus
• claude-4.5-haiku - Claude 4.5 Haiku
• claude-4.5-opus - Claude 4.5 Opus (supports thinking)
• claude-4.5-sonnet - Claude 4.5 Sonnet (supports thinking)
• gemini-2.5-pro - Gemini 2.5 Pro
• gemini-3-pro - Gemini 3 Pro
• glm-4.7 - GLM 4.7 (US-Hosted)
• gpt-5 - GPT-5 (low, medium, high variants)
• gpt-5.1 - GPT-5.1 (low, medium, high variants)
• gpt-5.1-codex - GPT-5.1 Codex (low, medium, high variants)
• gpt-5.1-codex-max - GPT-5.1 Codex Max (low, medium, high, xhigh variants)
• gpt-5.2 - GPT-5.2 (low, medium, high, xhigh variants)
• gpt-5.2-codex - GPT-5.2 Codex (low, medium, high, xhigh variants)

Usage

# Use Claude 4.5 Sonnet with thinking
opencode run "Explain quantum computing" --model=warp/claude-4.5-sonnet --variant=thinking

# Use GPT-5.2 with high thinking level
opencode run "Write a Python script" --model=warp/gpt-5.2 --variant=high

# Use auto model selection
opencode run "Help me debug this code" --model=warp/auto

Configuration

The plugin uses the WARP_API_KEY environment variable for authentication. You can get your API key from the Warp platform.

License

MIT