claude-overnight 1.17.2 → 1.17.3

package/README.md

@@ -4,6 +4,8 @@
 
 Your Max plan rate limits eat interactive coding time. One deep refactor and the 5-hour window is gone before lunch. `claude-overnight` runs background agent sessions up to the percentage cap you pick (90% is typical), leaving the rest free for your own Claude Code session. Hand it an objective and a session budget, walk away, review the diff when the run ends.
 
+Cursor API Proxy supported -- route through Cursor's model gateway for Composer-powered execution on `auto`, `composer`, or `composer-2` models. See **Run via Cursor API Proxy** below.
+
 Isolated by default. Every agent runs in its own git worktree on its own branch, so a misbehaving agent can't trash your working tree. You choose what agents can do before the run starts  -- no surprise escalation mid-flight. Unmerged branches are preserved for manual review, never discarded. Built on the [Claude Agent SDK](https://www.npmjs.com/package/@anthropic-ai/claude-agent-sdk)  -- not a Claude Code replacement, but a background lane that runs alongside it.
 
 Different shape from hosted agent harnesses like [Claude Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview): instead of one agent in one cloud container billed separately, you get many parallel sessions on your own machine, in your real repo, against your own Max plan (or API key). Works with Claude Opus, Sonnet, and Haiku  -- or pair an Anthropic planner with a cheaper executor on Qwen, OpenRouter, or any Anthropic-compatible endpoint.
@@ -33,6 +35,39 @@ export ANTHROPIC_MODEL="qwen3.6-plus"
 claude-overnight
 ```
 
+## Run via Cursor API Proxy
+
+Use Cursor's model gateway as an executor -- `auto` (delegates to best available), `composer`, or `composer-2` models. Runs locally through a proxy that speaks the Anthropic Messages API, so it's a drop-in replacement for any other provider.
+
+1. **Install the Cursor CLI and proxy:**
+
+   ```bash
+   curl https://cursor.com/install -fsS | bash
+   npm install -g cursor-api-proxy
+   ```
+
+2. **Get an API key.** Visit [cursor.com/dashboard/integrations](https://cursor.com/dashboard/integrations) and scroll to the "API Keys" section.
+
+3. **Set up.** Run `claude-overnight` and when prompted to pick a model, choose **Cursor…**. It walks you through a one-time setup: CLI check, API key entry (persisted to `providers.json`), and proxy health check.
+
+4. **Start the proxy** (in a separate terminal):
+
+   ```bash
+   npx cursor-api-proxy
+   ```
+
+5. Pick your model (`auto`, `composer`, `composer-2`, etc.). The provider is saved and reappears in every future run.
+
+Or configure the key manually:
+
+```bash
+export CURSOR_BRIDGE_API_KEY="sk-..."
+npx cursor-api-proxy &
+claude-overnight
+```
+
+**Tip:** run `claude-overnight` with the `--model=cursor-auto` flag in non-interactive mode to skip the picker. If the proxy isn't running at startup, a warning is shown but Anthropic providers remain available.
+
 ## Install
 
 ```bash

package/dist/providers.d.ts

@@ -17,6 +17,8 @@ export interface ProviderConfig {
     useJWT?: boolean;
     /** When true, this provider routes through cursor-api-proxy (special env/health-check handling). */
     cursorProxy?: boolean;
+    /** API key for cursor-api-proxy. Stored in providers.json (0600), used as fallback when CURSOR_BRIDGE_API_KEY env is not set. */
+    cursorApiKey?: string;
 }
 export declare function getStorePath(): string;
 export declare function loadProviders(): ProviderConfig[];
@@ -65,7 +67,7 @@ export declare function healthCheckCursorProxy(baseUrl?: string): Promise<boolea
 export declare function fetchCursorModels(baseUrl?: string): Promise<string[]>;
 /**
  * Interactive setup guide for cursor-api-proxy.
- * Walks through CLI install, login, and proxy start.
+ * Walks through CLI install, API key config, and proxy start.
  * Returns true when proxy is running and healthy.
  */
 export declare function setupCursorProxy(): Promise<boolean>;

package/dist/providers.js

