@openrouter/cli - npm Package Compare versions

Comparing version 0.0.19 to 1.0.0-pr-10990.442bfe2

package.json

 {
   "name": "@openrouter/cli",
-  "version": "0.0.19",
-  "description": "Use OpenRouter to access Claude Code using any model, and more!",
+  "version": "1.0.0-pr-10990.442bfe2",
+  "description": "SDK DevTools and utilities for OpenRouter development",
   "type": "module",
+  "files": [
+    "dist/cli",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
   "bin": {
-    "openrouter": "./dist/cli.js"
+    "openrouter": "./dist/cli"
   },
   "scripts": {
-    "build": "bun run scripts/build.ts",
+    "build": "bun scripts/build.ts",
+    "build:devtools": "vite build --config src/devtools/vite.config.ts",
     "dev": "bun run src/cli.ts",
+    "dev:devtools": "vite --config src/devtools/vite.config.ts",
     "lint": "biome check",
+    "release": "cd ../.. && pnpm tsx scripts/release-cli.ts",
+    "tag": "VERSION=$(node -e \"console.log(require('./package.json').version)\") && git tag v$VERSION && git push origin v$VERSION",
     "test": "bun test",
-    "test:watch": "bun test --watch",
-    "release": "bun run build && bun publish",
-    "tag": "VERSION=$(node -e \"console.log(require('./package.json').version)\") && git tag v$VERSION && git push origin v$VERSION"
+    "test:watch": "bun test --watch"
   },
-  "keywords": [
-    "claude",
-    "code",
-    "router",
-    "llm",
-    "anthropic",
-    "openrouter"
-  ],
-  "author": "openrouter",
-  "license": "SEE LICENSE IN LICENSE",
-  "files": [
-    "dist/cli.js",
-    "dist/tiktoken_bg.wasm",
-    "README.md",
-    "LICENSE",
-    "package.json"
-  ],
+  "dependencies": {
+    "@hono/node-server": "^1.19.2",
+    "@openrouter/devtools": "workspace:*",
+    "hono": "^4.9.6",
+    "vaul": "^1.1.2"
+  },
   "devDependencies": {
+    "@openrouter/sdk": "0.1.3",
+    "@radix-ui/colors": "^3.0.0",
+    "@radix-ui/react-collapsible": "^1.1.2",
+    "@radix-ui/react-scroll-area": "^1.2.2",
+    "@radix-ui/react-slot": "^1.1.1",
+    "@radix-ui/react-tooltip": "^1.1.8",
+    "@tailwindcss/typography": "^0.5.16",
+    "@types/bun": "^1.2.21",
+    "@types/react": "^18.3.18",
+    "@types/react-dom": "^18.3.5",
+    "@vitejs/plugin-react": "^4.3.4",
+    "autoprefixer": "^10.4.21",
     "biome": "^0.3.3",
-    "openurl": "^1.1.1",
+    "bun": "latest",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "date-fns": "4.1.0",
     "dotenv": "^16.6.1",
-    "@types/bun": "^1.2.21",
-    "@types/node": "^24.3.1",
-    "bun": "latest",
-    "@hono/node-server": "^1.19.2",
-    "@openrouter/sdk": "0.1.3",
     "enquirer": "^2.4.1",
-    "hono": "^4.9.6",
     "json5": "^2.2.3",
+    "lucide-react": "^0.469.0",
+    "openurl": "^1.1.1",
     "pino-rotating-file-stream": "^0.0.2",
-    "tiktoken": "^1.0.22",
+    "postcss": "^8.5.6",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "tailwind-merge": "^3.4.0",
+    "tailwind-scrollbar-hide": "^2.0.0",
+    "tailwindcss": "^3.4.16",
+    "tailwindcss-animate": "^1.0.7",
+    "typescript": "^5.9.2",
     "uuid": "^11.1.0",
-    "zod": "^3.25.76",
-    "typescript": "^5.9.2"
+    "vite": "^6.0.7",
+    "windy-radix-palette": "^2.0.0-beta.7",
+    "zod": "^3.25.76"
   },
@@ -59,3 +75,13 @@ "publishConfig": {
     ]
-  }
+  },
+  "keywords": [
+    "claude",
+    "code",
+    "router",
+    "llm",
+    "anthropic",
+    "openrouter"
+  ],
+  "author": "openrouter",
+  "license": "SEE LICENSE IN LICENSE"
 }

