cc-wrapper 0.1.0

package/README.md

@@ -0,0 +1,294 @@
+# cc-wrapper
+
+> Cross-platform CLI wrapper for [Claude Code](https://claude.ai/code) with named environment profiles, arg passthrough, and zero config friction.
+
+[![npm version](https://img.shields.io/npm/v/cc-wrapper)](https://www.npmjs.com/package/cc-wrapper)
+[![npm downloads](https://img.shields.io/npm/dm/cc-wrapper)](https://www.npmjs.com/package/cc-wrapper)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Node.js >= 20](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)
+[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-blue)](#)
+
+Switch between Claude environments — local proxies, OpenRouter, AWS Bedrock, Google Vertex AI — with a single command instead of exporting env vars every time.
+
+```bash
+# Before cc-wrapper
+ANTHROPIC_BASE_URL=http://localhost:8787 ANTHROPIC_AUTH_TOKEN=my-token claude
+
+# After cc-wrapper
+cc-wrapper claude
+```
+
+---
+
+## Table of Contents
+
+- [Features](#features)
+- [Requirements](#requirements)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Commands](#commands)
+- [Configuration](#configuration)
+- [Supported Environment Variables](#supported-environment-variables)
+- [Security](#security)
+- [Contributing](#contributing)
+- [License](#license)
+
+---
+
+## Features
+
+- **Named profiles** — save multiple Claude environments (local, openrouter, vertex, bedrock, etc.)
+- **Interactive setup** — searchable env var selector with descriptions and example values
+- **Auto `--dangerously-skip-permissions`** — injected by default, disable with `--dd`
+- **Full arg passthrough** — all extra args forwarded to `claude` unchanged
+- **Cross-platform** — Windows, macOS, Linux; config stored at correct OS path automatically
+- **Secret masking** — API keys and tokens masked in all log output
+- **Live sync** — fetch latest Claude env vars from official docs with `npm run sync-envs`
+
+---
+
+## Requirements
+
+- [Node.js](https://nodejs.org) >= 20
+- [Claude Code CLI](https://claude.ai/code) installed and accessible as `claude` in PATH
+
+---
+
+## Installation
+
+```bash
+npm install -g cc-wrapper
+```
+
+Verify:
+
+```bash
+cc-wrapper --version
+cc-wrapper --help
+```
+
+---
+
+## Quick Start
+
+**1. Create your first profile:**
+
+```bash
+cc-wrapper new
+```
+
+You will be prompted for:
+- Profile name (e.g. `local`, `openrouter`, `vertex`)
+- Which Claude env vars to set (searchable, numbered list with descriptions)
+- Value for each selected env var (with examples shown inline)
+- Default extra args to pass to `claude`
+
+**2. Run Claude with the profile:**
+
+```bash
+cc-wrapper claude
+```
+
+---
+
+## Commands
+
+### `cc-wrapper new`
+
+Create a new named profile interactively.
+
+```bash
+cc-wrapper new
+```
+
+Flow:
+1. Enter profile name
+2. Multi-select env vars from numbered list (SPACE to toggle, ENTER to confirm)
+3. Enter value for each selected var (example shown inline)
+4. Enter default claude args
+5. Profile saved — set as default if it's the first one
+
+---
+
+### `cc-wrapper list`
+
+List all saved profiles. Default profile is highlighted.
+
+```bash
+cc-wrapper list
+```
+
+```
+● local  (default)
+○ openrouter
+○ vertex
+```
+
+---
+
+### `cc-wrapper default <name>`
+
+Set the default profile used by `cc-wrapper claude`.
+
+```bash
+cc-wrapper default openrouter
+```
+
+---
+
+### `cc-wrapper edit <name>`
+
+Interactively edit an existing profile. Current values are pre-filled and masked.
+
+```bash
+cc-wrapper edit local
+```
+
+---
+
+### `cc-wrapper delete <name>`
+
+Delete a profile (confirmation prompt required).
+
+```bash
+cc-wrapper delete vertex
+```
+
+If the deleted profile was the default, the next available profile becomes the new default automatically.
+
+---
+
+### `cc-wrapper claude [args...]`
+
+Launch `claude` with the default profile's environment variables injected.
+
+```bash
+cc-wrapper claude
+```
+
+**Pass extra args directly to claude:**
+
+```bash
+cc-wrapper claude --print "explain this codebase"
+cc-wrapper claude --model claude-opus-4-7-20250514
+cc-wrapper claude --no-stream
+```
+
+**Disable automatic `--dangerously-skip-permissions` injection:**
+
+```bash
+cc-wrapper claude --dd
+```
+
+**Use a specific profile instead of default:**
+
+```bash
+cc-wrapper claude --profile openrouter
+cc-wrapper claude -p vertex --print "hello"
+```
+
+---
+
+## Configuration
+
+Config is stored as a single JSON file at the OS-appropriate path:
+
+| OS | Path |
+|---|---|
+| Linux | `~/.config/cc-wrapper/config.json` |
+| macOS | `~/Library/Preferences/cc-wrapper/config.json` |
+| Windows | `%APPDATA%\cc-wrapper\config.json` |
+
+### Config schema
+
+```json
+{
+  "default": "local",
+  "configs": {
+    "local": {
+      "env": {
+        "ANTHROPIC_BASE_URL": "http://localhost:8787",
+        "ANTHROPIC_AUTH_TOKEN": "my-token"
+      },
+      "args": []
+    },
+    "openrouter": {
+      "env": {
+        "ANTHROPIC_BASE_URL": "https://openrouter.ai/api/v1",
+        "ANTHROPIC_API_KEY": "sk-or-..."
+      },
+      "args": ["--model", "anthropic/claude-opus-4"]
+    },
+    "vertex": {
+      "env": {
+        "CLAUDE_CODE_USE_VERTEX": "1",
+        "ANTHROPIC_VERTEX_PROJECT_ID": "my-gcp-project",
+        "CLOUD_ML_REGION": "us-central1"
+      },
+      "args": []
+    }
+  }
+}
+```
+
+You can edit this file directly or use `cc-wrapper edit <name>`.
+
+---
+
+## Supported Environment Variables
+
+cc-wrapper supports all official Claude Code environment variables. The list is stored in `src/data/env-vars.json` and can be refreshed from the official docs:
+
+```bash
+npm run sync-envs
+```
+
+Key variables include:
+
+| Variable | Description |
+|---|---|
+| `ANTHROPIC_API_KEY` | Anthropic API key |
+| `ANTHROPIC_BASE_URL` | Custom API base URL (local proxy, OpenRouter, etc.) |
+| `ANTHROPIC_AUTH_TOKEN` | Bearer token for custom auth |
+| `ANTHROPIC_MODEL` | Override default model |
+| `CLAUDE_CODE_USE_VERTEX` | Use Google Vertex AI |
+| `CLAUDE_CODE_USE_BEDROCK` | Use AWS Bedrock |
+| `AWS_REGION` | AWS region for Bedrock |
+| `CLOUD_ML_REGION` | GCP region for Vertex |
+| `HTTP_PROXY` / `HTTPS_PROXY` | Proxy settings |
+| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Override max output tokens |
+| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Disable telemetry |
+
+Full list: run `cc-wrapper new` and browse the interactive selector.
+
+---
+
+## Security
+
+- API keys and tokens are **never printed** in logs — always masked (e.g. `sk-a*****`)
+- Config file lives in your user data directory, not in project folders
+- No values are sent anywhere other than the `claude` process environment
+
+---
+
+## Contributing
+
+```bash
+git clone https://github.com/aminechraibi/cc-wrapper
+cd cc-wrapper
+npm install
+npm test
+npm run build
+```
+
+Refresh Claude env var list from official docs:
+
+```bash
+npm run sync-envs
+```
+
+---
+
+## License
+
+MIT — [Amine Chraibi](https://github.com/aminechraibi)

package/dist/cli.js

@@ -0,0 +1,329 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { cac } from "cac";
+import chalk7 from "chalk";
+
+// src/commands/new.ts
+import { input as input2 } from "@inquirer/prompts";
+import chalk from "chalk";
+
+// src/config/store.ts
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
+import { dirname } from "path";
+
+// src/config/schema.ts
+import { z } from "zod";
+var ProfileSchema = z.object({
+  env: z.record(z.string(), z.string()),
+  args: z.array(z.string())
+});
+var ConfigSchema = z.object({
+  default: z.string().nullable(),
+  configs: z.record(z.string(), ProfileSchema)
+});
+
+// src/config/store.ts
+var EMPTY_CONFIG = { default: null, configs: {} };
+async function readConfig(path) {
+  if (!existsSync(path)) return structuredClone(EMPTY_CONFIG);
+  const raw = readFileSync(path, "utf-8");
+  const parsed = JSON.parse(raw);
+  return ConfigSchema.parse(parsed);
+}
+async function writeConfig(path, config) {
+  mkdirSync(dirname(path), { recursive: true });
+  writeFileSync(path, JSON.stringify(config, null, 2), "utf-8");
+}
+
+// src/config/paths.ts
+import envPaths from "env-paths";
+import { join } from "path";
+var paths = envPaths("cc-wrapper", { suffix: "" });
+function getConfigPath() {
+  if (process.env["CC_WRAPPER_CONFIG_PATH"]) {
+    return process.env["CC_WRAPPER_CONFIG_PATH"];
+  }
+  return join(paths.config, "config.json");
+}
+
+// src/prompts/env-selector.ts
+import { checkbox, input } from "@inquirer/prompts";
+
+// src/utils/mask.ts
+var SECRET_PATTERN = /key|token|secret|password|credential/i;
+function maskValue(value) {
+  if (value.length <= 4) return "*****";
+  return value.slice(0, 4) + "*****";
+}
+function maskEnv(env) {
+  return Object.fromEntries(
+    Object.entries(env).map(([k, v]) => [k, SECRET_PATTERN.test(k) ? maskValue(v) : v])
+  );
+}
+
+// src/prompts/env-selector.ts
+var ENV_EXAMPLES = {
+  ANTHROPIC_API_KEY: "sk-ant-api03-...",
+  ANTHROPIC_BASE_URL: "http://localhost:8787",
+  ANTHROPIC_AUTH_TOKEN: "Bearer sk-ant-...",
+  ANTHROPIC_MODEL: "claude-opus-4-7-20250514",
+  ANTHROPIC_SMALL_FAST_MODEL: "claude-haiku-4-5-20251001",
+  ANTHROPIC_VERTEX_PROJECT_ID: "my-gcp-project-123",
+  CLOUD_ML_REGION: "us-central1",
+  AWS_REGION: "us-east-1",
+  AWS_ACCESS_KEY_ID: "AKIAIOSFODNN7EXAMPLE",
+  AWS_SECRET_ACCESS_KEY: "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
+  HTTP_PROXY: "http://proxy.corp.com:3128",
+  HTTPS_PROXY: "http://proxy.corp.com:3128",
+  NO_PROXY: "localhost,127.0.0.1",
+  BASH_DEFAULT_TIMEOUT_MS: "30000",
+  BASH_MAX_TIMEOUT_MS: "120000",
+  BASH_MAX_OUTPUT_LENGTH: "50000",
+  CLAUDE_CODE_MAX_OUTPUT_TOKENS: "8192",
+  MCP_TIMEOUT: "10000",
+  MCP_TOOL_TIMEOUT: "60000"
+};
+async function promptEnvSelection(envVars, existing = {}) {
+  const selected = await checkbox({
+    message: "Select env vars (SPACE to toggle, ENTER to confirm):",
+    choices: envVars.map((v, i) => ({
+      name: `${String(i + 1).padStart(2)}. ${v.name}${existing[v.name] ? ` [${maskValue(existing[v.name])}]` : ""}`,
+      value: v.name,
+      checked: v.name in existing,
+      description: v.description
+    })),
+    pageSize: 15
+  });
+  const result = {};
+  for (const name of selected) {
+    const current = existing[name];
+    const example = ENV_EXAMPLES[name];
+    let hint = "";
+    if (current) hint = ` (current: ${maskValue(current)}, leave blank to keep)`;
+    else if (example) hint = ` (e.g. ${example})`;
+    const value = await input({
+      message: `${name}${hint}:`,
+      required: !current
+    });
+    result[name] = value || current || "";
+  }
+  return result;
+}
+async function promptArgs(existing = []) {
+  const raw = await input({
+    message: "Default claude args (space-separated, e.g. --print --model claude-opus-4-7):",
+    default: existing.join(" ")
+  });
+  return raw.trim() ? raw.trim().split(/\s+/) : [];
+}
+
+// src/data/env-vars.json
+var env_vars_default = [
+  { name: "ANTHROPIC_API_KEY", description: "Anthropic API key for authentication" },
+  { name: "ANTHROPIC_BASE_URL", description: "Custom base URL for Anthropic API (e.g. local proxy)" },
+  { name: "ANTHROPIC_AUTH_TOKEN", description: "Bearer token for custom auth header" },
+  { name: "CLAUDE_CODE_USE_VERTEX", description: "Use Google Cloud Vertex AI instead of Anthropic API" },
+  { name: "ANTHROPIC_VERTEX_PROJECT_ID", description: "Google Cloud project ID for Vertex AI" },
+  { name: "CLOUD_ML_REGION", description: "Google Cloud region for Vertex AI" },
+  { name: "CLAUDE_CODE_USE_BEDROCK", description: "Use AWS Bedrock instead of Anthropic API" },
+  { name: "AWS_REGION", description: "AWS region for Bedrock" },
+  { name: "AWS_ACCESS_KEY_ID", description: "AWS access key ID for Bedrock auth" },
+  { name: "AWS_SECRET_ACCESS_KEY", description: "AWS secret access key for Bedrock auth" },
+  { name: "AWS_SESSION_TOKEN", description: "AWS session token for Bedrock auth" },
+  { name: "HTTP_PROXY", description: "HTTP proxy URL" },
+  { name: "HTTPS_PROXY", description: "HTTPS proxy URL" },
+  { name: "NO_PROXY", description: "Comma-separated hosts to bypass proxy" },
+  { name: "CLAUDE_CODE_MAX_OUTPUT_TOKENS", description: "Max output tokens for Claude responses" },
+  { name: "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", description: "Disable telemetry and version checks" },
+  { name: "ANTHROPIC_MODEL", description: "Override default Claude model" },
+  { name: "ANTHROPIC_SMALL_FAST_MODEL", description: "Override background task model" },
+  { name: "BASH_DEFAULT_TIMEOUT_MS", description: "Default bash command timeout in milliseconds" },
+  { name: "BASH_MAX_TIMEOUT_MS", description: "Maximum bash command timeout in milliseconds" },
+  { name: "BASH_MAX_OUTPUT_LENGTH", description: "Max characters of bash output before truncation" },
+  { name: "CLAUDE_CODE_API_KEY_HELPER_TTL_MS", description: "TTL for API key helper cache" },
+  { name: "CLAUDE_CODE_SKIP_BEDROCK_AUTH", description: "Skip Bedrock auth validation" },
+  { name: "CLAUDE_CODE_SKIP_VERTEX_AUTH", description: "Skip Vertex auth validation" },
+  { name: "MCP_TIMEOUT", description: "Timeout in ms for MCP server startup" },
+  { name: "MCP_TOOL_TIMEOUT", description: "Timeout in ms for individual MCP tool calls" }
+];
+
+// src/commands/new.ts
+async function newCommand() {
+  const configPath = getConfigPath();
+  const config = await readConfig(configPath);
+  const name = await input2({
+    message: "Profile name (e.g. local, openrouter, vertex, bedrock):",
+    validate: (v) => {
+      if (!v.trim()) return "Name required";
+      if (config.configs[v.trim()]) return `Profile "${v.trim()}" already exists`;
+      return true;
+    }
+  });
+  const profileName = name.trim();
+  const env = await promptEnvSelection(env_vars_default);
+  const args = await promptArgs();
+  config.configs[profileName] = { env, args };
+  if (!config.default) {
+    config.default = profileName;
+    console.log(chalk.dim(`Set "${profileName}" as default (first profile)`));
+  }
+  await writeConfig(configPath, config);
+  console.log(chalk.green(`\u2713 Profile "${profileName}" saved`));
+}
+
+// src/commands/list.ts
+import chalk2 from "chalk";
+async function listCommand() {
+  const config = await readConfig(getConfigPath());
+  const names = Object.keys(config.configs);
+  if (names.length === 0) {
+    console.log(chalk2.dim("No profiles. Run `cc-wrapper new` to create one."));
+    return;
+  }
+  for (const name of names) {
+    const isDefault = name === config.default;
+    const bullet = isDefault ? chalk2.green("\u25CF") : chalk2.dim("\u25CB");
+    const label = isDefault ? chalk2.bold(name) + chalk2.dim(" (default)") : name;
+    console.log(`${bullet} ${label}`);
+  }
+}
+
+// src/commands/default.ts
+import chalk3 from "chalk";
+async function defaultCommand(name) {
+  const configPath = getConfigPath();
+  const config = await readConfig(configPath);
+  if (!config.configs[name]) {
+    console.error(chalk3.red(`Profile "${name}" not found`));
+    process.exit(1);
+  }
+  config.default = name;
+  await writeConfig(configPath, config);
+  console.log(chalk3.green(`\u2713 Default set to "${name}"`));
+}
+
+// src/commands/edit.ts
+import chalk4 from "chalk";
+async function editCommand(name) {
+  const configPath = getConfigPath();
+  const config = await readConfig(configPath);
+  if (!config.configs[name]) {
+    console.error(chalk4.red(`Profile "${name}" not found`));
+    process.exit(1);
+  }
+  const profile = config.configs[name];
+  const env = await promptEnvSelection(env_vars_default, profile.env);
+  const args = await promptArgs(profile.args);
+  config.configs[name] = { env, args };
+  await writeConfig(configPath, config);
+  console.log(chalk4.green(`\u2713 Profile "${name}" updated`));
+}
+
+// src/commands/delete.ts
+import { confirm } from "@inquirer/prompts";
+import chalk5 from "chalk";
+async function deleteCommand(name) {
+  const configPath = getConfigPath();
+  const config = await readConfig(configPath);
+  if (!config.configs[name]) {
+    console.error(chalk5.red(`Profile "${name}" not found`));
+    process.exit(1);
+  }
+  const ok = await confirm({ message: `Delete profile "${name}"?`, default: false });
+  if (!ok) {
+    console.log(chalk5.dim("Cancelled"));
+    return;
+  }
+  delete config.configs[name];
+  if (config.default === name) {
+    const remaining = Object.keys(config.configs);
+    config.default = remaining[0] ?? null;
+    if (config.default) {
+      console.log(chalk5.dim(`Default changed to "${config.default}"`));
+    }
+  }
+  await writeConfig(configPath, config);
+  console.log(chalk5.green(`\u2713 Profile "${name}" deleted`));
+}
+
+// src/commands/claude.ts
+import chalk6 from "chalk";
+import ora from "ora";
+
+// src/utils/spawn.ts
+import spawn from "cross-spawn";
+function spawnClaude(args, env) {
+  return new Promise((resolve, reject) => {
+    const child = spawn("claude", args, {
+      stdio: "inherit",
+      shell: true,
+      env
+    });
+    child.on("close", (code) => resolve(code ?? 0));
+    child.on("error", reject);
+  });
+}
+
+// src/commands/claude.ts
+var DANGEROUS = "--dangerously-skip-permissions";
+function buildClaudeArgs(profileArgs, extraArgs, disableDangerous) {
+  const base = profileArgs.filter((a) => a !== DANGEROUS);
+  if (!disableDangerous) base.unshift(DANGEROUS);
+  return [...base, ...extraArgs];
+}
+async function claudeCommand(extraArgs, options) {
+  const configPath = getConfigPath();
+  const config = await readConfig(configPath);
+  const profileName = options.profile ?? config.default;
+  if (!profileName) {
+    console.error(chalk6.red("No default profile set. Run `cc-wrapper new` or `cc-wrapper default <name>`."));
+    process.exit(1);
+  }
+  const profile = config.configs[profileName];
+  if (!profile) {
+    console.error(chalk6.red(`Profile "${profileName}" not found`));
+    process.exit(1);
+  }
+  const args = buildClaudeArgs(profile.args, extraArgs, !!options.dd);
+  const env = { ...process.env, ...profile.env };
+  const spinner = ora(`Launching claude (profile: ${profileName})`).start();
+  console.log(chalk6.dim("env: " + JSON.stringify(maskEnv(profile.env))));
+  spinner.stop();
+  const code = await spawnClaude(args, env);
+  process.exit(code);
+}
+
+// src/cli.ts
+process.on("SIGINT", () => {
+  process.stdout.write("\n");
+  process.exit(0);
+});
+process.on("uncaughtException", (err) => {
+  if (err.name === "ExitPromptError") {
+    process.stdout.write("\n");
+    process.exit(0);
+  }
+  console.error(chalk7.red(`Error: ${err.message}`));
+  process.exit(1);
+});
+process.on("unhandledRejection", (reason) => {
+  if (reason instanceof Error && reason.name === "ExitPromptError") {
+    process.stdout.write("\n");
+    process.exit(0);
+  }
+  console.error(chalk7.red(`Error: ${String(reason)}`));
+  process.exit(1);
+});
+var cli = cac("cc-wrapper");
+cli.command("new", "Create a new profile").action(newCommand);
+cli.command("list", "List all profiles").action(listCommand);
+cli.command("default <name>", "Set default profile").action(defaultCommand);
+cli.command("edit <name>", "Edit a profile interactively").action(editCommand);
+cli.command("delete <name>", "Delete a profile").action(deleteCommand);
+cli.command("claude [...args]", "Run claude with the default profile").option("--dd", "Disable --dangerously-skip-permissions injection").option("-p, --profile <name>", "Use a specific profile instead of default").action((args, options) => {
+  return claudeCommand(args, options);
+});
+cli.help();
+cli.version("0.1.0");
+cli.parse();

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "cc-wrapper",
+  "version": "0.1.0",
+  "description": "Cross-platform CLI wrapper for claude with reusable environment profiles",
+  "type": "module",
+  "bin": {
+    "cc-wrapper": "./dist/cli.js"
+  },
+  "main": "./dist/cli.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "start": "node dist/cli.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "sync-envs": "npx tsx scripts/sync-envs.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["claude", "anthropic", "cli", "wrapper", "profiles"],
+  "author": "Amine Chraibi <aminechraibi2020@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aminechraibi/cc-wrapper"
+  },
+  "homepage": "https://github.com/aminechraibi/cc-wrapper#readme",
+  "bugs": {
+    "url": "https://github.com/aminechraibi/cc-wrapper/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.5.0",
+    "cac": "^6.7.14",
+    "chalk": "^5.4.1",
+    "cross-spawn": "^7.0.6",
+    "env-paths": "^3.0.0",
+    "ora": "^8.2.0",
+    "zod": "^3.24.3"
+  },
+  "devDependencies": {
+    "@types/cross-spawn": "^6.0.6",
+    "@types/node": "^20.0.0",
+    "tsx": "^4.19.4",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.4"
+  }
+}