@@ -64,9 +64,9 @@ export function envFor(p) {
         if (v !== undefined)
             base[k] = v;
     if (p.cursorProxy) {
-        // cursor-api-proxy: routes through local proxy, no real API key needed
         base.ANTHROPIC_BASE_URL = p.baseURL;
-        base.ANTHROPIC_AUTH_TOKEN = process.env.CURSOR_BRIDGE_API_KEY || "unused";
+        const key = process.env.CURSOR_BRIDGE_API_KEY || p.cursorApiKey;
+        base.ANTHROPIC_AUTH_TOKEN = key || "unused";
         delete base.ANTHROPIC_API_KEY;
         return base;
     }
@@ -328,19 +328,14 @@ function setupSteps() {
             successMsg: "Cursor CLI found",
         },
         {
-            label: "Cursor authentication",
+            label: "Cursor API key",
             check: () => {
-                try {
-                    const out = execSync("agent --list-models", { stdio: "pipe", timeout: 10_000 });
-                    return out.toString().trim().length > 0;
-                }
-                catch {
-                    return false;
-                }
+                const key = process.env.CURSOR_BRIDGE_API_KEY;
+                return !!key && key.trim().length > 0;
             },
-            autoCmd: "agent login",
-            manualCmd: "agent login",
-            successMsg: "Cursor authenticated",
+            autoCmd: "",
+            manualCmd: "",
+            successMsg: "Cursor API key configured",
         },
         {
             label: "cursor-api-proxy server",
@@ -359,15 +354,51 @@ function setupSteps() {
         },
     ];
 }
