@zeldrisho/pi-opencode-free

Pi provider extension for OpenCode's free-tier models

Packages

Package details

extension

Install @zeldrisho/pi-opencode-free from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@zeldrisho/pi-opencode-free
Package
@zeldrisho/pi-opencode-free
Version
0.4.0
Published
Nov 10, 2026
Downloads
1,762/mo · 309/wk
Author
zeldrisho
License
MIT
Types
extension
Size
124.4 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@zeldrisho/pi-opencode-free

Use OpenCode's free-tier models from Pi. This experimental extension is independently maintained, and access may change without notice. OpenCode states that its free-tier chat models require OpenCode; access from Pi is not guaranteed. No account, API key, or OpenCode installation is required by this extension.

Requirements

Install the Bun runtime; the extension uses it to send model requests. Bun must be available as bun on PATH. Optionally, set PI_OPENCODE_FREE_BUN to the Bun executable's path if you need to use a different installation.

Install

pi install npm:@zeldrisho/pi-opencode-free

# Project:
pi install -l npm:@zeldrisho/pi-opencode-free

Restart Pi after installing. Use pi config to enable or disable the extension, and pi list to see installed packages.

Usage

  1. Run /model.
  2. Type opencode-free to filter the list.
  3. Select a model tagged [opencode-free].

Your prompts are sent to OpenCode's service. Endpoint and API-key environment overrides are not supported.

The model list refreshes when you open /model. If discovery is unavailable, the last synced catalog or Pi's bundled free models remain available.

Long sessions

Free-tier models can build up more history than a single compaction summary fits into. When one summary would leave too little room for the answer, the extension summarizes the history in segments with the model you already selected and merges the result into one checkpoint, without changing your model or thinking level. If a summary can't be used, Pi's native compaction still applies; small histories and other providers are unaffected.

Leaving a long branch in /tree with Summarize or Summarize with custom prompt works the same way; Summarize keeps Pi's branch-summary format, and a custom prompt is applied as Pi applies it. No summary behaves as before.

Usage limits

OpenCode controls availability and usage limits. FreeUsageLimitError can mean either an exhausted allowance or a refused request. When available, the error shows the server-reported reset time in your local timezone; otherwise it says Reset time unavailable. Retry later or select another provider with /model. A reported reset does not guarantee restored access.

Uninstall

pi remove npm:@zeldrisho/pi-opencode-free

# Project:
pi remove -l npm:@zeldrisho/pi-opencode-free

License

MIT