claudish 1.3.0 → 1.4.0

package/README.md

@@ -8,6 +8,7 @@
 
 - ✅ **Cross-platform** - Works with both Node.js and Bun (v1.3.0+)
 - ✅ **Universal compatibility** - Use with `npx` or `bunx` - no installation required
+- ✅ **Interactive setup** - Prompts for API key and model if not provided (zero config!)
 - ✅ **Monitor mode** - Proxy to real Anthropic API and log all traffic (for debugging)
 - ✅ **Protocol compliance** - 1:1 compatibility with Claude Code communication protocol
 - ✅ **Snapshot testing** - Comprehensive test suite with 13/13 passing tests
@@ -65,32 +66,33 @@ bun link           # or: npm link
 
 ## Quick Start
 
-### 1. Set up environment
+### Option 1: Interactive Mode (Easiest)
 
 ```bash
-# Copy example env file
-cp .env.example .env
+# Just run it - will prompt for API key and model
+claudish
 
-# Add your OpenRouter API key
-export OPENROUTER_API_KEY=sk-or-v1-...
-
-# Recommended: Set placeholder to avoid Claude Code's API key prompt
-export ANTHROPIC_API_KEY=sk-ant-api03-placeholder
+# Enter your OpenRouter API key when prompted
+# Select a model from the list
+# Start coding!
 ```
 
-### 2. Run claudish
+### Option 2: With Environment Variables
 
 ```bash
-# Basic usage (auto-approve enabled by default)
+# Set up environment
+export OPENROUTER_API_KEY=sk-or-v1-...
+export ANTHROPIC_API_KEY=sk-ant-api03-placeholder
+
+# Run with specific task
 claudish "implement user authentication"
 
-# Use specific model
+# Or with specific model
 claudish --model openai/gpt-5-codex "add tests"
-
-# Fully autonomous mode (auto-approve + dangerous)
-claudish --dangerous "refactor codebase"
 ```
 
+**Note:** In interactive mode, if `OPENROUTER_API_KEY` is not set, you'll be prompted to enter it. This makes first-time usage super simple!
+
 ## Usage
 
 ### Basic Syntax
@@ -119,13 +121,15 @@ claudish [OPTIONS] <claude-args...>
 
 | Variable | Description | Required |
 |----------|-------------|----------|
-| `OPENROUTER_API_KEY` | Your OpenRouter API key | ✅ Yes |
+| `OPENROUTER_API_KEY` | Your OpenRouter API key | ⚡ **Optional in interactive mode** (will prompt if not set)<br>✅ **Required in non-interactive mode** |
 | `ANTHROPIC_API_KEY` | Placeholder to prevent Claude Code dialog (not used for auth) | ✅ **Required** |
 | `CLAUDISH_MODEL` | Default model to use | ❌ No |
 | `CLAUDISH_PORT` | Default proxy port | ❌ No |
 | `CLAUDISH_ACTIVE_MODEL_NAME` | Automatically set by claudish to show active model in status line (read-only) | ❌ No |
 
-**Important:** You MUST set `ANTHROPIC_API_KEY=sk-ant-api03-placeholder` (or any value). Without it, Claude Code will show a dialog, and if you select "No", it will bypass the proxy and use real Anthropic API. Claudish now enforces this requirement.
+**Important Notes:**
+- **NEW in v1.3.0:** In interactive mode, if `OPENROUTER_API_KEY` is not set, you'll be prompted to enter it
+- You MUST set `ANTHROPIC_API_KEY=sk-ant-api03-placeholder` (or any value). Without it, Claude Code will show a dialog
 
 ## Available Models
 

package/dist/index.js

@@ -56,7 +56,9 @@ var ENV = {
   OPENROUTER_API_KEY: "OPENROUTER_API_KEY",
   CLAUDISH_MODEL: "CLAUDISH_MODEL",
   CLAUDISH_PORT: "CLAUDISH_PORT",
-  CLAUDISH_ACTIVE_MODEL_NAME: "CLAUDISH_ACTIVE_MODEL_NAME"
+  CLAUDISH_ACTIVE_MODEL_NAME: "CLAUDISH_ACTIVE_MODEL_NAME",
+  ANTHROPIC_MODEL: "ANTHROPIC_MODEL",
+  ANTHROPIC_SMALL_FAST_MODEL: "ANTHROPIC_SMALL_FAST_MODEL"
 };
 
 // src/claude-runner.ts