+const CURSOR_KEY_PROVIDER_ID = "cursor";
+/** Persist the Cursor API key into providers.json. Updates any existing cursor proxy provider,
+ * or creates a sentinel entry so the key survives across sessions. */
+function saveCursorApiKey(key) {
+    const existing = loadProviders().filter(p => p.cursorProxy);
+    if (existing.length > 0) {
+        const p = existing[0];
+        p.cursorApiKey = key;
+        saveProvider(p);
+    }
+    else {
+        const sentinel = {
+            id: CURSOR_KEY_PROVIDER_ID,
+            displayName: "Cursor (API key)",
+            baseURL: PROXY_DEFAULT_URL,
+            model: "auto",
+            cursorProxy: true,
+            cursorApiKey: key,
+        };
+        saveProvider(sentinel);
+    }
+}
+/** Prompt the user for a Cursor API key and persist it. Returns true if saved. */
+async function promptAndSaveCursorKey() {
+    console.log(chalk.dim(`  Get your API key from https://cursor.com/dashboard/integrations`));
+    console.log(chalk.dim(`  (Scroll to the "API Keys" section at the bottom of the page)\n`));
+    const key = await ask(`  ${chalk.cyan("API key")}: `);
+    if (key && key.trim()) {
+        const trimmed = key.trim();
+        process.env.CURSOR_BRIDGE_API_KEY = trimmed;
+        saveCursorApiKey(trimmed);
+        return true;
+    }
+    console.log(chalk.yellow("  No key provided — skipped"));
+    return false;
+}
 /**
  * Interactive setup guide for cursor-api-proxy.
- * Walks through CLI install, login, and proxy start.
+ * Walks through CLI install, API key config, and proxy start.
  * Returns true when proxy is running and healthy.
  */
 export async function setupCursorProxy() {
     console.log(chalk.dim("\n  Cursor API Proxy Setup"));
     console.log(chalk.dim("  " + "─".repeat(40)));
-    console.log(chalk.dim("  We need three things: Cursor CLI, authentication, and the proxy server.\n"));
+    console.log(chalk.dim("  We need three things: Cursor CLI, an API key, and the proxy server.\n"));
     const steps = setupSteps();
     for (const step of steps) {
         if (step.check()) {
@@ -381,18 +412,10 @@ export async function setupCursorProxy() {
             { key: "s", desc: "kip (I'll handle it)" },
         ]);
         if (choice === "a") {
-            if (step.label === "Cursor authentication") {
-                // agent login needs interactive browser — run it directly
-                console.log(chalk.dim(`  Running: ${step.autoCmd}`));
-                console.log(chalk.dim("  (A browser window will open for login)\n"));
-                try {
-                    execSync(step.autoCmd, { stdio: "inherit", timeout: 120_000 });
+            if (step.label === "Cursor API key") {
+                if (await promptAndSaveCursorKey()) {
                     console.log(chalk.green(`  ✓ ${step.successMsg}`));
                 }
-                catch {
-                    console.log(chalk.yellow("  Login failed — try manual mode"));
-                    // Fall through to manual display
-                }
             }
             else if (step.label === "cursor-api-proxy server") {
                 // Don't auto-start the proxy server here — it blocks. Just verify it's installable.
@@ -428,10 +451,20 @@ export async function setupCursorProxy() {
             }
         }
         else if (choice === "m") {
-            console.log(chalk.cyan(`\n  Run this command:`));
-            console.log(chalk.white(`    ${step.manualCmd}`));
-            if (step.label === "cursor-api-proxy server") {
-                console.log(chalk.yellow(`    Then start the proxy: ${chalk.bold("npx cursor-api-proxy")}`));
+            if (step.label === "Cursor API key") {
+                console.log(chalk.cyan(`\n  1. Open: https://cursor.com/dashboard/integrations`));
+                console.log(chalk.cyan(`  2. Scroll to "API Keys" at the bottom of the page`));
+                console.log(chalk.cyan(`  3. Copy your API key and paste it below\n`));
+                if (await promptAndSaveCursorKey()) {
+                    console.log(chalk.green(`  ✓ ${step.successMsg}`));
+                }
+            }
+            else {
+                console.log(chalk.cyan(`\n  Run this command:`));
+                console.log(chalk.white(`    ${step.manualCmd}`));
+                if (step.label === "cursor-api-proxy server") {
+                    console.log(chalk.yellow(`    Then start the proxy: ${chalk.bold("npx cursor-api-proxy")}`));
+                }
             }
             console.log();
             const done = await selectKey(`  Done?`, [
@@ -500,13 +533,14 @@ async function pickCursorModel() {
         value: id,
         hint: cursorModelHint(id),
     })), 0);
-    // Save as a cursor proxy provider
+    const existingKey = loadProviders().find(p => p.id === CURSOR_KEY_PROVIDER_ID)?.cursorApiKey;
     const provider = {
         id: `cursor-${picked}`,
         displayName: `Cursor: ${picked}`,
         baseURL: PROXY_DEFAULT_URL,
         model: picked,
         cursorProxy: true,
+        ...(existingKey ? { cursorApiKey: existingKey } : {}),
     };
     saveProvider(provider);
     console.log(chalk.green(`  ✓ Saved as provider: ${provider.displayName}`));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-overnight",
-  "version": "1.17.2",
-  "description": "Background lane for your Claude Max plan. Parallel Claude Agent SDK sessions in git worktrees with a usage cap that reserves headroom for your interactive Claude Code. Crash-safe resume. Opus/Sonnet/Haiku + Qwen/OpenRouter.",
+  "version": "1.17.3",
+  "description": "Background lane for your Claude Max plan. Parallel Claude Agent SDK sessions in git worktrees with a usage cap that reserves headroom for your interactive Claude Code. Crash-safe resume. Opus/Sonnet/Haiku + Cursor API Proxy + Qwen/OpenRouter.",
   "type": "module",
   "bin": {
     "claude-overnight": "dist/bin.js"
@@ -60,6 +60,7 @@
     "code-automation",
     "refactoring",
     "migration",
+    "cursor",
     "qwen",
     "openrouter",
     "iterative"

package/plugins/claude-overnight/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-overnight",
-  "version": "1.17.2",
-  "description": "Claude Code skill for understanding, installing, and inspecting claude-overnight runs  -- parallel Claude agents in git worktrees with thinking waves, multi-wave steering, and crash-safe resume.",
+  "version": "1.17.3",
+  "description": "Claude Code skill for understanding, installing, and inspecting claude-overnight runs  -- parallel Claude agents in git worktrees with thinking waves, multi-wave steering, and crash-safe resume. Supports Cursor API Proxy, Qwen, OpenRouter.",
   "author": {
     "name": "Francesco Fornace"
   },