@suncreation/crush-auth-proxy 1.0.0 → 1.1.0

package/README.md

@@ -7,23 +7,27 @@ This proxy sits between Crush and Anthropic's API, injecting Claude Code OAuth c
 ## Quick Start
 
 ```bash
-# 1. Login with your Claude account (one-time)
-npx @suncreation/crush-auth-proxy setup-token
-
-# 2. Start the proxy daemon
-npx @suncreation/crush-auth-proxy start
+# One command does everything: login + crush config + auto-start
+npx @suncreation/crush-auth-proxy setup
+```
 
-# 3. Configure Crush (see below)
+That's it! Now use Crush:
 
-# 4. Use Crush normally
+```bash
 crush run --model anthropic/claude-opus-4-6 "Hello!"
 ```
 
+The proxy auto-starts on boot. No manual configuration needed.
+
 ## Commands
 
 | Command | Description |
 |---------|-------------|
-| `setup-token` | OAuth login — opens browser, saves token locally |
+| `setup` | **All-in-one**: OAuth login + crush.json config + auto-start service |
+| `setup-token` | OAuth login only — opens browser, saves token locally |
+| `setup-crush` | Configure `crush.json` only (adds anthropic provider) |
+| `install-service` | Install macOS auto-start service (launchd) |
+| `uninstall-service` | Remove auto-start service |
 | `start` | Start proxy as background daemon (port 18080) |
 | `stop` | Stop the daemon |
 | `restart` | Restart the daemon |
@@ -37,23 +41,6 @@ crush run --model anthropic/claude-opus-4-6 "Hello!"
 | `--port <n>` | Custom port (default: 18080) |
 | `--foreground` | Run in foreground instead of daemon |
 
-## Crush Configuration
-
-Create or edit `~/.config/crush/crush.json`:
-
-```json
-{
-  "providers": {
-    "anthropic": {
-      "id": "anthropic",
-      "type": "anthropic",
-      "base_url": "http://127.0.0.1:18080",
-      "api_key": "proxy-handled"
-    }
-  }
-}
-```
-
 ## How It Works
 
 The proxy replicates Claude Code's authentication mechanism:
@@ -71,13 +58,23 @@ All config is stored in `~/.config/crush-auth-proxy/`:
 ```
 ~/.config/crush-auth-proxy/
   ├── claude-oauth-token.json   # Your OAuth tokens (chmod 0600)
+  ├── crush-auth-proxy.mjs      # Stable copy for auto-start service
   ├── proxy.pid                 # Daemon PID
   └── proxy.log                 # Daemon logs
 ```
 
+## Uninstall
+
+```bash
+npx @suncreation/crush-auth-proxy uninstall-service
+npx @suncreation/crush-auth-proxy stop
+rm -rf ~/.config/crush-auth-proxy
+```
+
 ## Requirements
 
 - Node.js >= 18
