README

This plugin is an AI Provider for OpenCode for the PHP AI Client SDK. Works as both a Composer package and a WordPress plugin.

Note: You are viewing the the development repository. You can clone or download this entire repository and use it as a plugin, but for safety and speed, you should use the built version from WordPress.org.

Description

This plugin integrates OpenCode's AI models into WordPress as a provider for the PHP AI Client SDK. Once activated, OpenCode is automatically registered as a provider – no manual configuration required.

OpenCode provides access to a variety of open-source models through a unified API, enabling text generation and chat history capabilities for WordPress sites.

Features

Text Generation — Use OpenCode's language models for content creation, summarization, analysis, and more.
Chat History — Maintain conversation context across multiple interactions.
Dynamic Model Discovery — Available models are fetched directly from the OpenCode API, so your plugin stays compatible with new releases automatically.
Automatic Provider Registration — Registers itself with the PHP AI Client on WordPress init; no manual wiring needed.

Requirements

PHP 7.4 or higher
For WordPress 6.9, the wordpress/php-ai-client package must be installed
For WordPress 7.0 and above, no additional changes are required
OpenCode API key

Installation

As a WordPress Plugin

Download the latest release from the plugin's WordPress page
Upload to /wp-content/plugins/ai-provider-for-opencode/
Activate the plugin through the WordPress admin
Configure your OpenCode API key (see Configuration)

As a Composer Package

composer require thaikolja/ai-provider-for-opencode

Then register the provider manually:

use WordPress\AiClient\AiClient;
use WordPress\OpenCodeAiProvider\Provider\OpenCodeProvider;

$registry = AiClient::defaultRegistry();
$registry->registerProvider( OpenCodeProvider::class );

Usage

With WordPress

Install and activate the plugin, and add your API key – that's it!

You can use the connector in your WordPress theme or plugin. It automatically registers itself on the init hook. Simply ensure the plugin is active and configure your API key either on your Connectors page or via a constant:

// Set your OpenCode API key (or use the OPENCODE_API_KEY environment variable)
putenv( 'OPENCODE_API_KEY=your-api-key' );

// Use the provider
$result = AiClient::prompt( 'Hello, world!' )
	->usingProvider( 'opencode' )
	->generateTextResult();

echo $result->toText();

As a Standalone Package

use WordPress\AiClient\AiClient;
use WordPress\OpenCodeAiProvider\Provider\OpenCodeProvider;

// Register the provider
$registry = AiClient::defaultRegistry();
$registry->registerProvider( OpenCodeProvider::class );

// Set your API key
putenv( 'OPENCODE_API_KEY=your-api-key' );

// Generate text
$result = AiClient::prompt( 'Explain quantum computing' )
	->usingProvider( 'opencode' )
	->generateTextResult();

echo $result->toText();

Supported Models

Available models are dynamically discovered from the OpenCode API at https://opencode.ai/zen/go/v1/models. Currently available models include:

DeepSeek-V4-Pro (deepseek-v4-pro) — High-quality text generation
DeepSeek-V4-Flash (deepseek-v4-flash) — Fast, efficient text generation
GLM-5.1 (glm-5.1) — Text generation
GLM-5 (glm-5) — Text generation
Hy3 Preview (hy3-preview) — Text generation
Kimi-K2.6 (kimi-k2.6) — Text generation
Kimi-K2.5 (kimi-k2.5) — Text generation
Mimo-V2-Pro (mimo-v2-pro) — Text generation
Mimo-V2-Omni (mimo-v2-omni) — Text generation
Mimo-V2.5-Pro (mimo-v2.5-pro) — Text generation
Mimo-V2.5 (mimo-v2.5) — Text generation
MiniMax-M3 (minimax-m3) — Text generation
MiniMax-M2.7 (minimax-m2.7) — Text generation
MiniMax-M2.5 (minimax-m2.5) — Text generation
Qwen3.7-Max (qwen3.7-max) — Text generation
Qwen3.7-Plus (qwen3.7-plus) — Text generation
Qwen3.6-Plus (qwen3.6-plus) — Text generation
Qwen3.5-Plus (qwen3.5-plus) — Text generation

All models returned from the API receive textGeneration and chatHistory capabilities automatically.

Configuration

The provider uses the OPENCODE_API_KEY environment variable for authentication. Set it via your environment, wp-config.php, or inline:

// Via wp-config.php
define( 'OPENCODE_API_KEY', 'your-api-key' );

// Or via PHP environment
putenv( 'OPENCODE_API_KEY=your-api-key' );

Visit the OpenCode Platform to sign up for a Go or Zen plan and generate an API key.

Development

# Install dependencies
composer install

# Lint (phpcs + phpstan)
composer lint

# Auto-fix coding standards issues
composer phpcbf

# Build for production (creates ai-provider-for-opencode.zip)
./scripts/build.sh

External Services

This plugin connects to the OpenCode API to provide AI capabilities within WordPress. Connection to this service is required to enable text generation, chat history, and dynamic model discovery.

What data is sent and when:

Your OpenCode API key is sent with every request to authenticate with the service.
Any text prompts, messages, or content you submit for AI processing are sent to OpenCode's servers.
A request is made to the OpenCode API to fetch available models when the plugin initializes.
Data is only transmitted when AI features are actively used.

Service provider: OpenCode

Website: https://opencode.ai/
API Base URL: https://opencode.ai/zen/go/v1

Contributors

Kolja Nolte (kolja.nolte@gmail.com)

License

GPL-2.0-or-later

thaikolja / ai-provider-for-opencode

Maintainers

Package info

Statistics

Security