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