+- macOS (for auto-start via launchd; proxy itself works on any OS)
 - A Claude Max subscription (claude.ai account)
 - [Crush CLI](https://github.com/charmbracelet/crush) installed
 

package/bin/crush-auth-proxy.mjs

@@ -70,7 +70,11 @@ Uses your Claude Max subscription via OAuth so you don't need
 a separate Anthropic API key with Crush.
 
 COMMANDS:
-  setup-token              OAuth login (run this first!)
+  setup                    All-in-one: login + crush config + auto-start
+  setup-token              OAuth login only
+  setup-crush              Configure crush.json only
+  install-service          Install macOS auto-start (launchd)
+  uninstall-service        Remove auto-start service
   start                    Start proxy as background daemon
   stop                     Stop the background daemon
   restart                  Restart the daemon
@@ -85,21 +89,11 @@ OPTIONS:
 ENVIRONMENT:
   PORT                     Override default port (18080)
 
-QUICK START:
-  1. npx @suncreation/crush-auth-proxy setup-token
-  2. Add to ~/.config/crush/crush.json:
-     {
-       "providers": {
-         "anthropic": {
-           "id": "anthropic",
-           "type": "anthropic",
-           "base_url": "http://127.0.0.1:18080",
-           "api_key": "proxy-handled"
-         }
-       }
-     }
-  3. npx @suncreation/crush-auth-proxy start
-  4. crush run --model anthropic/claude-opus-4-6 "hello"
+QUICK START (recommended):
+  npx @suncreation/crush-auth-proxy setup
+
+  That's it! Sets up OAuth, crush.json, and auto-start in one step.
+  Then just use: crush run --model anthropic/claude-opus-4-6 "hello"
 
 CONFIG DIR: ~/.config/crush-auth-proxy/
   `);
@@ -349,6 +343,205 @@ async function getValidToken() {
   return token;
 }
 
+// ── Crush Config Helper ────────────────────────────────────────
+
+const CRUSH_CONFIG_DIR = path.join(os.homedir(), ".config", "crush");
+const CRUSH_CONFIG_FILE = path.join(CRUSH_CONFIG_DIR, "crush.json");
+
+function setupCrushConfig(port = DEFAULT_PORT) {
+  fs.mkdirSync(CRUSH_CONFIG_DIR, { recursive: true });
+
+  let config = {};
+  try {
+    config = JSON.parse(fs.readFileSync(CRUSH_CONFIG_FILE, "utf8"));
+  } catch {}
+
+  if (!config.providers) config.providers = {};
+  config.providers.anthropic = {
+    id: "anthropic",
+    type: "anthropic",
+    base_url: `http://127.0.0.1:${port}`,
+    api_key: "proxy-handled",
+  };
+
+  // Preserve $schema if present
+  if (!config.$schema) config.$schema = "https://charm.land/crush.json";
+
+  fs.writeFileSync(CRUSH_CONFIG_FILE, JSON.stringify(config, null, 2));
+  console.log(`[setup] crush.json updated: ${CRUSH_CONFIG_FILE}`);
+  console.log(`[setup]   anthropic provider → http://127.0.0.1:${port}`);
+}
+
+// ── Launchd Service Helper ─────────────────────────────────────
+
+const LAUNCHD_LABEL = "com.suncreation.crush-auth-proxy";
+const LAUNCHD_PLIST = path.join(
+  os.homedir(),
+  "Library",
+  "LaunchAgents",
+  `${LAUNCHD_LABEL}.plist`
+);
+
+function getNodePath() {
+  try {
+    return execSync("which node", { encoding: "utf8" }).trim();
+  } catch {
+    return process.execPath;
+  }
+}
+
+function installLaunchd(port = DEFAULT_PORT) {
+  const nodePath = getNodePath();
+  // Copy script to stable config dir so launchd always has a valid path
+  const stablePath = path.join(CONFIG_DIR, "crush-auth-proxy.mjs");
+  fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  fs.copyFileSync(__filename, stablePath);
+  const scriptPath = stablePath;
+
+  const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${LAUNCHD_LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${nodePath}</string>
+    <string>${scriptPath}</string>
+    <string>--foreground</string>
+    <string>--port</string>
+    <string>${port}</string>
+  </array>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${LOG_FILE}</string>
+  <key>StandardErrorPath</key>
+  <string>${LOG_FILE}</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key>
+    <string>/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin</string>
+  </dict>
+</dict>
+</plist>`;
+
+  fs.mkdirSync(path.dirname(LAUNCHD_PLIST), { recursive: true });
+  fs.writeFileSync(LAUNCHD_PLIST, plist);
+  console.log(`[setup] Launchd plist installed: ${LAUNCHD_PLIST}`);
+
+  // Unload old, load new
+  try { execSync(`launchctl unload "${LAUNCHD_PLIST}" 2>/dev/null`); } catch {}
+  try {
+    execSync(`launchctl load "${LAUNCHD_PLIST}"`);
+    console.log("[setup] Service loaded — proxy will auto-start on boot");
+  } catch (e) {
+    console.error("[setup] Warning: launchctl load failed:", e.message);
+    console.log("[setup] You may need to load manually:");
+    console.log(`  launchctl load "${LAUNCHD_PLIST}"`);
+  }
+}
+
+function uninstallLaunchd() {
+  try { execSync(`launchctl unload "${LAUNCHD_PLIST}" 2>/dev/null`); } catch {}
+  try {
+    fs.unlinkSync(LAUNCHD_PLIST);
+    console.log(`[setup] Service removed: ${LAUNCHD_PLIST}`);
+  } catch {
+    console.log("[setup] No launchd service found");
+  }
+}
+
+// ── Command: setup (all-in-one) ────────────────────────────────
+
+if (command === "setup") {
+  console.log("[setup] ── crush-auth-proxy full setup ──\n");
+
+  // Step 1: Token
+  let token = loadToken();
+  if (token && token.expires_at > Date.now()) {
+    console.log(`[setup] ✓ Existing token found (expires: ${new Date(token.expires_at).toLocaleString()})`);
+  } else {
+    console.log("[setup] Step 1/3: OAuth login...");
+    try {
+      token = await doOAuthLogin();
+      console.log("[setup] ✓ Login successful!\n");
+    } catch (e) {
+      console.error("[setup] ✗ Login failed:", e.message);
+      process.exit(1);
+    }
+  }
+
+  // Step 2: Crush config
+  console.log("[setup] Step 2/3: Configuring crush.json...");
+  setupCrushConfig(DEFAULT_PORT);
+  console.log("");
+
+  // Step 3: Launchd auto-start
+  console.log("[setup] Step 3/3: Installing auto-start service...");
+  // Stop any existing daemon first
+  const pid = getRunningPid();
+  if (pid) {
+    try { process.kill(pid, "SIGTERM"); } catch {}
+    try { fs.unlinkSync(PID_FILE); } catch {}
+    await sleepMs(500);
+  }
+  installLaunchd(DEFAULT_PORT);
+
+  await sleepMs(1500);
+  console.log("");
+
+  // Verify
+  try {
+    const health = execSync(`curl -s http://127.0.0.1:${DEFAULT_PORT}/health`, {
+      timeout: 3000,
+    }).toString();
+    console.log(`[setup] ✓ Proxy running on http://127.0.0.1:${DEFAULT_PORT} (health: ${health})`);
+  } catch {
+    console.log(`[setup] ⚠ Proxy may still be starting — check: crush-auth-proxy status`);
+  }
+
+  console.log(`
+── Setup complete! ──
+
+  You can now use Crush with Claude Max:
+    crush run --model anthropic/claude-opus-4-6 "hello"
+
+  The proxy auto-starts on boot. Manage with:
+    npx @suncreation/crush-auth-proxy status
+    npx @suncreation/crush-auth-proxy stop
+    npx @suncreation/crush-auth-proxy logs
+`);
+  process.exit(0);
+}
+
+// ── Command: setup-crush (just crush.json) ─────────────────────
+
+if (command === "setup-crush") {
+  setupCrushConfig(DEFAULT_PORT);
+  process.exit(0);
+}
+
+// ── Command: install-service ───────────────────────────────────
+
+if (command === "install-service") {
+  if (os.platform() !== "darwin") {
+    console.error("[setup] install-service is macOS only (launchd)");
+    process.exit(1);
+  }
+  installLaunchd(DEFAULT_PORT);
+  process.exit(0);
+}
+
+// ── Command: uninstall-service ─────────────────────────────────
+
+if (command === "uninstall-service") {
+  uninstallLaunchd();
+  process.exit(0);
+}
+
 // ── Command: setup-token ───────────────────────────────────────
 
 if (command === "setup-token") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suncreation/crush-auth-proxy",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Claude Code Auth Proxy for Crush CLI — Use your Claude Max subscription (OAuth) instead of API keys",
   "type": "module",
   "bin": {