# OpenRouter DevTools CLI

> SDK DevTools and utilities for OpenRouter development

[![npm version](https://badge.fury.io/js/%40openrouter%2Fcli.svg)](https://www.npmjs.com/package/@openrouter/cli)

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

### DevTools Viewer

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

### StatusLine

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](./MIGRATION.md) for details.

## License

SEE LICENSE IN LICENSE