@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.

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/pi-anthropic-auth@1.0.0

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.

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 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-quota

/claude-quota reports sidecar fallback account quota state from ~/.pi/agent/anthropic-auth.json. /claude-routing fallback-first prefers usable fallback accounts before the main account; /claude-routing main-first restores the default. /claude-cachekeep HH-HH keeps recently used hybrid-mode session caches warm during the configured local time window by sending max_tokens: 0 pre-warm requests about five minutes before the 1-hour TTL expires. /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, and claude-opus-4-8).

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