@zigai/pi-model-alias0.6.0
Pi package that adds aliases for provider model IDs and provider display names.
Untested on omp
This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.
Reports 0
No reports yet.
Readme
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 keeps alias IDs and labels locally, resolves native IDs before virtual routing, and sends physical model IDs to providers. 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