anthropic-gateway 1.3.0 → 1.5.0

package/README.md

@@ -30,7 +30,7 @@ Open a **new** terminal after installing so PATH picks it up.
 
 ```bash
 anthropic-gateway setup     # interactive wizard (or flags, see below)
-anthropic-gateway start     # run the gateway (keep this console open)
+anthropic-gateway start     # run the gateway using the default profile
 ```
 
 Config, pid and log live in `~/.anthropic-gateway/` (`config.json`,
@@ -38,7 +38,7 @@ Config, pid and log live in `~/.anthropic-gateway/` (`config.json`,
 
 Then point your client at:
 
-- Base URL: `http://127.0.0.1:3080`
+- Base URL: `http://127.0.0.1:3080` (or the port you configured)
 - API key / `x-api-key` / `Authorization: Bearer`: the **proxy token** printed by `setup`
 
 ### Non-interactive setup
@@ -48,24 +48,38 @@ anthropic-gateway setup --provider kilo --api-key YOUR_KILO_KEY --model kilo-aut
 anthropic-gateway setup --base-url https://api.openai.com/v1 --api-key sk-... --model gpt-5 --port 3090 --token mytoken --yes
 ```
 
+### Using multiple profiles
+
+After setting up multiple profiles (e.g., one for kilo, one for OpenAI), you can:
+
+- List all defined profiles: `anthropic-gateway profiles`
+- Start a specific profile: `anthropic-gateway start openai`
+- Set the default profile for future `start` commands: `anthropic-gateway select kilo`
+- Then `anthropic-gateway start` will use the kilo profile without specifying it.
+
 ## Commands
 
 | Command | Description |
 | --- | --- |
-| `anthropic-gateway setup` | Create/overwrite `~/.anthropic-gateway/config.json`; tests connectivity (`--full-logging` to enable full-body logging) |
-| `anthropic-gateway start` | Start the gateway |
+| `anthropic-gateway setup` | Create/overwrite `~/.anthropic-gateway/config.json` with a profiles array; tests connectivity (`--full-logging` to enable full-body logging) |
+| `anthropic-gateway start [profile]` | Start the gateway using the given profile name; if omitted, uses `defaultProfile` from config |
 | `anthropic-gateway stop` | Stop the gateway |
 | `anthropic-gateway status` | Pretty status: version, pid, upstream, uptime, request/token totals, full-logging state |
 | `anthropic-gateway fulllogging on\|off` | Toggle full request/response logging (restart to apply) |
 | `anthropic-gateway autostart on\|off` | Launch at Windows logon (Startup folder) |
+| `anthropic-gateway select <profile>` | Set the default profile for future `start` commands |
+| `anthropic-gateway profiles` | List all defined profiles in the config file |
 | `anthropic-gateway version` | Print the version (also `--version` / `-v`) |
 
 ## config.json
 
-See `config.example.json`. Key fields: `upstreamBaseUrl`, `upstreamApiKey`,
+See `config.example.json`. The config now contains a `profiles` array and a `defaultProfile`.
+Each profile object includes: `providerName`, `upstreamBaseUrl`, `upstreamApiKey`,
 `upstreamModel`, `port`, `proxyTokens` (accepts several), `advertisedModels`
 (models shown to Claude Code model discovery — must look Anthropic-ish, e.g.
-`claude-sonnet-4-5` or `sonnet`), `toolFormat`, `fullLogging`.
+`claude-sonnet-4-5` or `sonnet`), `toolFormat`, `fullLogging`, `logFile`.
+Only the profile named by `defaultProfile` (or the first profile if unspecified)
+is used by `anthropic-gateway start` unless a profile name is given explicitly.
 
 ## Logging
 

package/cli.js

@@ -80,9 +80,31 @@ function randomToken() {
   return 'ag-' + require('crypto').randomBytes(24).toString('base64url');
 }
 
-function loadConfig(cfgPath) {
-  if (!fs.existsSync(cfgPath)) fail('no config at ' + cfgPath + ' — run "node cli.js setup" first');
-  return JSON.parse(fs.readFileSync(cfgPath, 'utf8'));
+/**
+ * Load the top-level config and return the selected profile object merged with
+ * defaults. If `profileName` is omitted, `defaultProfile` in the config is used;
+ * if none/defaultProfile points at a non-existent one, the first profile wins.
+ */
+function loadProfile(cfgPath, profileName) {
+  if (!fs.existsSync(cfgPath)) fail('no config at ' + cfgPath + ' — run "anthropic-gateway setup" first');
+  const cfg = JSON.parse(fs.readFileSync(cfgPath, 'utf8'));
+
+  // Backwards compatibility: old single-profile config.json (flat fields).
+  if (Array.isArray(cfg.profiles) && cfg.profiles.length > 0) {
+    const profiles = cfg.profiles;
+    if (!profileName) profileName = cfg.defaultProfile;
+    let idx;
+    if (profileName) {
+      idx = profiles.findIndex((p) => p.providerName === profileName);
+      if (idx === -1) fail('profile "' + profileName + '" not found in ' + cfgPath + ' (available: ' + profiles.map((p) => p.providerName).join(', ') + ')');
+    } else {
+      idx = 0; // first profile is the default when none specified
+    }
+    return { ...profiles[idx], _profiles: profiles, _configPath: cfgPath, _defaultProfile: cfg.defaultProfile };
+  }
+
+  // Legacy flat config
+  return { ...cfg, _profiles: null, _configPath: cfgPath, _defaultProfile: undefined };
 }
 
 async function testUpstream(baseUrl, apiKey, model) {
@@ -145,7 +167,47 @@ async function cmdSetup(args) {
   const advertisedModels = adv.split(',').map((s) => s.trim()).filter(Boolean);
   const fullLoggingFlag = args['full-logging'];
   const fullLogging = fullLoggingFlag !== undefined && String(fullLoggingFlag) !== 'false';
-  const config = {
+
+  // Load existing config if any
+  let existingConfig = null;
+  if (fs.existsSync(cfgPath)) {
+    try {
+      existingConfig = JSON.parse(fs.readFileSync(cfgPath, 'utf8'));
+    } catch (e) {
+      fail('failed to parse existing config at ' + cfgPath);
+    }
+  }
+
+  // Determine if we are dealing with legacy flat config or new profiles format
+  const isLegacy = existingConfig && (!Array.isArray(existingConfig.profiles));
+  let profiles = [];
+  let defaultProfile = undefined;
+
+  if (isLegacy) {
+    // Convert legacy flat config to a profile
+    const legacyProfile = {
+      providerName: existingConfig.providerName || 'legacy',
+      upstreamBaseUrl: existingConfig.upstreamBaseUrl.replace(/\/+$/, ''),
+      upstreamApiKey: existingConfig.upstreamApiKey,
+      upstreamModel: existingConfig.upstreamModel,
+      port: existingConfig.port || 3080,
+      proxyTokens: Array.isArray(existingConfig.proxyTokens) ? existingConfig.proxyTokens : [existingConfig.proxyTokens],
+      toolFormat: existingConfig.toolFormat || 'native',
+      advertisedModels: Array.isArray(existingConfig.advertisedModels) ? existingConfig.advertisedModels : [],
+      fullLogging: !!existingConfig.fullLogging,
+      logFile: existingConfig.logFile || 'gateway.log',
+    };
+    profiles.push(legacyProfile);
+    defaultProfile = legacyProfile.providerName;
+  } else if (existingConfig) {
+    // Already in new format
+    profiles = Array.isArray(existingConfig.profiles) ? existingConfig.profiles : [];
+    defaultProfile = existingConfig.defaultProfile;
+  }
+
+  // Find index of profile with same providerName as the one we are setting up
+  const profileIndex = profiles.findIndex(p => p.providerName === (preset.name || 'custom'));
+  const newProfile = {
     providerName: preset.name || 'custom',
     upstreamBaseUrl: baseUrl.replace(/\/+$/, ''),
     upstreamApiKey: apiKey,
@@ -155,16 +217,34 @@ async function cmdSetup(args) {
     toolFormat: 'native',
     advertisedModels,
     fullLogging,
-    logFile: LOG_FILE,
+    logFile: 'gateway.log',
+  };
+
+  if (profileIndex >= 0) {
+    // Update existing profile
+    profiles[profileIndex] = newProfile;
+  } else {
+    // Add new profile
+    profiles.push(newProfile);
+  }
+
+  // If defaultProfile is not set, set it to the providerName of the profile we just set up
+  if (!defaultProfile) {
+    defaultProfile = newProfile.providerName;
+  }
+
+  const configOut = {
+    defaultProfile,
+    profiles,
   };
 
   console.log('Testing upstream connectivity...');
-  const ok = await testUpstream(config.upstreamBaseUrl, config.upstreamApiKey, config.upstreamModel);
+  const ok = await testUpstream(newProfile.upstreamBaseUrl, newProfile.upstreamApiKey, newProfile.upstreamModel);
   if (!ok && !yes) {
     const c = await ask(readline.createInterface({ input: process.stdin, output: process.stdout }), 'Connectivity test failed. Save anyway? (y/N):', 'N');
     if (c.toLowerCase() !== 'y') fail('aborted — nothing written');
   }
-  fs.writeFileSync(cfgPath, JSON.stringify(config, null, 2));
+  fs.writeFileSync(cfgPath, JSON.stringify(configOut, null, 2));
   console.log('Config written to ' + cfgPath);
   console.log('Proxy token (use as API key / x-api-key / Bearer in the client): ' + token);
   console.log('Next: anthropic-gateway start   (or: anthropic-gateway autostart on)');
@@ -173,17 +253,34 @@ async function cmdSetup(args) {
 async function cmdStart(args) {
   ensureHomeDir();
   const cfgPath = args.config ? path.resolve(args.config) : DEFAULT_CONFIG;
-  const cfg = loadConfig(cfgPath);
+  const profileArg = args.profile;
+  const cfg = loadProfile(cfgPath, profileArg); // loadProfile now takes profileName
   if (cfg.logFile && !path.isAbsolute(cfg.logFile)) cfg.logFile = path.join(HOME_DIR, cfg.logFile);
   const { makeServer } = require('./lib/server');
   const server = makeServer(cfg);
-  const started = await server.start();
+  let started;
+  try {
+    started = await server.start();
+  } catch (err) {
+    if (err.code === 'EADDRINUSE') {
+      fail(`Port ${cfg.port} is already in use. Another process might be running on this port.\n` +
+        `To resolve:\n` +
+        `  1. Stop the existing gateway: anthropic-gateway stop\n` +
+        `  2. Or change the port in your config (or use a different profile with a different port).\n` +
+        `Underlying error: ${err.message}`);
+    }
+    throw err; // re-throw if we didn't handle it
+  }
   fs.writeFileSync(PID_FILE, String(process.pid));
+  // Also write the active profile to a file
+  const activeProfilePath = path.join(HOME_DIR, 'active_profile');
+  fs.writeFileSync(activeProfilePath, profileArg || cfg._defaultProfile || (cfg._profiles && cfg._profiles[0]?.providerName));
   console.log('pid ' + process.pid + ' written to ' + PID_FILE);
   console.log('Health: http://127.0.0.1:' + started + '/health');
   const shutdown = async () => {
     await server.stop();
     try { fs.unlinkSync(PID_FILE); } catch {}
+    try { fs.unlinkSync(activeProfilePath); } catch {}
     process.exit(0);
   };
   process.on('SIGINT', shutdown);
@@ -273,6 +370,61 @@ async function cmdAutostart(mode) {
   }
 }
 
+async function cmdSelect(profileName, args) {
+  ensureHomeDir();
+  const cfgPath = args && args.config ? path.resolve(args.config) : DEFAULT_CONFIG;
+  if (!fs.existsSync(cfgPath)) fail('no config at ' + cfgPath + ' — run "anthropic-gateway setup" first');
+  let cfg;
+  try {
+    cfg = JSON.parse(fs.readFileSync(cfgPath, 'utf8'));
+  } catch (e) {
+    fail('failed to parse config at ' + cfgPath);
+  }
+  // Ensure we are dealing with the new profiles format
+  if (!Array.isArray(cfg.profiles)) {
+    fail('config is in legacy format; please run setup again to migrate to profiles format');
+  }
+  const profileIndex = cfg.profiles.findIndex(p => p.providerName === profileName);
+  if (profileIndex === -1) {
+    fail('profile "' + profileName + '" not found in ' + cfgPath + ' (available: ' + cfg.profiles.map(p => p.providerName).join(', ') + ')');
+  }
+  cfg.defaultProfile = profileName;
+  fs.writeFileSync(cfgPath, JSON.stringify(cfg, null, 2));
+  console.log('defaultProfile set to "' + profileName + '" in ' + cfgPath);
+}
+
+async function cmdListProfiles(args) {
+  ensureHomeDir();
+  const cfgPath = args && args.config ? path.resolve(args.config) : DEFAULT_CONFIG;
+  if (!fs.existsSync(cfgPath)) fail('no config at ' + cfgPath + ' — run "anthropic-gateway setup" first');
+  let cfg;
+  try {
+    cfg = JSON.parse(fs.readFileSync(cfgPath, 'utf8'));
+  } catch (e) {
+    fail('failed to parse config at ' + cfgPath);
+  }
+  // Handle legacy config
+  if (!Array.isArray(cfg.profiles)) {
+    // Legacy single profile
+    if (cfg.providerName) {
+      console.log('Profiles (legacy format):');
+      console.log('  * ' + cfg.providerName + ' (default)');
+    } else {
+      console.log('No profiles found in legacy config.');
+    }
+    return;
+  }
+  if (cfg.profiles.length === 0) {
+    console.log('No profiles defined.');
+    return;
+  }
+  console.log('Profiles:');
+  for (const p of cfg.profiles) {
+    const marker = (p.providerName === cfg.defaultProfile) ? ' (default)' : '';
+    console.log('  * ' + p.providerName + marker);
+  }
+}
+
 function parseFlags(argv) {
   const out = {};
   for (let i = 0; i < argv.length; i++) {
@@ -309,11 +461,13 @@ function parseFlags(argv) {
         '',
         'usage:',
         '  anthropic-gateway setup [--provider kilo|openai|custom] [--base-url URL] [--api-key KEY] [--model ID] [--port N] [--token TOK] [--full-logging] [--yes]',
-        '  anthropic-gateway start',
+        '  anthropic-gateway start [profile]   # if profile omitted, uses defaultProfile',
         '  anthropic-gateway stop',
         '  anthropic-gateway status',
         '  anthropic-gateway fulllogging on|off   # log full request/response bodies to the log file (restart to apply)',
         '  anthropic-gateway autostart on|off',
+        '  anthropic-gateway select <profile>  # set defaultProfile for future start commands',
+        '  anthropic-gateway profiles        # list all defined profiles',
         '  anthropic-gateway version        # or: --version, -v',
       ].join('\n')
     );
@@ -324,10 +478,17 @@ function parseFlags(argv) {
     process.exit(0);
   }
   if (cmd === 'setup') await cmdSetup(flags);
-  else if (cmd === 'start') await cmdStart(flags);
+  else if (cmd === 'start') {
+    // If a profile name is provided as the second argument (after 'start'), use it
+    const profileName = flags._ && flags._.length > 1 ? flags._[1] : undefined;
+    flags.profile = profileName;
+    await cmdStart(flags);
+  }
   else if (cmd === 'stop') await cmdStop();
   else if (cmd === 'status') await cmdStatus(flags);
   else if (cmd === 'fulllogging') await cmdFullLogging(flags._[1], flags);
   else if (cmd === 'autostart') await cmdAutostart(flags._[1]);
+  else if (cmd === 'select') await cmdSelect(flags._[1], flags);
+  else if (cmd === 'profiles') await cmdListProfiles(flags);
   else fail('unknown command: ' + cmd);
 })();

package/config.example.json

@@ -1,21 +1,47 @@
 {
-  "providerName": "example-provider",
-  "upstreamBaseUrl": "https://PROVIDER-HOST/v1",
-  "upstreamApiKey": "<YOUR-PROVIDER-API-KEY>",
-  "upstreamModel": "your-model-id",
-  "port": 3080,
-  "proxyTokens": [
-    "<YOUR-PROXY-TOKEN>"
-  ],
-  "toolFormat": "native",
-  "fullLogging": false,
-  "advertisedModels": [
-    "claude-sonnet-4-5",
-    "claude-haiku-4-5",
-    "claude-opus-4-5",
-    "sonnet",
-    "haiku",
-    "opus"
-  ],
-  "logFile": "gateway.log"
-}
+  "defaultProfile": "kilo",
+  "profiles": [
+    {
+      "providerName": "kilo",
+      "upstreamBaseUrl": "https://kilo.imedata.ir/v1",
+      "upstreamApiKey": "<YOUR-PROVIDER-API-KEY>",
+      "upstreamModel": "kilo-auto/free",
+      "port": 3080,
+      "proxyTokens": [
+        "<YOUR-PROXY-TOKEN>"
+      ],
+      "toolFormat": "native",
+      "fullLogging": false,
+      "advertisedModels": [
+        "claude-sonnet-4-5",
+        "claude-haiku-4-5",
+        "claude-opus-4-5",
+        "sonnet",
+        "haiku",
+        "opus"
+      ],
+      "logFile": "gateway.log"
+    },
+    {
+      "providerName": "openai",
+      "upstreamBaseUrl": "https://api.openai.com/v1",
+      "upstreamApiKey": "<YOUR-OPENAI-API-KEY>",
+      "upstreamModel": "gpt-4o",
+      "port": 3081,
+      "proxyTokens": [
+        "<YOUR-PROXY-TOKEN>"
+      ],
+      "toolFormat": "native",
+      "fullLogging": false,
+      "advertisedModels": [
+        "claude-sonnet-4-5",
+        "claude-haiku-4-5",
+        "claude-opus-4-5",
+        "sonnet",
+        "haiku",
+        "opus"
+      ],
+      "logFile": "gateway.log"
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anthropic-gateway",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "Anthropic-compatible local gateway for any OpenAI-compatible model provider — make Claude Code (GUI/CLI) work with kilo, OpenAI, DeepSeek, local models, etc.",
   "license": "MIT",
   "engines": {