Pi Charm Hyper Provider

中文版

Charm Hyper model provider extension for Pi.

Features

• Deterministic Async Model Registration: Pi awaits bounded model discovery during extension startup, so interactive startup and pi --list-models observe the same catalog. A fallback catalog is used when discovery is unavailable.
• Dynamic Pin Protection: Sync parses settings.json during early startup to dynamically append user-pinned models. This strictly prevents the Pi host from pruning custom or future models (such as glm-4-plus, glm-5.2 etc.) from your /model pin list.
• Compact Second-Line Credits Status: Fetches credits on session/model/turn events and every 35 seconds while Charm Hyper is active, caches results for 30 seconds, and merges the balance into Pi's second footer line through the custom compact footer.

Project Structure

pi-charm_hyper-provider/
├── index.ts                  # Pi extension entry point, provider registration, and compact footer
├── CONTEXT.md                # Domain terminology and credits health color thresholds
├── docs/
│   └── adr/
│       └── 0001-merged-provider-with-custom-credits-usage.md  # Architectural decision log
├── test/
│   ├── provider.test.ts      # Model registration and overrides test suite
│   └── usage.test.ts         # Credits monitoring, cache, and layout integration test suite
├── package.json              # Extension package configuration with peerDependencies
├── tsconfig.json             # TypeScript compiler settings
└── biome.json                # Code formatting and lint configuration

Installation

To install the extension globally:

pi install npm:pi-charm_hyper-provider

Testing

Run the native TypeScript unit test suite (Node.js native test runner):

npm run test

Development

We align with the code quality and security standards of the primary pi-main workspace:

• Linter & Formatter: Biome is configured to auto-format and check codebase. We use tab indentation with a width of 3 characters.
• Commands:
  • Check format and Lint: npm run check
  • Run tests: npm test

License

MIT