AllRouter

[ English | 中文 ]

ar is a powerful, interactive, dropdown-first launcher for AllRouter-compatible AI coding agents. It serves as a single central hub to manage your accounts, models, endpoints, and CLI tools, providing a fast and unified experience.

Note: The tool has currently been tested with Hermes, OpenCode, and Claude Code so far.

✨ New Features in the Latest Release

• Dynamic Model Fetching & Tabbed Navigation: Models are now fetched dynamically from the provider API and neatly organized into intuitive tabs (press Tab or Arrow Keys to switch).
• Universal Bypass Mode: Toggle permissions globally for all connected AI agents (skip repetitive prompts automatically).
• Session History Table: ar prev now renders a beautiful aligned tabular history with access timestamps.
• On-the-fly Account Renaming: Quickly rename your accounts through the interactive accounts menu.
• Model Aliases: Assign short aliases to lengthy model names (e.g., opus-think to claude-opus-5-thinking) to speed up CLI launching.

⚡ Quick Start Flow

The ar command is your main entry point. Follow this simple flow to get started:

1. Install: npm install -g allrouter (Requires Node.js 20.11+)
2. Launch: Run ar to open the main menu.
3. Add Account: Select "Manage Accounts" -> "Add account" and paste your token.
4. Configure Settings: Set your global security preferences (Normal Mode vs. Bypass Mode).
5. Pick Tool & Model: Go to "Launch Tool", pick your agent, and easily Tab between providers to choose your preferred dynamic model.

🛠️ Commands & Shortcuts

ar is designed to be blazing fast and easy to use. You can launch tools interactively or use direct shortcuts.

Interactive Menus

ar                         # Open the main interactive menu
ar launch (or: ar l)       # Launch a tool (Tool → Account → Model)
ar prev (or: ar p)         # Resume a previous session from the history table
ar models (or: ar m)       # Manage your AI models & aliases
ar accounts                # Manage your accounts & rename them
ar endpoints               # Manage your custom endpoints
ar tools                   # See all supported tools & install status
ar setup                   # View guided setup instructions for desktop/GUI clients

Direct Launch Shortcuts

Bypass the main menu and directly launch your favorite AI coding agent:

ar claude                  # Launch Claude Code
ar opencode                # Launch OpenCode
ar hermes                  # Launch Hermes
ar codex                   # Launch Codex
ar qwen                    # Launch Qwen Code
ar pi                      # Launch Pi
ar crush                   # Launch Crush

Advanced CLI Tricks

ar prev --clear            # Instantly clear your session history
ar claude --model <alias>  # Launch using a custom model alias
ar l claude -- --resume 1  # Pass arguments directly to the underlying tool

✨ Why use AllRouter (ar)?

• Interactive UI: Navigate easily using arrow keys and dropdown menus instead of manually typing selections.
• Unified Account Store: Enter your API keys and accounts once, and reuse them instantly across any supported coding agent.
• Smart Protocol Routing: Models are protocol-aware (anthropic vs openai). ar will automatically choose the correct endpoint shape depending on the model you select.
• Multiple Endpoints: Set up different profiles with both Anthropic and OpenAI-compatible URLs effortlessly.
• Wide Client Support: Direct launch adapters for the best CLI tools, plus built-in setup guides for GUI clients like Cursor, Trae, Roo Code, Cline, and more.

🔒 Security First

Your API secrets are treated with the utmost care. They will never appear in ar list, config files, or generated scripts.

• Windows: Tokens are securely encrypted using the current user's DPAPI (ConvertFrom-SecureString), tying the keys strictly to your Windows user account.
• macOS / Linux: Tokens are encrypted with AES-256-GCM using a random 32-byte key generated locally and stored securely at ~/.ar/master.key (with strict 0600 permissions).

👨‍💻 Development & Contributing

We welcome contributions! Please see our Contributing Guide for more details.

Handy Dev Commands:

npm run check        # Run linter, verify files, and scan for secrets
npm test             # Run unit and CLI tests
npm run smoke        # Pack and install into a sandbox to verify the real binary
npm run verify       # Run check, test, and smoke in order
npm run clean        # Clean up temporary test files