@zigai/pi-model-alias

Pi package that adds short aliases for provider model IDs.

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.1.9
Published
Jun 19, 2026
Downloads
640/mo · 334/wk
Author
zigai
License
MIT
Types
extension
Size
18 KB
Dependencies
1 dependency · 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

npm version npm downloads license

Add aliases for long provider model IDs.

Use it when a provider model identifier is hard to type or hard to scan in the model picker. Pi will show and accept your alias, but provider requests are rewritten back to the original model ID before they are sent.

Install

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

Configuration

Create ~/.pi/agent/model-aliases.json and add one object for each alias you want:

{
  "$schema": "./model-aliases.schema.json",
  "aliases": [
    {
      "provider": "fireworks",
      "model": "accounts/fireworks/routers/kimi-k2p6-turbo",
      "alias": "kimi-k2.6-turbo",
      "name": "kimi-k2.6-turbo"
    }
  ]
}

Fields:

  • provider: the Pi provider ID that owns the original model.
  • model: the provider's real model ID.
  • alias: the short model ID you want to type or select in Pi.
  • name: the display name shown in model lists. This can match alias.

After configuration, the extension copies the original model configuration, adds the alias to Pi's model list, resolves lookups for the alias, and rewrites outgoing provider payloads back to the original model value.

License

MIT