@ifi/pi-provider-catalog
Experimental multi-provider package for pi backed by the OpenCode models.dev catalog.
Package details
Install @ifi/pi-provider-catalog from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@ifi/pi-provider-catalog- Package
@ifi/pi-provider-catalog- Version
0.5.1- Published
- Apr 28, 2026
- Downloads
- 238/mo · 238/wk
- Author
- ifiokjr
- License
- MIT
- Types
- extension
- Size
- 60.4 KB
- Dependencies
- 1 dependency · 5 peers
Pi manifest JSON
{
"extensions": [
"./index.ts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
@ifi/pi-provider-catalog
Experimental multi-provider package for pi backed by the OpenCode models.dev catalog.
What it does
- Registers configured API-key providers from the OpenCode catalog without flooding pi's global
/loginpicker - Keeps provider model lists, context windows, reasoning flags, and vision support aligned with
models.dev - Reuses live provider discovery when a provider exposes a model-list endpoint
- Adds a scrollable
/providers:loginpicker with in-place search for lazy provider registration and API-key login - Adds
/providers ...commands for status, listing, inspection, and catalog refreshes
Install
pi install npm:@ifi/pi-provider-catalog
This package is intentionally separate from @ifi/oh-pi for now.
Use
- Install the package
- Run
/providers:listto see supported provider ids - Run
/providers:loginto browse the full provider list in a scrollable picker, or/providers:login <provider-id>if you already know the id - Open
/modeland select one of the discovered models - Run
/providers:refresh-models <provider-id>whenever you want to refresh the live catalog
You can also skip /login and set a supported provider env var directly when the provider uses a simple API-key flow.
Commands
/providers:status— summarize configured providers from this package/providers:list [query]— list supported provider ids and env vars/providers:login [provider]— scroll through the full provider list, search in place, lazily register one, and prompt for its API key/providers:info <provider>— inspect a provider's API mode, URLs, env vars, and model count/providers:models <provider>— list the current or fallback model catalog for one provider/providers:refresh-models [provider|all]— refresh configured providers from live discovery when possible
Highlights
This package includes providers the user explicitly asked about, including:
xaiopencodeopencode-gomoonshotai- other OpenCode-cataloged API-key providers
Notes
- Ollama is intentionally excluded because
@ifi/pi-provider-ollamaalready exists. - This package focuses on providers that can be configured with a single API key plus a stable HTTP base URL.
- Some upstream providers still have provider-specific quirks or headers. When live discovery fails, pi falls back to the cached
models.devmetadata instead of dropping the provider entirely. - Providers that need multi-part auth or cloud-specific credential chains are still better served by dedicated integrations.
Test hook
PI_PROVIDER_CATALOG_URL— override themodels.devcatalog URL for tests or local debugging