@kio_ai/aicli-switch 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 killaragorn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,153 @@
+# aicli-switch
+
+Switch between multiple Claude Code accounts without re-authenticating.
+
+When one account hits its usage limit, just `aicli-switch another-account` — no need to `claude login` again.
+
+## Install
+
+### npm (recommended)
+
+```bash
+npm install -g aicli-switch
+```
+
+This downloads the pre-built binary for your platform automatically.
+
+### Manual download
+
+Download the binary for your OS from [Releases](https://github.com/killaragorn/aicli-switch/releases/latest):
+
+| Platform | File |
+|----------|------|
+| Windows x64 | `aicli-switch-windows-amd64.exe` |
+| macOS x64 | `aicli-switch-darwin-amd64` |
+| macOS Apple Silicon | `aicli-switch-darwin-arm64` |
+| Linux x64 | `aicli-switch-linux-amd64` |
+| Linux ARM64 | `aicli-switch-linux-arm64` |
+
+Move it to a directory in your PATH:
+
+```bash
+# macOS / Linux
+chmod +x aicli-switch-*
+mv aicli-switch-* /usr/local/bin/aicli-switch
+
+# Windows — move to any directory in your PATH
+move aicli-switch-windows-amd64.exe %USERPROFILE%\.local\bin\aicli-switch.exe
+```
+
+### Build from source
+
+Requires Go 1.22+:
+
+```bash
+git clone https://github.com/killaragorn/aicli-switch.git
+cd aicli-switch
+go build -o aicli-switch .
+```
+
+## Quick Start
+
+```bash
+# Step 1: You're logged into account A in Claude Code
+# Save it as a profile
+aicli-switch add work
+
+# Step 2: Log into account B
+claude login
+
+# Step 3: Save account B
+aicli-switch add personal
+
+# Step 4: Now switch freely — no re-login needed
+aicli-switch work        # → switches to work account
+aicli-switch personal    # → switches to personal account
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `aicli-switch add <name>` | Save current Claude Code session as a named profile |
+| `aicli-switch add <name> -t apikey` | Add an API Key profile (interactive) |
+| `aicli-switch <name>` | Switch to a profile |
+| `aicli-switch ls` | List all profiles with status |
+| `aicli-switch status` | Show active profile details |
+| `aicli-switch refresh [name]` | Manually refresh an OAuth token |
+| `aicli-switch rm <name>` | Delete a profile |
+| `aicli-switch version` | Show version |
+
+## What It Looks Like
+
+```
+$ aicli-switch ls
+  NAME       TYPE   EMAIL                 STATUS   EXPIRY
+▶ work       oauth  user@company.com      valid    6.9d
+  personal   oauth  me@gmail.com          valid    4.2d
+  relay      apikey -                     ready    n/a
+
+$ aicli-switch personal
+Switched to profile "personal" (oauth)
+  Email: me@gmail.com
+
+$ aicli-switch status
+Active Profile: personal
+  Type:    oauth
+  Email:   me@gmail.com
+  Token:   valid (expires in 4.2d)
+```
+
+## How It Works
+
+### OAuth Profiles
+
+1. **`add`** — copies your encrypted OAuth credentials (`~/.factory/auth.v2.*`) into `~/.cc-profiles/<name>/`
+2. **`switch`** — checks if the token is expired → refreshes if needed → restores credentials to `~/.factory/`
+3. **Token refresh** — calls Claude's OAuth endpoint with the saved refresh_token, no browser needed
+
+### API Key Profiles
+
+1. **`add -t apikey`** — prompts for API Key and Base URL, saves to profile
+2. **`switch`** — updates `ANTHROPIC_API_KEY` and `ANTHROPIC_BASE_URL` in `~/.claude/settings.json`
+
+### Storage Layout
+
+```
+~/.cc-profiles/
+├── _active                # Name of the currently active profile
+├── work/
+│   ├── auth.v2.file       # AES-256-GCM encrypted OAuth tokens
+│   ├── auth.v2.key        # Encryption key
+│   └── profile.json       # Metadata (name, type, email, timestamps)
+└── personal/
+    └── ...
+```
+
+### Security
+
+- Credentials are **always encrypted** (AES-256-GCM), same as Claude Code itself
+- Each profile has its own encryption key
+- No plaintext tokens anywhere on disk
+- The `_active` file only stores the profile name
+
+## Update Detection
+
+aicli-switch checks for new versions once per day (non-blocking). When an update is available:
+
+```
+Update available: 0.1.0 → 0.2.0
+  Run: npm update -g aicli-switch
+  Or:  https://github.com/killaragorn/aicli-switch/releases/tag/v0.2.0
+```
+
+## Roadmap
+
+- [ ] OpenAI Codex CLI credential switching
+- [ ] Gemini CLI credential switching
+- [ ] Automatic failover on rate-limit
+- [ ] Profile import/export
+
+## License
+
+MIT

package/bin/aicli-switch.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+"use strict";
+
+const { execFileSync } = require("child_process");
+const path = require("path");
+const fs = require("fs");
+
+const ext = process.platform === "win32" ? ".exe" : "";
+const binPath = path.join(__dirname, `aicli-switch${ext}`);
+
+if (!fs.existsSync(binPath)) {
+  console.error("aicli-switch binary not found. Try reinstalling:");
+  console.error("  npm install -g aicli-switch");
+  process.exit(1);
+}
+
+try {
+  const result = execFileSync(binPath, process.argv.slice(2), {
+    stdio: "inherit",
+    windowsHide: true,
+  });
+} catch (err) {
+  process.exit(err.status || 1);
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@kio_ai/aicli-switch",
+  "version": "0.1.0",
+  "description": "CLI tool for switching AI CLI tool credentials (Claude Code OAuth, API Keys)",
+  "keywords": [
+    "claude-code",
+    "oauth",
+    "account-switch",
+    "ai-cli",
+    "credential-manager"
+  ],
+  "license": "MIT",
+  "author": "killaragorn",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/killaragorn/aicli-switch.git"
+  },
+  "bin": {
+    "aicli-switch": "bin/aicli-switch.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/install.js"
+  },
+  "os": [
+    "win32",
+    "darwin",
+    "linux"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "files": [
+    "bin/",
+    "scripts/",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/scripts/install.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+"use strict";
+
+const https = require("https");
+const fs = require("fs");
+const path = require("path");
+const { execSync } = require("child_process");
+
+const REPO = "killaragorn/aicli-switch";
+const BIN_DIR = path.join(__dirname, "..", "bin");
+const VERSION = require("../package.json").version;
+
+const PLATFORM_MAP = {
+  win32:  { os: "windows", arch: "amd64", ext: ".exe" },
+  darwin: { os: "darwin",  arch: "amd64", ext: "" },
+  linux:  { os: "linux",   arch: "amd64", ext: "" },
+};
+
+const ARM64_OVERRIDE = {
+  darwin: { os: "darwin", arch: "arm64", ext: "" },
+  linux:  { os: "linux",  arch: "arm64", ext: "" },
+};
+
+function getPlatform() {
+  const platform = process.platform;
+  const arch = process.arch;
+
+  if (arch === "arm64" && ARM64_OVERRIDE[platform]) {
+    return ARM64_OVERRIDE[platform];
+  }
+
+  const info = PLATFORM_MAP[platform];
+  if (!info) {
+    console.error(`Unsupported platform: ${platform}/${arch}`);
+    console.error("Please build from source: go build -o aicli-switch .");
+    process.exit(0); // Don't fail npm install
+  }
+  return info;
+}
+
+function downloadFile(url, dest) {
+  return new Promise((resolve, reject) => {
+    function follow(u) {
+      https.get(u, { headers: { "User-Agent": "aicli-switch-npm" } }, (res) => {
+        if (res.statusCode === 302 || res.statusCode === 301) {
+          follow(res.headers.location);
+          return;
+        }
+        if (res.statusCode !== 200) {
+          reject(new Error(`Download failed: HTTP ${res.statusCode}`));
+          return;
+        }
+        const file = fs.createWriteStream(dest);
+        res.pipe(file);
+        file.on("finish", () => { file.close(); resolve(); });
+        file.on("error", reject);
+      }).on("error", reject);
+    }
+    follow(url);
+  });
+}
+
+async function main() {
+  const { os: goos, arch, ext } = getPlatform();
+  const binName = `aicli-switch${ext}`;
+  const assetName = `aicli-switch-${goos}-${arch}${ext}`;
+  const url = `https://github.com/${REPO}/releases/download/v${VERSION}/${assetName}`;
+  const dest = path.join(BIN_DIR, binName);
+
+  // Skip if binary already exists (e.g., local development)
+  if (fs.existsSync(dest)) {
+    console.log(`aicli-switch binary already exists at ${dest}`);
+    return;
+  }
+
+  fs.mkdirSync(BIN_DIR, { recursive: true });
+  console.log(`Downloading aicli-switch v${VERSION} for ${goos}/${arch}...`);
+  console.log(`  From: ${url}`);
+
+  try {
+    await downloadFile(url, dest);
+
+    // Make executable on Unix
+    if (process.platform !== "win32") {
+      fs.chmodSync(dest, 0o755);
+    }
+
+    console.log(`aicli-switch installed successfully!`);
+  } catch (err) {
+    console.error(`\nFailed to download pre-built binary: ${err.message}`);
+    console.error(`\nYou can build from source instead:`);
+    console.error(`  git clone https://github.com/${REPO}.git`);
+    console.error(`  cd aicli-switch && go build -o aicli-switch .`);
+    // Don't fail npm install - user can build manually
+  }
+}
+
+main();