pi-opencode-zen

pi-opencode-zen is a pi extension package extracted from pi-mono and adapted into a standalone extension.

It registers the opencode-zen provider for pi and exposes OpenCode Zen models through pi's provider system.

Install

Install it as a local/private pi package:

pi install git:github.com/ravshansbox/pi-opencode-zen

After installation, reload pi if needed.

Behavior

This extension:

• is extracted from pi-mono
• registers the opencode-zen provider from a standalone package
• supports anonymous mode by using the API key value public
• adds OpenCode request headers on every opencode-zen provider request:
  • x-opencode-client
  • x-opencode-session
  • x-opencode-project
  • x-opencode-request
• sets the OpenCode CLI-style User-Agent

Authentication

Get an API key from OpenCode Zen, then configure pi in one of these ways.

Environment variable

Set:

export OPENCODE_API_KEY=your-real-key

To use anonymous mode for OpenCode Zen free/public models, set:

export OPENCODE_API_KEY=public

pi auth storage

You can also store the key in pi's auth file under the opencode-zen provider name:

~/.pi/agent/auth.json

Example:

{
  "opencode-zen": {
    "type": "api_key",
    "key": "your-real-key"
  }
}

Anonymous mode in auth storage:

{
  "opencode-zen": {
    "type": "api_key",
    "key": "public"
  }
}

Package entry

This package stays private: true and is intended for local/private use. The extension entry point is declared in package.json:

{
  "pi": {
    "extensions": ["./index.ts"]
  }
}

Model filtering

This extension mirrors OpenCode CLI behavior as closely as possible:

• it fetches the live visible model IDs from the OpenCode Zen API
• it fetches OpenCode provider metadata from models.dev
• it filters out models with status === "deprecated"
• in anonymous/public mode (key = "public"), it keeps only models where models.dev reports cost.input === 0

Live model visibility source:

curl -H 'Authorization: Bearer public' https://opencode.ai/zen/v1/models

OpenCode metadata source:

curl https://models.dev/api.json

Note: the Zen /models endpoint does not include pricing or deprecation metadata, so the extension combines both sources.

Source layout

• index.ts — extension entry point
• package.json — pi package metadata