claudish 1.3.0 → 1.3.1

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

@@ -299,6 +299,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 +317,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;
@@ -456,6 +451,55 @@ Available OpenRouter Models (in priority order):
 
 // 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 +4157,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,6 +1,6 @@
 {
   "name": "claudish",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "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",
@@ -31,7 +31,6 @@
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
     "@types/bun": "latest",
-    "@types/react": "^19.2.2",
     "typescript": "^5.7.0"
   },
   "files": [