Pi Model Filter

Focused model lists for Pi, showing only the models you want.

Install

pi install npm:@zigai/pi-model-filter

Configuration

Global settings are stored in ~/.pi/agent/extension-settings/pi-model-filter.json.

| Option | Type | Default | Description | | --- | --- | --- | --- | | include | { provider: string; models: string[] }[] | [] | Provider and model glob rules that form inclusion allowlists. | | exclude | { provider: string; models: string[] }[] | [] | Provider and model glob rules that hide matching models. |

Defaults

{
  "$schema": "./schemas/pi-model-filter.schema.json",
  "include": [],
  "exclude": []
}

Advanced example

{
  "$schema": "./schemas/pi-model-filter.schema.json",
  "include": [
    {
      "provider": "openai-codex",
      "models": [
        "gpt-5.*"
      ]
    }
  ],
  "exclude": [
    {
      "provider": "openai-codex",
      "models": [
        "*-mini"
      ]
    }
  ]
}

Rules

• provider and models match provider/model ids.
• Exact strings and glob patterns are supported.
• * matches any number of characters; ? matches one character.
• include allowlists models for matching providers.
• exclude hides matching models and always wins over include.
• Providers without include rules stay visible unless excluded.

How is this different from /scoped-models?

Pi has a built-in /scoped-models command. It shows an interactive checklist that lets you enable or disable individual models for Ctrl+P cycling. Changes are session-only until you press Ctrl+S to persist them.

pi-model-filter works differently:

| | /scoped-models | pi-model-filter | | -------------------- | ------------------------------------ | --------------------------------------------------------------------- | | How you configure it | Interactive checklist | JSON config file with glob patterns | | What it affects | Ctrl+P model cycling only | /model, Ctrl+L, Ctrl+P cycling, and modelRegistry.*() lookups | | Persistence | Optional (save with Ctrl+S) | Always loaded from JSON config | | Use case | Quickly narrow the active cycle list | Permanently hide noisy/unwanted models everywhere |

Behavior

This extension filters models from Pi's model registry views, including:

• /model
• model cycling
• modelRegistry.getAll()
• modelRegistry.getAvailable()
• modelRegistry.find()

It does not delete provider definitions, model definitions, or credentials.

License

MIT