---
slug: "ersintarhan-pi-toolkit"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/ersintarhan/pi-toolkit@main/README.md"
repo: "https://github.com/ersintarhan/pi-toolkit"
source_file: "README.md"
branch: "main"
---
# pi-toolkit

All-in-one pi extension toolkit.

Includes:
- **Providers**: `minimax`, `xiaomi-mimo`
- **Cache optimization** for Anthropic-compatible providers
- **Claude OAuth adapter** for Anthropic OAuth sessions
- **Native web search** with multiple backends + provider override
- **Context management** (`anchor`, `view`, `pivot`, `recall`)

> **Note:** The `kimi-coding` and `crofai` providers have been moved out of this package. For Kimi, install the dedicated provider such as [`pi-provider-kimi-code`](https://github.com/Leechael/pi-provider-kimi-code). CrofAI can be installed from its own package when needed.

## Install

```bash
pi install npm:@ersintarhan/pi-toolkit
```

Local development:

```bash
pi -e /Users/ersin/Projects/pi-extensions/pi-toolkit
```

## What this package does

### 1. Provider registration

Registers these providers:

| Provider | API | Notes |
|---|---|---|
| `minimax` | Anthropic-compatible | Cache-fixed stream path |
| `xiaomi-mimo` | Anthropic-compatible | Cache-fixed stream path, MiMo quirks handled |

For Kimi, use an external Kimi provider package (e.g. [`pi-provider-kimi-code`](https://github.com/Leechael/pi-provider-kimi-code)).

### 2. Cache optimization

For Anthropic-compatible providers (`minimax`, `xiaomi-mimo`), this package uses a custom cached stream implementation derived from the better-messages-cache approach.

It does three things:
- marks the last assistant `tool_use` block
- marks the last user block
- repairs partial/invalid streaming JSON during tool call parsing

This keeps cache loss lower across long agentic turns.

### 3. Claude OAuth adapter

When using `/model anthropic/...` with **Anthropic OAuth**:
- strips the Claude Code identity block
- injects the billing header Claude Code expects
- shows footer status like `✓ Claude OAuth ready/active`
- docs re-injection is disabled by default

### 4. Native search

Adds:
- `web_search`
- `web_fetch`
- `/search`

Supported native search backends:

| Backend | Search | Fetch | Auth |
|---|---|---|---|
| ZAI (GLM) | ✅ | ✅ | `ZAI_API_KEY` |
| Google Gemini | ✅ | ❌ | `GEMINI_API_KEY` |
| OpenAI | ✅ | ❌ | `OPENAI_API_KEY` |
| xAI | ✅ | ❌ | `XAI_API_KEY` |
| Anthropic | ✅ | ❌ | `ANTHROPIC_API_KEY` |
| Claude Code bridge | ✅ | ✅ | Claude CLI auth |
| Codex / ChatGPT | ✅ | ❌ | `codex login` / `~/.codex/auth.json` |
| Fallback | DuckDuckGo | HTTP fetch | none |

You can pin search to a provider independently from the active model.

Examples:

```bash
/search provider zai
/search provider openai
/search provider codex
/search provider auto
```

Or choose it from the TUI settings panel with `/search`.

### 5. Context management

Adds the `context` tool with:
- `view`
- `recall`
- `anchor`
- `pivot`

Also includes:
- status line (`context=`, `tool=`, `anchor=`)
- tool-result truncation before the last anchor
- anchor-aware cache support in the integrated context flow

## Provider usage

### MiniMax

```bash
/model minimax/MiniMax-M3
/model minimax/MiniMax-M2.7
```

Requires:
- `MINIMAX_API_KEY`

### Xiaomi MiMo

```bash
/model xiaomi-mimo/mimo-v2.5
/model xiaomi-mimo/mimo-v2.5-pro
```

Requires:
- `XIAOMI_TOKEN_PLAN_API_KEY`

Optional region override:

```bash
export XIAOMI_MIMO_BASE_URL=https://token-plan-ams.xiaomimimo.com/anthropic
```

### Kimi

The `kimi-coding` provider is no longer bundled. Install a dedicated Kimi provider package, for example:

```bash
pi install npm:pi-provider-kimi-code
# or via local path
pi -e /path/to/pi-provider-kimi-code
```

Then select Kimi as usual:

```bash
/model kimi-for-coding
```

> The upstream [`pi-provider-kimi-code`](https://github.com/Leechael/pi-provider-kimi-code) package is actively maintained and supports Kimi model discovery, OAuth, file uploads, and Kimi-specific payload mutations.

## `/usage` command

Shows quota / plan usage for the active provider.

Supported:

| Provider | Endpoint |
|---|---|
| `minimax` | `https://api.minimax.io/v1/token_plan/remains` |
| `xiaomi-mimo` | `https://platform.xiaomimimo.com/api/v1/tokenPlan/usage` |

Examples:

```bash
/usage
```

## `/context` command

Shows current context-window usage without adding the generated report to future LLM context.

It includes:

- total context usage and model window
- estimated category breakdown
- active tools and slash commands
- extension allocation by source/package
- cache read/write and cost stats

Example:

```bash
/context
```

## Search override examples

Use MiniMax for coding, but ZAI for search:

```bash
/model minimax/MiniMax-M3
/search provider zai
```

Use any model, but force Codex web search:

```bash
/search provider codex
```

Return to auto-detect:

```bash
/search provider auto
```

## Context workflow examples

Anchor after a completed phase:

```text
context(anchor, name="search-setup", summary="Search override configured to use ZAI.")
```

Pivot back to a clean checkpoint:

```text
context(pivot, target="search-setup", carryover="Search override is stable; Claude OAuth adapter handles Anthropic billing header.")
```

## Environment summary

Common env vars:

```bash
# MiniMax
export MINIMAX_API_KEY=...

# Xiaomi MiMo
export XIAOMI_TOKEN_PLAN_API_KEY=...
export XIAOMI_MIMO_BASE_URL=...

# Search backends
export ZAI_API_KEY=...
export GEMINI_API_KEY=...
export OPENAI_API_KEY=...
export XAI_API_KEY=...
export ANTHROPIC_API_KEY=...
```

## Compatibility notes

- Do **not** install older overlapping Kimi provider forks at the same time as a dedicated Kimi provider package.
- Local `pi -e ...` development may behave differently from installed npm packages for skill loading.
- Codex search requires `codex login` first.
- Claude OAuth adapter only activates for the `anthropic` provider when OAuth is actually in use.
- The `kimi-coding` and `crofai` providers were removed in v0.7.2. Use dedicated provider packages for them.

## Changelog

- **0.5.9** — Enforce Anthropic cache-control marker budget; lower default anchor-cache budget to 3.
- **0.5.8** — Stop copying `cache_control` onto synthetic Claude OAuth prompt block; strip foreign thinking signatures on provider switch.
- **0.5.7** — Guard Kimi stream bootstrap; restrict native web fetch to `http`/`https`.
- **0.5.6** — Show `toolShare=` only when tool-output share exceeds 50%.
- **0.5.5** — Add `/context` command for context-window usage reporting.
- **0.5.4** — Initial public release of `@ersintarhan/pi-toolkit`.

Full details: [CHANGELOG.md](https://github.com/ersintarhan/pi-toolkit/blob/HEAD/CHANGELOG.md).

## License

MIT