@monopi/provider-catalog

Experimental multi-provider package for pi backed by the OpenCode models.dev catalog.

Packages

Package details

extension

Install @monopi/provider-catalog from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@monopi/provider-catalog
Package
@monopi/provider-catalog
Version
0.6.1
Published
Aug 28, 2026
Downloads
243/mo · 28/wk
Author
ifiokjr
License
MIT
Types
extension
Size
60.7 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

@monopi/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 /login picker
  • 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 login picker 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:@monopi/provider-catalog

This package is intentionally separate from @monopi/monopi for now.

Use

  1. Install the package
  2. Run /providers list to see supported provider ids
  3. Run /providers login to browse the full provider list in a scrollable picker, or /providers login <provider-id> if you already know the id
  4. Open /model and select one of the discovered models
  5. 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:

  • xai
  • opencode
  • opencode-go
  • moonshotai
  • other OpenCode-cataloged API-key providers

Notes

  • Ollama is intentionally excluded because @monopi/provider-ollama already 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.dev metadata 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 the models.dev catalog URL for tests or local debugging