@zigai/pi-model-alias

Pi package that adds aliases for provider model IDs and provider display names.

Packages

Package details

extension

Install @zigai/pi-model-alias from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@zigai/pi-model-alias
Package
@zigai/pi-model-alias
Version
0.3.0
Published
Jul 17, 2026
Downloads
725/mo · 100/wk
Author
zigai
License
MIT
Types
extension
Size
239 KB
Dependencies
2 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

Pi Model Alias

Add aliases for long provider model IDs and provider display names.

Use it when a provider model identifier is hard to type or when provider IDs are hard to scan in Pi UI. Model aliases are shown and accepted by Pi, then rewritten back to the original model ID before provider requests are sent. Provider aliases are visual only; Pi still uses the real provider ID for auth, lookup, and requests.

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 object[] [] Model alias entries matched by provider and model ID.
providerAliases object[] [] Provider display-name aliases.
stableProviderColumn boolean true Keep the provider column stable when aliases are displayed. 
{
  "$schema": "./schemas/pi-model-alias.schema.json",
  "aliases": [],
  "providerAliases": [],
  "stableProviderColumn": true
}

License

MIT