# pi-kimi-usage

[![npm version](https://img.shields.io/npm/v/pi-kimi-usage)](https://www.npmjs.com/package/pi-kimi-usage)
[![GitHub release](https://img.shields.io/github/v/release/muffe/pi-kimi-usage)](https://github.com/muffe/pi-kimi-usage/releases)
[![pi package](https://img.shields.io/badge/pi-package-7c3aed)](https://shittycodingagent.ai/packages)
[![license: MIT](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)

A pi extension that shows compact Kimi usage info in the footer, only when a `kimi-coding` model is selected.

Example output:

```text
Kimi · 7d 6% 6d20h · 5h 28% 1h40m
```

![preview](./assets/preview.svg)

## Features

- Shows Kimi usage only for `kimi-coding` models
- Refreshes on session start, every 60 seconds, and on turn end
- Reads auth from:
  1. `KIMI_API_KEY`
  2. `~/.pi/agent/auth.json` → `kimi-coding.key`
     - literal key
     - env var name
     - shell command prefixed with `!`
- Uses `KIMI_CODE_BASE_URL` if set, otherwise defaults to `https://api.kimi.com/coding/v1/usages`

## Install

From npm:

```bash
pi install npm:pi-kimi-usage
```

From GitHub:

```bash
pi install git:github.com/muffe/pi-kimi-usage
```

npm package:
- https://www.npmjs.com/package/pi-kimi-usage

## Notes

This extension intentionally resolves `auth.json` shell-command keys (values starting with `!`) to match pi auth behavior.