Pi Model Alias

Shorter local model IDs and customizable model and provider labels for Pi.

A model alias maps a provider's real model ID to the shorter alias accepted by Pi. Its optional name changes only the displayed label; omitting it preserves Pi's native model name. Pi rewrites aliases to real model IDs before provider requests. Provider aliases change displayed provider names without changing provider IDs.

Install

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

Configuration

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

| Option | Type | Default | Description | | --- | --- | --- | --- | | aliases | { provider: string; model: string; alias: string; name?: string }[] | [] | Short model IDs with optional display-name overrides. | | providerAliases | { provider: string; name: string }[] | [] | Provider display-name overrides; provider IDs remain unchanged. | | stableProviderColumn | boolean | true | Keep the provider column stable when aliases are displayed. |

Defaults

{
  "$schema": "./schemas/pi-model-alias.schema.json",
  "aliases": [],
  "providerAliases": [],
  "stableProviderColumn": true
}

Advanced example

{
  "$schema": "./schemas/pi-model-alias.schema.json",
  "aliases": [
    {
      "provider": "anthropic",
      "model": "claude-sonnet-4-5",
      "alias": "sonnet",
      "name": "Claude Sonnet 4.5"
    },
    {
      "provider": "openai-codex",
      "model": "gpt-5.6-sol",
      "alias": "sol"
    }
  ],
  "providerAliases": [
    {
      "provider": "openai-codex",
      "name": "Codex"
    }
  ]
}

License

MIT