@@ -121,7 +123,9 @@ async function runClaudeWithProxy(config, proxyUrl) {
   const env = {
     ...process.env,
     ANTHROPIC_BASE_URL: proxyUrl,
-    [ENV.CLAUDISH_ACTIVE_MODEL_NAME]: modelId
+    [ENV.CLAUDISH_ACTIVE_MODEL_NAME]: modelId,
+    [ENV.ANTHROPIC_MODEL]: modelId,
+    [ENV.ANTHROPIC_SMALL_FAST_MODEL]: modelId
   };
   if (config.monitor) {
     delete env.ANTHROPIC_API_KEY;
@@ -216,9 +220,12 @@ function parseArgs(args) {
     stdin: false,
     claudeArgs: []
   };
-  const envModel = process.env[ENV.CLAUDISH_MODEL];
-  if (envModel) {
-    config.model = envModel;
+  const claudishModel = process.env[ENV.CLAUDISH_MODEL];
+  const anthropicModel = process.env[ENV.ANTHROPIC_MODEL];
+  if (claudishModel) {
+    config.model = claudishModel;
+  } else if (anthropicModel) {
+    config.model = anthropicModel;
   }
   const envPort = process.env[ENV.CLAUDISH_PORT];
   if (envPort) {
@@ -299,6 +306,9 @@ function parseArgs(args) {
     }
     i++;
   }
+  if ((!config.claudeArgs || config.claudeArgs.length === 0) && !config.stdin) {
+    config.interactive = true;
+  }
   if (config.monitor) {
     if (process.env.ANTHROPIC_API_KEY && process.env.ANTHROPIC_API_KEY.includes("placeholder")) {
       delete process.env.ANTHROPIC_API_KEY;
@@ -314,27 +324,19 @@ function parseArgs(args) {
   } else {
     const apiKey = process.env[ENV.OPENROUTER_API_KEY];
     if (!apiKey) {
-      console.error("Error: OPENROUTER_API_KEY environment variable is required");
-      console.error("Get your API key from: https://openrouter.ai/keys");
-      process.exit(1);
-    }
-    config.openrouterApiKey = apiKey;
-    if (!process.env.ANTHROPIC_API_KEY) {
-      console.error(`
-Error: ANTHROPIC_API_KEY is not set`);
-      console.error("This placeholder key is required to prevent Claude Code from prompting.");
-      console.error("");
-      console.error("Set it now:");
-      console.error("  export ANTHROPIC_API_KEY='sk-ant-api03-placeholder'");
-      console.error("");
-      console.error("Or add it to your shell profile (~/.zshrc or ~/.bashrc) to set permanently.");
-      console.error("");
-      console.error("Note: This key is NOT used for auth - claudish uses OPENROUTER_API_KEY");
-      process.exit(1);
+      if (!config.interactive) {
+        console.error("Error: OPENROUTER_API_KEY environment variable is required");
+        console.error("Get your API key from: https://openrouter.ai/keys");
+        console.error("");
+        console.error("Set it now:");
+        console.error("  export OPENROUTER_API_KEY='sk-or-v1-...'");
+        process.exit(1);
+      }
+      config.openrouterApiKey = undefined;
+    } else {
+      config.openrouterApiKey = apiKey;
     }
-  }
-  if (!config.claudeArgs || config.claudeArgs.length === 0) {
-    config.interactive = true;
+    config.anthropicApiKey = process.env.ANTHROPIC_API_KEY;
   }
   if (config.quiet === undefined) {
     config.quiet = !config.interactive;
@@ -345,7 +347,7 @@ Error: ANTHROPIC_API_KEY is not set`);
   return config;
 }
 function printVersion() {
-  console.log("claudish version 1.3.0");
+  console.log("claudish version 1.3.1");
 }
 function printHelp() {
   console.log(`
@@ -387,7 +389,9 @@ NOTES:
 
 ENVIRONMENT VARIABLES:
   OPENROUTER_API_KEY              Required: Your OpenRouter API key
-  CLAUDISH_MODEL                  Default model to use
+  CLAUDISH_MODEL                  Default model to use (takes priority)
+  ANTHROPIC_MODEL                 Claude Code standard: model to use (fallback if CLAUDISH_MODEL not set)
+  ANTHROPIC_SMALL_FAST_MODEL      Claude Code standard: fast model (auto-set by claudish)
   CLAUDISH_PORT                   Default port for proxy
   CLAUDISH_ACTIVE_MODEL_NAME      Auto-set by claudish (read-only) - shows active model in status line
 
@@ -450,12 +454,62 @@ Available OpenRouter Models (in priority order):
     console.log("");
   }
   console.log("Set default with: export CLAUDISH_MODEL=<model>");
+  console.log("               or: export ANTHROPIC_MODEL=<model>");
   console.log(`Or use: claudish --model <model> ...
 `);
 }
 
 // src/simple-selector.ts
 import { createInterface } from "readline";
+async function promptForApiKey() {
+  return new Promise((resolve) => {
+    console.log(`
+\x1B[1m\x1B[36mOpenRouter API Key Required\x1B[0m
+`);
+    console.log(`\x1B[2mGet your free API key from: https://openrouter.ai/keys\x1B[0m
+`);
+    console.log("Enter your OpenRouter API key:");
+    console.log(`\x1B[2m(it will not be saved, only used for this session)\x1B[0m
+`);
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout,
+      terminal: false
+    });
+    let apiKey = null;
+    rl.on("line", (input) => {
+      const trimmed = input.trim();
+      if (!trimmed) {
+        console.log("\x1B[31mError: API key cannot be empty\x1B[0m");
+        return;
+      }
+      if (!trimmed.startsWith("sk-or-v1-")) {
+        console.log("\x1B[33mWarning: OpenRouter API keys usually start with 'sk-or-v1-'\x1B[0m");
+        console.log("\x1B[2mContinuing anyway...\x1B[0m");
+      }
+      apiKey = trimmed;
+      rl.close();
+    });
+    rl.on("close", () => {
+      if (apiKey) {
+        process.stdin.pause();
+        process.stdin.removeAllListeners("data");
+        process.stdin.removeAllListeners("end");
+        process.stdin.removeAllListeners("error");
+        process.stdin.removeAllListeners("readable");
+        if (process.stdin.isTTY && process.stdin.setRawMode) {
+          process.stdin.setRawMode(false);
+        }
+        setTimeout(() => {
+          resolve(apiKey);
+        }, 200);
+      } else {
+        console.error("\x1B[31mError: API key is required\x1B[0m");
+        process.exit(1);
+      }
+    });
+  });
+}
 async function selectModelInteractively() {
   return new Promise((resolve) => {
     console.log(`
@@ -4113,6 +4167,10 @@ async function main() {
       console.error("Install it from: https://claude.com/claude-code");
       process.exit(1);
     }
+    if (config.interactive && !config.monitor && !config.openrouterApiKey) {
+      config.openrouterApiKey = await promptForApiKey();
+      console.log("");
+    }
     if (config.interactive && !config.monitor && !config.model) {
       config.model = await selectModelInteractively();
       console.log("");

package/package.json

@@ -1,29 +1,12 @@
 {
   "name": "claudish",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "CLI tool to run Claude Code with any OpenRouter model (Grok, GPT-5, MiniMax, etc.) via local Anthropic API-compatible proxy",
   "type": "module",
   "main": "./dist/index.js",
   "bin": {
     "claudish": "dist/index.js"
   },
-  "scripts": {
-    "dev": "bun run src/index.ts",
-    "dev:grok": "bun run src/index.ts --interactive --model x-ai/grok-code-fast-1",
-    "dev:grok:debug": "bun run src/index.ts --interactive --debug --log-level info --model x-ai/grok-code-fast-1",
-    "dev:info": "bun run src/index.ts --interactive --monitor",
-    "build": "bun build src/index.ts --outdir dist --target node && chmod +x dist/index.js",
-    "link": "npm link",
-    "unlink": "npm unlink -g claudish",
-    "install-global": "bun run build && npm link",
-    "kill-all": "pkill -f 'bun.*claudish' || pkill -f 'claude.*claudish-settings' || echo 'No claudish processes found'",
-    "test": "bun test ./tests/comprehensive-model-test.ts",
-    "typecheck": "tsc --noEmit",
-    "lint": "biome check .",
-    "format": "biome format --write .",
-    "install": "bun run build && bun link",
-    "postinstall": "node scripts/postinstall.cjs"
-  },
   "dependencies": {
     "hono": "^4.9.0",
     "@hono/node-server": "^1.13.7"
@@ -31,7 +14,6 @@
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
     "@types/bun": "latest",
-    "@types/react": "^19.2.2",
     "typescript": "^5.7.0"
   },
   "files": [
@@ -52,5 +34,22 @@
     "ai"
   ],
   "author": "Jack Rudenko <i@madappgang.com>",
-  "license": "MIT"
-}
+  "license": "MIT",
+  "scripts": {
+    "dev": "bun run src/index.ts",
+    "dev:grok": "bun run src/index.ts --interactive --model x-ai/grok-code-fast-1",
+    "dev:grok:debug": "bun run src/index.ts --interactive --debug --log-level info --model x-ai/grok-code-fast-1",
+    "dev:info": "bun run src/index.ts --interactive --monitor",
+    "build": "bun build src/index.ts --outdir dist --target node && chmod +x dist/index.js",
+    "link": "npm link",
+    "unlink": "npm unlink -g claudish",
+    "install-global": "bun run build && npm link",
+    "kill-all": "pkill -f 'bun.*claudish' || pkill -f 'claude.*claudish-settings' || echo 'No claudish processes found'",
+    "test": "bun test ./tests/comprehensive-model-test.ts",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check .",
+    "format": "biome format --write .",
+    "install": "bun run build && bun link",
+    "postinstall": "node scripts/postinstall.cjs"
+  }
+}