Multi-subscription extension for pi -- use multiple OAuth accounts per provider (Anthropic, Codex, Copilot, Gemini, Antigravity) with automatic rate-limit rotation and project-level affinity.

Summary

hjanuschka/pi-multi-pass is a pi assistant extension that enables users to leverage multiple AI provider subscriptions (Anthropic, Codex, Copilot, Gemini, Antigravity) simultaneously. It addresses the challenge of rate limits and subscription management by allowing multiple OAuth accounts per provider, automatically rotating through them to ensure uninterrupted service. This benefits power users who subscribe to various AI models or have multiple accounts for different purposes, providing a seamless experience by preventing service interruptions due to rate limiting.

How It Works

The extension manages subscriptions through "rotation pools," which group accounts for a specific provider. When an account hits a rate limit, pi-multi-pass automatically switches to another eligible member within the pool. Advanced strategies like quota-first (prioritizing accounts with more remaining quota), scheduled (time-based availability), and custom (user-defined JS scripts) offer sophisticated failover logic beyond simple round-robin. "Fallback chains" define ordered sequences for trying different pools or models, while "model presets" act as named shortcuts for specific routing intents (e.g., "coding-premium"). Project-specific configurations (.pi/multi-pass.json) allow fine-grained control over which subscriptions, pools, or chains are active for particular projects, enabling separation of work and personal accounts.

Quick Start & Requirements

• Installation: Install via pi using npm:pi-multi-pass or git:github.com/hjanuschka/pi-multi-pass.
• Prerequisites: Requires the pi assistant and authentication credentials for each AI provider. No specific hardware or OS dependencies are listed.
• Management: Primarily managed through interactive TUI commands like /subs add, /login, /pool create, and /mp-preset create.

Highlighted Details

• Supports multiple OAuth accounts per provider for Anthropic, OpenAI Codex, GitHub Copilot, Google Gemini, and Antigravity.
• Automatic rate-limit rotation ensures continuous service by switching to available accounts.
• Advanced pool strategies include quota-first, scheduled, and custom JS selectors for intelligent failover.
• Project-level affinity via .pi/multi-pass.json allows restricting active subscriptions and pools per project.
• Built-in limits checks provide visibility into subscription headroom for Codex and Google providers.
• Model presets offer named routing shortcuts for specific use cases.

Maintenance & Community

No specific details on contributors, sponsorships, or community channels were found in the provided README.

Licensing & Compatibility

• License: MIT License.
• Compatibility: Permissive license suitable for commercial use and integration with closed-source applications.

Limitations & Caveats

The README does not explicitly detail limitations. However, advanced configuration options like custom JS selector scripts require significant technical expertise. Built-in quota checking and automatic failover based on quota are currently limited to Codex and Google Gemini providers.