Pi Minimax Setup

Reference skill for the pi-mono fork's provider infrastructure and development tooling.

Fork Context

This is a fork of badlogic/pi-mono. Fork-specific configuration lives in locations upstream does not track to avoid merge conflicts on sync.

Sync with upstream: git fetch upstream && git rebase upstream/main

Dual-Tool Architecture

Two independent tools, two independent auth paths, no conflicts.

Developer workstation
├── Claude Code CLI (Max $200/mo subscription)
│    ├── Auth: claude.ai OAuth (subscriptionType: max)
│    ├── Models: Opus, Sonnet, Haiku (latest family)
│    └── Purpose: developing pi-mono source code
│
└── Pi Coding Agent (compiled binary)
     ├── Auth: 1Password service token → op read → Minimax API key
     ├── Model: MiniMax-M2.5-highspeed
     └── Purpose: running the pi coding agent with Minimax provider

Key rule: Do NOT set ANTHROPICAPIKEY in your environment. If set, Claude Code will use API billing instead of the Max subscription.

Auth Chain

~/.config/op/service-token          (0600, raw 1Password service token)
  ↓ sourced by
~/.zshrc                            (exports OP_SERVICE_ACCOUNT_TOKEN)
  ↓ used by
~/.pi/agent/auth.json               ("!op read 'op://Claude Automation/...'")
  ↓ resolves to
sk-cp-***                           (Minimax API key, never on disk)
  ↓ sent to
https://api.minimax.io/anthropic    (Anthropic-compatible endpoint)

auth.json Format

Located at ~/.pi/agent/auth.json (0600 permissions):

{
  "minimax": {
    "type": "api_key",
    "key": "!op read 'op://Claude Automation/MiniMax API - High-Speed Plan/password'"
  }
}

The ! prefix tells pi to execute the command and use stdout as the key value. With OPSERVICEACCOUNT_TOKEN set, op read runs silently (no biometric prompt).

1Password References

Credential Resolution Order (pi)

1. CLI --api-key flag
2. auth.json entry (API key or OAuth token)
3. Environment variable (MINIMAXAPIKEY)
4. Custom provider keys from models.json

MiniMax-M2.5-highspeed Specifications

Cost Comparison with Standard M2.5

Highspeed is exactly 2x cost for input/output/cache-read. Cache-write is identical. Same model, same context, same capabilities - flat 2x premium for lower latency.

Building Pi

From Source (development)

cd /Users/terryli/fork-tools/pi-mono
npm install
npm run build    # ~5s with tsgo

Run from source: ./pi-test.sh --provider minimax --model MiniMax-M2.5-highspeed

Standalone Binary (production, lowest resource usage)

cd packages/coding-agent
npm run build:binary    # bun build --compile → dist/pi

Produces an arm64 Mach-O binary at packages/coding-agent/dist/pi. Bundles the bun runtime - no Node.js needed at execution time.

Run binary: ./packages/coding-agent/dist/pi --provider minimax --model MiniMax-M2.5-highspeed

Optional: Symlink to PATH

ln -sf /Users/terryli/fork-tools/pi-mono/packages/coding-agent/dist/pi /usr/local/bin/pi

Validation Commands

Test Auth Chain (no biometric)

export OP_SERVICE_ACCOUNT_TOKEN="$(cat ~/.config/op/service-token)"
op read 'op://Claude Automation/MiniMax API - High-Speed Plan/password'

Test Minimax API Directly

curl -s -X POST "https://api.minimax.io/anthropic/v1/messages" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $(op read 'op://Claude Automation/MiniMax API - High-Speed Plan/password')" \
  -d '{"model":"MiniMax-M2.5-highspeed","max_tokens":50,"messages":[{"role":"user","content":"Say: PROBE OK"}]}'

Test Pi with Minimax

./pi-test.sh --provider minimax --model MiniMax-M2.5-highspeed --no-session --print "Say: PROBE OK"

Verify Claude Code Subscription

claude auth status
# Should show: subscriptionType: max, authMethod: claude.ai

TodoWrite Task Templates

Template A: Rebuild Pi Binary After Upstream Sync

1. [Preflight] Verify upstream remote: git remote -v
2. [Execute] Sync: git fetch upstream && git rebase upstream/main
3. [Execute] Rebuild: npm install && npm run build
4. [Execute] Rebuild binary: cd packages/coding-agent && npm run build:binary
5. [Verify] Test: ./packages/coding-agent/dist/pi --provider minimax --model MiniMax-M2.5-highspeed --no-session --print "PROBE OK"

Template B: Rotate Minimax API Key

1. [Preflight] Generate new key on MiniMax platform dashboard
2. [Execute] Update 1Password item "MiniMax API - High-Speed Plan" with new key
3. [Verify] Test auth chain: op read 'op://Claude Automation/MiniMax API - High-Speed Plan/password'
4. [Verify] Test API: curl probe against api.minimax.io/anthropic

Template C: Troubleshoot Auth Failure

1. [Preflight] Check service token: cat ~/.config/op/service-token | head -c 4 (should show "ops_")
2. [Preflight] Check OP_SERVICE_ACCOUNT_TOKEN is exported: echo $OP_SERVICE_ACCOUNT_TOKEN | head -c 4
3. [Preflight] Check auth.json exists: cat ~/.pi/agent/auth.json
4. [Execute] Test op read: op read 'op://Claude Automation/MiniMax API - High-Speed Plan/password'
5. [Execute] Test API directly with curl
6. [Verify] If op read fails: re-source ~/.zshrc or check service token file permissions

Template D: Add Another Provider to auth.json

1. [Preflight] Check supported providers: packages/coding-agent/docs/providers.md
2. [Preflight] Check env var name: packages/ai/src/env-api-keys.ts (envMap)
3. [Execute] Add entry to ~/.pi/agent/auth.json (literal key or !op read)
4. [Verify] Test: ./pi-test.sh --provider <name> --model <model> --no-session --print "PROBE OK"

Post-Change Checklist

After modifying this skill:

1. [ ] Auth chain diagram matches actual file locations
2. [ ] Model specs match packages/ai/src/models.generated.ts
3. [ ] 1Password item IDs are current
4. [ ] Validation commands still work
5. [ ] Append changes to [evolution-log.md](./references/evolution-log.md)