OpenRouter DevTools CLI

> SDK DevTools and utilities for OpenRouter development


Features

- 📊 SDK DevTools Viewer - Visualize OpenRouter SDK telemetry in a beautiful web UI
- 📈 StatusLine Integration - Claude Code statusline showing model and token usage

Installation

``bash
npm install -g @openrouter/cli
`

Commands

$3

Launch the SDK DevTools viewer to visualize telemetry:

`bash
openrouter devtools
`

Opens web UI at http://localhost:4983

Setup:

1. Install devtools in your project:
`bash
npm install @openrouter/devtools
`

2. Initialize SDK with devtools hooks:
`typescript
import { createOpenRouterDevtools } from '@openrouter/devtools';
import { OpenRouter } from '@openrouter/sdk';

const sdk = new OpenRouter({
apiKey: process.env.OPENROUTER_API_KEY,
hooks: createOpenRouterDevtools()
});
`

3. Run your app - telemetry is captured to .devtools/

4. Launch viewer:
`bash
openrouter devtools
`

$3

For Claude Code users, add a statusline showing model and token usage:

`bash
openrouter statusline
`

Configure in Claude Code settings to display:
- Current directory
- Git branch
- Model name
- Input/output tokens

Configuration

Optional config at ~/.openrouter/claude-code-proxy.json:

`json
{
"LOG": true,
"LOG_LEVEL": "debug",
"DEVTOOLS_PORT": 4983,
"StatusLine": {
"currentStyle": "default"
}
}
`

Development

`bash
bun install
bun run build
bun test
``

Migration from v0.x

Breaking change: v1.0.0 removes all proxy functionality (start/stop/restart/code commands).

See MIGRATION.md for details.

License

SEE LICENSE IN LICENSE