@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