AI SDK Provider for OpenCode

Initial Release: Version 0.0.1 - Compatible with AI SDK v5 and @opencode-ai/sdk.

A community provider for the Vercel AI SDK that enables using AI models through OpenCode and the @opencode-ai/sdk. OpenCode is a terminal-based AI coding assistant that supports multiple providers (Anthropic, OpenAI, Google, and more).

This provider enables you to use OpenCode's AI capabilities through the familiar Vercel AI SDK interface, supporting generateText(), streamText(), generateObject(), and streamObject().

Installation

npm install ai-sdk-provider-opencode-sdk

Prerequisites

• Node.js >= 18
• OpenCode CLI installed (npm install -g opencode)
• Valid API keys configured in OpenCode for your preferred providers

Quick Start

import { generateText } from 'ai';
import { opencode } from 'ai-sdk-provider-opencode-sdk';

const result = await generateText({
  model: opencode('anthropic/claude-opus-4-5-20251101'),
  prompt: 'What is the capital of France?',
});

console.log(result.text);

Usage

Creating a Provider

import { createOpencode } from 'ai-sdk-provider-opencode-sdk';

// Default provider (auto-starts server)
const opencode = createOpencode();

// With custom settings
const opencode = createOpencode({
  hostname: '127.0.0.1',
  port: 4096,
  autoStartServer: true,
  serverTimeout: 10000,
  defaultSettings: {
    agent: 'build',
    sessionTitle: 'My Session',
  },
});

Model Selection

Models are specified in providerID/modelID format:

// Anthropic models (Claude 4.5 series)
opencode('anthropic/claude-sonnet-4-5-20250929')
opencode('anthropic/claude-haiku-4-5-20251001')
opencode('anthropic/claude-opus-4-5-20251101')

// OpenAI models (GPT-5.1 series)
opencode('openai/gpt-5.1')
opencode('openai/gpt-5.1-codex')
opencode('openai/gpt-5.1-codex-mini')
opencode('openai/gpt-5.1-codex-max')

// Google Gemini models
opencode('google/gemini-3-pro-preview')
opencode('google/gemini-2.5-flash')
opencode('google/gemini-2.5-pro')
opencode('google/gemini-2.0-flash')

Streaming

import { streamText } from 'ai';

const result = streamText({
  model: opencode('anthropic/claude-opus-4-5-20251101'),
  prompt: 'Write a haiku about coding.',
});

for await (const chunk of result.textStream) {
  process.stdout.write(chunk);
}

Conversation History

import { generateText, type CoreMessage } from 'ai';

const messages: CoreMessage[] = [
  { role: 'user', content: 'My name is Alice.' },
  { role: 'assistant', content: 'Hello Alice! How can I help you today?' },
  { role: 'user', content: 'What is my name?' },
];

const result = await generateText({
  model: opencode('anthropic/claude-opus-4-5-20251101'),
  messages,
});

Agent Selection

OpenCode supports different agents for different tasks:

const model = opencode('anthropic/claude-opus-4-5-20251101', {
  agent: 'build',  // or 'plan', 'general', 'explore'
});

Session Management

Sessions maintain conversation context:

const model = opencode('anthropic/claude-opus-4-5-20251101', {
  sessionTitle: 'Code Review Session',
});

// First call creates a session
const result1 = await generateText({ model, prompt: 'Review this code...' });

// Subsequent calls reuse the same session
const result2 = await generateText({ model, prompt: 'What did you find?' });

// Get session ID from metadata
const sessionId = result1.providerMetadata?.opencode?.sessionId;

// Resume a specific session
const resumeModel = opencode('anthropic/claude-opus-4-5-20251101', {
  sessionId: sessionId,
});

Tool Observation

OpenCode executes tools server-side. You can observe tool execution but cannot provide custom implementations:

import { streamText } from 'ai';

const result = streamText({
  model: opencode('anthropic/claude-opus-4-5-20251101'),
  prompt: 'List files in the current directory.',
});

for await (const part of result.fullStream) {
  if (part.type === 'tool-call') {
    console.log(`Tool: ${part.toolName}`);
    console.log(`Input: ${part.args}`);
  }
  if (part.type === 'tool-result') {
    console.log(`Result: ${part.result}`);
  }
}

Feature Support

| Feature | Support | Notes | |---------|---------|-------| | Text generation | ✅ Full | generateText(), streamText() | | Streaming | ✅ Full | Real-time SSE streaming | | Multi-turn conversations | ✅ Full | Session-based context | | Tool observation | ✅ Full | See tool execution | | Reasoning/thinking | ✅ Full | ReasoningPart support | | Model selection | ✅ Full | Per-request model | | Agent selection | ✅ Full | build, plan, general, explore | | Abort/cancellation | ✅ Full | AbortSignal support | | Image input (base64) | ⚠️ Partial | Data URLs only | | Image input (URL) | ❌ None | Not supported | | JSON mode | ⚠️ Partial | Prompt-based | | Custom tools | ❌ None | Server-side only | | temperature/topP/topK | ❌ None | Provider defaults | | maxTokens | ❌ None | Agent config |

Provider Settings

interface OpencodeProviderSettings {
  hostname?: string;        // Default: '127.0.0.1'
  port?: number;            // Default: 4096
  baseUrl?: string;         // Override full URL
  autoStartServer?: boolean; // Default: true
  serverTimeout?: number;   // Default: 10000
  defaultSettings?: OpencodeSettings;
}

Model Settings

interface OpencodeSettings {
  sessionId?: string;       // Resume session
  createNewSession?: boolean; // Force new session
  sessionTitle?: string;    // Title for new sessions
  agent?: string;           // Agent name
  systemPrompt?: string;    // Override system prompt
  tools?: Record<string, boolean>; // Enable/disable tools
  cwd?: string;             // Working directory
  logger?: Logger | false;  // Logging
  verbose?: boolean;        // Debug logging
}

Error Handling

The provider converts OpenCode errors to AI SDK error types:

import { isAuthenticationError, isTimeoutError } from 'ai-sdk-provider-opencode-sdk';

try {
  const result = await generateText({ model, prompt: '...' });
} catch (error) {
  if (isAuthenticationError(error)) {
    console.error('Check your API keys in OpenCode');
  } else if (isTimeoutError(error)) {
    console.error('Request timed out');
  }
}

Cleanup

Always dispose of the provider when done to stop the managed server:

const opencode = createOpencode();

// ... use the provider ...

// Clean up
await opencode.dispose?.();

License

MIT