README.md

@@ -1,69 +0,80 @@
-# OpenRouter CLI
+# OpenRouter DevTools CLI
 
-> A powerful command-line interface for OpenRouter, enabling seamless integration with multiple language models and AI services. Currently featuring Claude Code integration with more capabilities coming soon.
+> SDK DevTools and utilities for OpenRouter development
 
-## ✨ Features
+[![npm version](https://badge.fury.io/js/%40openrouter%2Fcli.svg)](https://www.npmjs.com/package/@openrouter/cli)
 
-- **Multi-Model Support**: Access any model available on OpenRouter through a unified interface
-- **Claude Code Integration**: Use any OpenRouter model with Claude Code for enhanced development workflows
-- **Smart Model Routing**: Automatically route requests to optimal models based on task type (reasoning, long context, web search, etc.)
-- **Dynamic Model Switching**: Change models on-the-fly using simple commands
-- **Extensible Architecture**: Built to support future OpenRouter features and integrations
+## Features
 
-## 🚀 Getting Started
+- 📊 **SDK DevTools Viewer** - Visualize OpenRouter SDK telemetry in a beautiful web UI
+- 📈 **StatusLine Integration** - Claude Code statusline showing model and token usage
 
-### 1. Installation
+## Installation
 
-Install the OpenRouter CLI:
-
-```shell
+```bash
 npm install -g @openrouter/cli
 ```
 
-For Claude Code integration, ensure you have [Claude Code](https://docs.anthropic.com/en/docs/claude-code/quickstart) installed:
+## Commands
 
-```shell
-npm install -g @anthropic-ai/claude-code
+### DevTools Viewer
+
+Launch the SDK DevTools viewer to visualize telemetry:
+
+```bash
+openrouter devtools
 ```
 
-### 2. Configuration
+Opens web UI at http://localhost:4983
 
-Create and configure your `~/.openrouter/claude-code-proxy.json` file. For more details, see "Example Configuration" below.
+**Setup:**
 
-The configuration file supports several key sections:
+1. Install devtools in your project:
+   ```bash
+   npm install @openrouter/devtools
+   ```
 
-- **`OPENROUTER_API_KEY`**: Your OpenRouter API key for accessing models
-- **`LOG`** (optional): Enable/disable logging. Default is `true`
-- **`LOG_LEVEL`** (optional): Set logging verbosity: `"fatal"`, `"error"`, `"warn"`, `"info"`, `"debug"`, `"trace"`. Default is `"debug"`
-- **Logging Systems**: The OpenRouter CLI uses two separate logging systems:
-  - **Server logs**: HTTP requests and API events in `~/.openrouter/logs/`
-  - **Application logs**: Routing decisions and operations in `~/.openrouter/router.log`
-- **`models`**: Configure model routing for different task types
-- **`API_TIMEOUT_MS`**: API call timeout in milliseconds
+2. Initialize SDK with devtools hooks:
+   ```typescript
+   import { createOpenRouterDevtools } from '@openrouter/devtools';
+   import { OpenRouter } from '@openrouter/sdk';
 
-#### Environment Variable Support
+   const sdk = new OpenRouter({
+     apiKey: process.env.OPENROUTER_API_KEY,
+     hooks: createOpenRouterDevtools()
+   });
+   ```
 
-The OpenRouter CLI supports environment variable interpolation for secure credential management. Reference environment variables in your config using `$VAR_NAME` or `${VAR_NAME}` syntax:
+3. Run your app - telemetry is captured to `.devtools/`
 
-```json
-{
-  "OPENROUTER_API_KEY": "$OPENROUTER_API_KEY"
-}
+4. Launch viewer:
+   ```bash
+   openrouter devtools
+   ```
+
+### StatusLine
+
+For Claude Code users, add a statusline showing model and token usage:
+
+```bash
+openrouter statusline
 ```
 
-Keep sensitive credentials secure by storing them as environment variables rather than in configuration files.
+Configure in Claude Code settings to display:
+- Current directory
+- Git branch
+- Model name
+- Input/output tokens
 
-#### Example Configuration
+## Configuration
 
+Optional config at `~/.openrouter/claude-code-proxy.json`:
+
 ```json
 {
-  "OPENROUTER_API_KEY": "$OPENROUTER_API_KEY",
   "LOG": true,
-  "models": {
-    "default": "deepseek/deepseek-chat",
-    "background": "qwen/qwen3-30b-a3b",
-    "think": "deepseek/deepseek-reasoner",
-    "longContext": "google/gemini-2.5-pro-preview",
-    "longContextThreshold": 60000,
-    "webSearch": "google/gemini-2.5-flash:online"
+  "LOG_LEVEL": "debug",
+  "DEVTOOLS_PORT": 4983,
+  "StatusLine": {
+    "currentStyle": "default"
   }
@@ -73,91 +84,18 @@ }
 
-### 3. Usage
+## Development
 
-#### Claude Code Integration
-
-Use any OpenRouter model with Claude Code:
-
-```shell
-openrouter code "your prompt here"
-```
-
-#### Service Management
-
-```shell
-openrouter proxy start    # Start the proxy service
-openrouter proxy stop     # Stop the proxy service
-openrouter proxy restart  # Restart the service (required after config changes)
-openrouter proxy status   # Check service status
-```
-
-### 4. Model Routing
-
-Configure intelligent model routing based on task requirements:
-
-- **`default`**: Primary model for general tasks
-- **`background`**: Cost-efficient model for background operations
-- **`think`**: Advanced reasoning model for complex problem-solving
-- **`longContext`**: Model optimized for large context windows (>60K tokens)
-- **`longContextThreshold`**: Token threshold for automatic long-context routing (default: 60000)
-- **`webSearch`**: Model with web search capabilities (append `:online` to model name)
-
-#### Dynamic Model Selection
-
-Switch models on-the-fly within Claude Code:
-
-```shell
-/model anthropic/claude-sonnet-4
-```
-
-## Developing
-
-### Installation
-
-Make sure you have bun.
-
-```
+```bash
 bun install
+bun run build
+bun test
 ```
 
-### Running locally
+## Migration from v0.x
 
-All `openrouter` commands above via `npm dev`:
+**Breaking change:** v1.0.0 removes all proxy functionality (start/stop/restart/code commands).
 
-```
-bun run dev proxy start
-bun run dev proxy status
-bun run dev code
-bun run dev proxy stop
-```
+See [MIGRATION.md](./MIGRATION.md) for details.
 
-### Testing your built package locally with npm
+## License
 
-```
-bun run build
-bun pm pack
-
-# local npm install
-cd /path/to/somewhere
-npm uninstall @openrouter/cli
-npm install /path/to/cli/openrouter-cli-version-number.tgz
-node_modules/.bin/openrouter proxy start
-node_modules/.bin/openrouter code
-
-# global npm install
-npm uninstall -g @openrouter/cli
-npm install -g /path/to/cli/openrouter-cli-version-number.tgz
-openrouter proxy start
-openrouter code
-```
-
-## 🚧 Coming Soon
-
-The OpenRouter CLI is actively expanding to support:
-
-- Direct model querying/chat
-- Ability to intercept all calls on your system to openai or anthropic through your openai account to use any model
-- API usage monitoring and analytics
-- Account management
-- And much more!
-
-Stay tuned for updates as we build out the complete OpenRouter experience.
+SEE LICENSE IN LICENSE

New alerts

Empty package

Supply chain risk

Package does not contain any code. It may be removed, is name squatting, or the result of a faulty package publish.

Native code

Supply chain risk

Contains native code (e.g., compiled binaries or shared libraries). Including native code can obscure malicious behavior.

Major refactor

Supply chain risk

Package has recently undergone a major refactor. It may be unstable or indicate significant internal changes. Use caution when updating to versions that include significant changes.

New author

Supply chain risk

A new npm collaborator published a version of the package for the first time. New collaborators are usually benign additions to a project, but do indicate a change to the security surface area of a package.

Fixed alerts

Network access

Supply chain risk

This module accesses the network.

Uses eval

Supply chain risk

Package uses dynamic code execution (e.g., eval()), which is a dangerous practice. This can prevent the code from running in certain environments and increases the risk that the code may contain exploits or malicious behavior.

Environment variable access

Supply chain risk

Package accesses environment variables, which may be a sign of credential stuffing or data theft.

Found 9 instances

Long strings

Supply chain risk

Contains long string literals, which may be a sign of obfuscated or packed code.

Minified code

Quality

This package contains minified code. This may be harmless in some cases where minified code is included in packaged libraries, however packages on npm should not minify code.

URL strings

Supply chain risk

Package contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.

Improved metrics

Total package byte prevSize

105050092

1633.61%

Number of low quality alerts

2

-33.33%

Number of low supply chain risk alerts

1

-96%

Number of medium supply chain risk alerts

4

-66.67%

Worsened metrics

Dependency count

4

Infinity%

Dev dependency count

35

118.75%

Number of package files

4

-20%

Lines of code

0

-100%

Number of lines in readme file

101

-38.04%

Dependency changes

• + Added

  @hono/node-server@^1.19.2

• + Added

  @openrouter/devtools@workspace:*

• + Added

  hono@^4.9.6

• + Added

  vaul@^1.1.2

• + Added

  @hono/node-server@1.19.15
  (transitive)

• + Added

  @radix-ui/primitive@1.1.7
  (transitive)

• + Added

  @radix-ui/react-compose-refs@1.1.5
  (transitive)

• + Added

  @radix-ui/react-context@1.2.2
  (transitive)

• + Added

  @radix-ui/react-dialog@1.1.23
  (transitive)

• + Added

  @radix-ui/react-dismissable-layer@1.1.19
  (transitive)

• + Added

  @radix-ui/react-focus-guards@1.1.6
  (transitive)

• + Added

  @radix-ui/react-focus-scope@1.1.16
  (transitive)

• + Added

  @radix-ui/react-id@1.1.4
  (transitive)

• + Added

  @radix-ui/react-portal@1.1.17
  (transitive)

• + Added

  @radix-ui/react-presence@1.1.10
  (transitive)

• + Added

  @radix-ui/react-primitive@2.1.10
  (transitive)

• + Added

  @radix-ui/react-slot@1.3.3
  (transitive)

• + Added

  @radix-ui/react-use-callback-ref@1.1.4
  (transitive)

• + Added

  @radix-ui/react-use-controllable-state@1.2.6
  (transitive)

• + Added

  @radix-ui/react-use-effect-event@0.0.5
  (transitive)

• + Added

  @radix-ui/react-use-layout-effect@1.1.4
  (transitive)

• + Added

  aria-hidden@1.2.6
  (transitive)

• + Added

  detect-node-es@1.1.0
  (transitive)

• + Added

  get-nonce@1.0.1
  (transitive)

• + Added

  hono@4.12.32
  (transitive)

• + Added

  react@19.2.8
  (transitive)

• + Added

  react-dom@19.2.8
  (transitive)

• + Added

  react-remove-scroll@2.7.2
  (transitive)

• + Added

  react-remove-scroll-bar@2.3.8
  (transitive)

• + Added

  react-style-singleton@2.2.3
  (transitive)

• + Added

  scheduler@0.27.0
  (transitive)

• + Added

  tslib@2.8.1
  (transitive)

• + Added

  use-callback-ref@1.3.3
  (transitive)

• + Added

  use-sidecar@1.1.3
  (transitive)

• + Added

  vaul@1.1.2
  (transitive)