@cortexkit/pi-anthropic-auth

Pi package for CortexKit Anthropic OAuth support. It overrides Pi's built-in anthropic provider with a CortexKit provider extension backed by the shared @cortexkit/anthropic-auth-core package.

The Pi provider catalog includes Claude Fable 5 (claude-fable-5), limited-access Claude Mythos 5 (claude-mythos-5), Claude Opus 4.8, Claude Opus 4.5, Claude Sonnet 4.5, and Claude Sonnet 5 (claude-sonnet-5). Fable/Mythos reasoning uses Anthropic adaptive thinking with thinking.display: "summarized" and output_config.effort; the package does not send rejected manual thinking.budget_tokens for those models.

This package is part of the CortexKit Anthropic Auth monorepo, which supports both OpenCode (@cortexkit/opencode-anthropic-auth) and Pi (@cortexkit/pi-anthropic-auth) through the same shared core logic.

Install

Install with Pi's package manager:

pi install npm:@cortexkit/[email protected]

For an unpinned install:

pi install npm:@cortexkit/pi-anthropic-auth

To try it for one run without changing Pi settings:

pi -e npm:@cortexkit/pi-anthropic-auth

Restart Pi after installing, then authenticate through Pi's normal login flow:

/login anthropic

Sidecar config

Pi state is stored separately from OpenCode at:

~/.pi/agent/anthropic-auth.json

Override the path with PI_ANTHROPIC_AUTH_FILE. The package also respects PI_AGENT_DIR when deriving the default sidecar path.

The sidecar uses the same JSON shape as the OpenCode package, including routing, claudeCache, cacheKeep, claudeFast, dump, relay, and fallback accounts blocks. Runtime OAuth/quota state is stored in anthropic-auth-state.json; sticky session assignments are stored separately in anthropic-auth-routing-state.json with SHA-256-hashed session IDs.

Commands

/claude-cache
/claude-cache on
/claude-cache off
/claude-cache mode explicit
/claude-cache mode automatic
/claude-cache mode hybrid

/claude-cachekeep
/claude-cachekeep always
/claude-cachekeep 09-23
/claude-cachekeep off

/claude-dump
/claude-dump on
/claude-dump off

/claude-fast
/claude-fast on
/claude-fast off

/claude-routing
/claude-routing main-first
/claude-routing fallback-first
/claude-routing sticky-balanced
/claude-routing reset

/claude-quota

/claude-quota reports sidecar OAuth fallback quota state from ~/.pi/agent/anthropic-auth.json. /claude-routing fallback-first prefers usable OAuth fallback accounts before the main account; /claude-routing main-first restores the default. /claude-routing sticky-balanced assigns each Pi session to an OAuth account according to current 5-hour, 7-day, and matching model-scoped quota headroom, then persists that assignment across transient failures and process restarts. /claude-routing reset clears the current Pi session's assignment. Direct Opus sessions prefer usable accounts whose Fable quota is exhausted. API-key routes use the same sidecar shape as OpenCode and are sent directly to their configured Anthropic-compatible base URL, such as Kie's https://api.kie.ai/claude, but Pi only uses them after the main OAuth model response reports HTTP 429 or a streaming rate-limit error and a live quota check confirms 0% remaining. /claude-cachekeep always keeps active hybrid caches warm while Pi remains open; /claude-cachekeep HH-HH limits prewarms to a local time window. Both send max_tokens: 0 pre-warm requests about five minutes before the 1-hour TTL expires. Running /claude-cachekeep without arguments lists live tracked sessions across Pi processes through a temporary lease registry that stores only session IDs and cache timing. /claude-fast on adds Anthropic speed: "fast" plus the fast-mode-2026-02-01 beta header for supported Opus models (claude-opus-4-6, claude-opus-4-7, claude-opus-4-8, and claude-opus-5).

Relay

The Pi package can use the same user-owned Cloudflare relay config as the OpenCode package. The relay setup helper currently lives in the OpenCode package CLI:

CLOUDFLARE_API_TOKEN=... CLOUDFLARE_ACCOUNT_ID=... bunx @cortexkit/opencode-anthropic-auth relay setup

For Pi, copy the generated relay block into ~/.pi/agent/anthropic-auth.json.

License

MIT