npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@vibeathon-us/openrouter-launch

v1.1.0

Published

Launch AI coding tools with OpenRouter's 400+ model catalog

Downloads

376

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

kevnkkevnk

Keywords

openrouterclaudeaideropencodeaillmcli

Readme

openrouter-launch

Launch AI coding tools with OpenRouter's 400+ model catalog in one command.

Supports:

Quick Start

# Run directly (no install needed)
npx @vibeathon-us/openrouter-launch

# Or install globally
npm install -g @vibeathon-us/openrouter-launch
openrouter-launch

Features

  • Fuzzy search: Type to filter models, arrow keys to navigate
  • Cross-platform: Works on macOS, Linux, and Windows
  • Live model catalog: Fetches 300+ models from OpenRouter API
  • Smart caching: Model list cached for 1 hour at ~/.cache/openrouter/models.json
  • Coding-focused: Prioritizes popular coding models (Claude, GPT-4, Gemini, etc.)
  • Interactive model selection with pricing info
  • Model aliases (sonnet, opus, flash, etc.)
  • API key validation against OpenRouter
  • Persistent configuration (~/.openrouter-launch/config)
  • Quick launch mode for repeat usage

Installation

npm (Recommended - All Platforms)

# Run directly with npx (no install needed)
npx @vibeathon-us/openrouter-launch

# Or install globally
npm install -g @vibeathon-us/openrouter-launch
openrouter-launch

# Short alias also available
or-launch

Works on macOS, Linux, and Windows. Requires Node.js 18+.

From Source

git clone https://github.com/vibeathon-us/openrouter-launch.git
cd openrouter-launch
npm install
npm run build
npm link

Legacy: curl | bash (macOS/Linux)

Note: The bash version (v0.x) is legacy and no longer receives new features like fuzzy search. Consider using the npm version instead.

curl -fsSL https://raw.githubusercontent.com/vibeathon-us/openrouter-launch/main/install.sh | bash

Legacy: Homebrew (macOS/Linux)

Note: Homebrew installs the legacy bash version.

brew install vibeathon-us/tap/openrouter-launch

Usage

Interactive Mode

openrouter-launch

First run prompts for:

  1. OpenRouter API key (get one at https://openrouter.ai/keys)
  2. Model selection from 10 popular options

Quick Launch

# Use default model (after first run)
openrouter-launch claude

# Specify model by alias
openrouter-launch -m sonnet
openrouter-launch -m flash

# Specify full model name
openrouter-launch -m anthropic/claude-opus-4

# Save model as default
openrouter-launch -m sonnet --save-default

Using Aider

Aider has native OpenRouter support. openrouter-launch sets up the environment and passes your model selection:

# Launch Aider with Claude Sonnet
openrouter-launch aider -m sonnet

# Launch Aider with Gemini Flash
openrouter-launch aider -m flash

# Launch Aider with any OpenRouter model
openrouter-launch aider -m deepseek/deepseek-chat-v3

Aider-specific arguments are passed through:

# Aider with specific files
openrouter-launch aider -m sonnet -- src/main.py tests/

# Aider in architect mode
openrouter-launch aider -m opus -- --architect

Using OpenCode

OpenCode has native OpenRouter support. When OPENROUTER_API_KEY is set, OpenCode automatically detects and uses OpenRouter models:

# Launch OpenCode
openrouter-launch opencode

# Short alias
openrouter-launch oc

# With model selection (note: OpenCode may use its own model defaults)
openrouter-launch oc -m sonnet

OpenCode-specific arguments are passed through:

# OpenCode with specific working directory
openrouter-launch oc -- --cwd /path/to/project

Model Aliases

| Alias | Model | |-------|-------| | sonnet | anthropic/claude-sonnet-4 | | opus | anthropic/claude-opus-4 | | haiku | anthropic/claude-haiku | | flash | google/gemini-2.0-flash | | gemini | google/gemini-2.5-pro | | gpt4 | openai/gpt-4o | | gpt4-mini | openai/gpt-4o-mini | | deepseek | deepseek/deepseek-chat-v3 | | llama | meta-llama/llama-3.3-70b-instruct | | qwen | qwen/qwen-2.5-coder-32b-instruct |

Options

-m, --model MODEL        Use specific model (name or alias)
-k, --key KEY            Use API key (overrides saved key)
--save-default           Save the selected model as default
--refresh-models         Force refresh model list from API
--allow-data-collection  Allow providers to collect/train on data
--sort ORDER             Provider sort: price|throughput|latency
-h, --help               Show help message
-v, --version            Show version

Provider Preferences

OpenRouter routes requests to multiple AI providers. You can control how providers are selected:

Data Collection (default: deny)

By default, openrouter-launch only uses providers that do NOT collect or train on your data:

# Default behavior - deny data collection
openrouter-launch

# Explicitly allow providers that may collect data
openrouter-launch --allow-data-collection

Provider Sorting

Control how providers are prioritized:

# Prefer cheapest providers
openrouter-launch --sort price

# Prefer fastest token generation
openrouter-launch --sort throughput

# Prefer lowest latency (fastest first response)
openrouter-launch --sort latency

Note: Provider preferences are stored in your config but currently require OpenRouter account settings for full enforcement, as Claude Code's SDK doesn't support custom request body fields. This will be improved in future versions.

Configuration

Settings are stored in ~/.openrouter-launch/config:

OPENROUTER_API_KEY="sk-or-..."
DEFAULT_MODEL="anthropic/claude-sonnet-4"
DATA_COLLECTION="deny"
PROVIDER_SORT=""

The config file is created with 600 permissions (owner read/write only).

Model Caching

When jq is installed, openrouter-launch fetches the full model catalog from OpenRouter's API and caches it locally:

  • Cache location: ~/.cache/openrouter/models.json
  • Cache TTL: 1 hour (3600 seconds)
  • Fallback behavior:
    1. Use cached data if valid (< 1 hour old)
    2. Fetch fresh data if cache expired and online
    3. Use stale cache if fetch fails
    4. Use built-in model list if no cache and jq unavailable

Force a cache refresh with:

openrouter-launch --refresh-models

| Setting | Default | Description | |---------|---------|-------------| | OPENROUTER_API_KEY | - | Your OpenRouter API key | | DEFAULT_MODEL | - | Default model for quick launch | | DATA_COLLECTION | deny | Allow/deny provider data collection | | PROVIDER_SORT | - | Provider priority: price/throughput/latency |

Environment Variables

You can also set your API key via environment variable:

export OPENROUTER_API_KEY="sk-or-..."
openrouter-launch

Requirements

Legacy Bash Version (v0.x)

  • Bash 3.2+, curl, jq (optional)

How It Works

openrouter-launch sets the following environment variables before launching Claude Code:

ANTHROPIC_BASE_URL="https://openrouter.ai/api"
ANTHROPIC_API_KEY=""
ANTHROPIC_AUTH_TOKEN="<your-openrouter-key>"
ANTHROPIC_MODEL="<selected-model>"

This routes Claude Code's API requests through OpenRouter, allowing you to use any model in their catalog.

Uninstall

# npm version
npm uninstall -g @vibeathon-us/openrouter-launch

# Bash version
sudo make uninstall

# Remove config (both versions)
rm -rf ~/.openrouter-launch
rm -rf ~/.cache/openrouter

License

MIT