@jcanizalez7/clauxy 0.2.0 → 0.2.2

package/README.md

@@ -5,7 +5,7 @@
 [![npm version](https://img.shields.io/npm/v/@jcanizalez7/clauxy.svg)](https://www.npmjs.com/package/@jcanizalez7/clauxy)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
-> **Note:** Clauxy is in early development. While functional, you may encounter occasional quirks as providers update their APIs. Feedback and contributions are welcome!
+> **Note:** Clauxy is in early development. **GitHub Copilot with Anthropic models is stable and recommended.** ChatGPT and Google Gemini support are experimental and may have issues as providers update their APIs. Feedback and contributions are welcome!
 
 ---
 
@@ -29,14 +29,19 @@ No API keys needed. Just authenticate once with OAuth and you're ready to go.
 npm install -g @jcanizalez7/clauxy
 ```
 
+Also requires [Claude Code](https://docs.anthropic.com/en/docs/claude-code):
+```bash
+npm install -g @anthropic-ai/claude-code
+```
+
 ---
 
 ## Quick Start
 
-### 1. Start the proxy
+Just run:
 
 ```bash
-clauxy run
+clauxy
 ```
 
 First time? Select your provider and authenticate:
@@ -51,35 +56,45 @@ First time? Select your provider and authenticate:
 └
 ```
 
-### 2. Run Claude Code
-
-In a new terminal:
-
-```bash
-export ANTHROPIC_BASE_URL="http://localhost:3000"
-export ANTHROPIC_API_KEY="clauxy"
-claude
-```
-
-That's it! Claude Code now uses your selected provider.
-
-> **Tip:** Add the exports to your `~/.zshrc` or `~/.bashrc` to make them permanent.
+That's it! Clauxy starts the proxy and launches Claude Code automatically with the correct environment variables.
 
 ---
 
 ## Commands
 
 ```bash
-clauxy run                  # Start the proxy
-clauxy run -p copilot       # Start with a specific provider
-clauxy run -c               # Switch provider or re-authenticate
-clauxy run -p copilot -c    # Re-authenticate with a specific provider
-clauxy run --port 3001      # Use a different port
+# Default: Start proxy + launch Claude Code
+clauxy                      # Just works!
+clauxy "fix the bug"        # Pass arguments to Claude
+clauxy -p copilot           # Use specific provider
+clauxy -c                   # Re-authenticate before starting
+clauxy --port 3000          # Use specific port (reuses existing proxy if running)
+
+# Proxy-only mode (for advanced users)
+clauxy run                  # Start proxy without launching Claude
+clauxy run --port 3001      # Proxy on specific port
+clauxy run -p chatgpt       # Proxy with specific provider
+
+# Configuration
 clauxy model                # Configure model mappings
 clauxy auth list            # Show configured providers
 ```
 
-**Provider flag:** Use `-p` or `--provider` to start directly with a specific provider (`copilot`, `chatgpt`, or `google`). If credentials exist, it starts immediately. Otherwise, it authenticates with that provider.
+### Port Reuse
+
+When you specify `--port`, Clauxy checks if a proxy is already running on that port:
+- If yes, it reuses the existing proxy (no new instance started)
+- If no, it starts a new proxy on that port
+
+This lets you run multiple Claude Code sessions sharing a single proxy:
+
+```bash
+# Terminal 1
+clauxy --port 3000          # Starts proxy + Claude
+
+# Terminal 2
+clauxy --port 3000          # Reuses proxy, launches another Claude
+```
 
 ---
 
@@ -96,7 +111,7 @@ Claude Code requests are automatically mapped to your provider's models:
 Customize with `clauxy model` or environment variables:
 
 ```bash
-CLAUXY_MODEL_BIG=gpt-4o CLAUXY_MODEL_MID=gpt-4o clauxy run
+CLAUXY_MODEL_BIG=gpt-4o CLAUXY_MODEL_MID=gpt-4o clauxy
 ```
 
 ---
@@ -123,14 +138,13 @@ Credentials are stored locally in `~/.clauxy/` with restricted permissions.
 
 **"Token refresh failed"** or **"Not authenticated"**
 ```bash
-clauxy run -c
+clauxy -c
 ```
 
 **Port already in use**
 ```bash
-clauxy run --port 3001
+clauxy --port 3001
 ```
-Then update `ANTHROPIC_BASE_URL`.
 
 **Reset everything**
 ```bash

package/dist/cli.js

@@ -2558,8 +2558,18 @@ async function authenticateProvider2(providerId) {
   prompts3.outro(`Connected to ${provider.info.name}`);
   return providerId;
 }
+async function isClauxyRunning(port) {
+  try {
+    const response = await fetch(`http://localhost:${port}/health`, {
+      signal: AbortSignal.timeout(1000)
+    });
+    return response.ok && await response.text() === "OK";
+  } catch {
+    return false;
+  }
+}
 async function wrapperCommand(options) {
-  const { logLevel = "warn", connect = false, provider, claudeArgs = [] } = options;
+  const { logLevel = "warn", connect = false, provider, port: requestedPort, claudeArgs = [] } = options;
   const claudePath = await findClaudeCli();
   if (!claudePath) {
     console.error(c2.red("Error: Claude CLI not found."));
@@ -2594,18 +2604,28 @@ Install it with: ${c2.cyan("npm i -g @anthropic-ai/claude-code")}`);
     }
   }
   await Config.setActiveProvider(activeProvider);
-  const { startProxy: startProxy2 } = await init_proxy().then(() => exports_proxy);
-  const proxyServer = await startProxy2({
-    logLevel,
-    providerId: activeProvider,
-    quiet: true
-  });
-  const providerInfo = await getProvider(activeProvider);
-  console.log(`${c2.green(">")} ${c2.bold("Clauxy")} proxy on ${c2.cyan(`localhost:${proxyServer.port}`)} ${c2.dim(`(${providerInfo.info.name})`)}`);
+  let proxyPort;
+  let proxyServer = null;
+  if (requestedPort && await isClauxyRunning(requestedPort)) {
+    proxyPort = requestedPort;
+    console.log(`${c2.green(">")} ${c2.bold("Clauxy")} reusing proxy on ${c2.cyan(`localhost:${proxyPort}`)}`);
+  } else {
+    const { startProxy: startProxy2 } = await init_proxy().then(() => exports_proxy);
+    const server = await startProxy2({
+      port: requestedPort,
+      logLevel,
+      providerId: activeProvider,
+      quiet: true
+    });
+    proxyServer = server;
+    proxyPort = server.port;
+    const providerInfo = await getProvider(activeProvider);
+    console.log(`${c2.green(">")} ${c2.bold("Clauxy")} proxy on ${c2.cyan(`localhost:${proxyPort}`)} ${c2.dim(`(${providerInfo.info.name})`)}`);
+  }
   const claude = Bun.spawn(["claude", ...claudeArgs], {
     env: {
       ...process.env,
-      ANTHROPIC_BASE_URL: `http://localhost:${proxyServer.port}`,
+      ANTHROPIC_BASE_URL: `http://localhost:${proxyPort}`,
       ANTHROPIC_API_KEY: "clauxy"
     },
     stdin: "inherit",
@@ -2617,14 +2637,14 @@ Install it with: ${c2.cyan("npm i -g @anthropic-ai/claude-code")}`);
     if (isCleaningUp)
       return;
     isCleaningUp = true;
-    proxyServer.stop();
+    proxyServer?.stop();
     claude.kill();
   };
   process.on("SIGINT", cleanup);
   process.on("SIGTERM", cleanup);
   process.on("SIGHUP", cleanup);
   const exitCode = await claude.exited;
-  proxyServer.stop();
+  proxyServer?.stop();
   process.exit(exitCode);
 }
 
@@ -2776,7 +2796,7 @@ Models configured:`);
 // package.json
 var package_default = {
   name: "@jcanizalez7/clauxy",
-  version: "0.2.0",
+  version: "0.2.2",
   description: "Multi-provider AI proxy for Claude Code (GitHub Copilot, ChatGPT Plus, Google Gemini)",
   type: "module",
   bin: {
@@ -2898,7 +2918,7 @@ var main = defineCommand({
   meta: {
     name: "clauxy",
     version: package_default.version,
-    description: "Multi-Provider AI Proxy for Claude Code"
+    description: "Multi-Provider AI Proxy for Claude Code. Run without arguments to start proxy and launch Claude automatically."
   },
   args: {
     "log-level": {
@@ -2917,6 +2937,10 @@ var main = defineCommand({
       type: "string",
       alias: "p",
       description: "Provider to use (copilot, chatgpt, google)"
+    },
+    port: {
+      type: "string",
+      description: "Port to use (reuses existing proxy if running)"
     }
   },
   subCommands: {
@@ -2926,10 +2950,16 @@ var main = defineCommand({
     models: model
   },
   async run({ args, rawArgs }) {
+    const port = args.port ? parseInt(args.port, 10) : undefined;
+    if (args.port && isNaN(port)) {
+      console.error(`Invalid port number: "${args.port}". Use --port <number> (e.g., --port 3000).`);
+      process.exit(1);
+    }
     await wrapperCommand({
       logLevel: args["log-level"],
       connect: args.connect,
       provider: args.provider,
+      port,
       claudeArgs: rawArgs
     });
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jcanizalez7/clauxy",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Multi-provider AI proxy for Claude Code (GitHub Copilot, ChatGPT Plus, Google Gemini)",
   "type": "module",
   "bin": {