@sekora_ai/claude-toggle 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Sean Sekora
+
+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/PROVIDERS.md

@@ -0,0 +1,169 @@
+# Provider Configuration Guide
+
+This guide explains how to add and configure new AI providers for the `claude-toggle` script.
+
+## Configuration File Location
+
+The script searches for `providers.json` in the following order:
+
+1. `~/.config/claude-providers/providers.json` (recommended)
+2. `~/.claude-providers.json`
+3. `<script-directory>/providers.json`
+
+## JSON Schema
+
+```json
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "version": "1.0",
+  "default_provider": "anthropic",
+  "providers": {
+    "<provider_name>": {
+      "description": "Human-readable description",
+      "enabled": true,
+      "env_vars": {
+        "ENV_VAR_NAME": {
+          "value": "static-value-or-${OTHER_VAR}",
+          "required": false
+        }
+      },
+      "validation": {
+        "required_env_vars": ["API_KEY_VAR"],
+        "optional_commands": ["command --version"]
+      }
+    }
+  }
+}
+```
+
+## Configuration Fields
+
+### Top Level
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `version` | string | Yes | Configuration format version (use "1.0") |
+| `default_provider` | string | No | Default provider name (defaults to "anthropic") |
+| `providers` | object | Yes | Provider configurations keyed by name |
+
+### Provider Object
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `description` | string | No | Human-readable description of the provider |
+| `enabled` | boolean | Yes | Whether this provider is available for use |
+| `env_vars` | object | No | Environment variables to set for this provider |
+| `validation` | object | No | Validation rules for this provider |
+
+### Environment Variables (`env_vars`)
+
+Each key is an environment variable name. Each value is an object with:
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `value` | string | Yes | Value to set. Use `${VAR_NAME}` to reference another env var |
+| `required` | boolean | No | Whether this field must have a non-empty value |
+
+### Validation (`validation`)
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `required_env_vars` | array | No | List of env var names that must be set |
+| `optional_commands` | array | No | Commands that should be available (informational) |
+
+## Example: Adding an OpenAI Provider
+
+```json
+{
+  "version": "1.0",
+  "default_provider": "anthropic",
+  "providers": {
+    "anthropic": {
+      "description": "Anthropic's official API",
+      "enabled": true,
+      "env_vars": {},
+      "validation": {}
+    },
+    "openai": {
+      "description": "OpenAI API (via compatibility layer)",
+      "enabled": true,
+      "env_vars": {
+        "OPENAI_API_KEY": {
+          "value": "${OPENAI_API_KEY}",
+          "required": true
+        },
+        "ANTHROPIC_BASE_URL": {
+          "value": "https://api.openai.com/v1"
+        }
+      },
+      "validation": {
+        "required_env_vars": ["OPENAI_API_KEY"]
+      }
+    }
+  }
+}
+```
+
+Then use it:
+
+```bash
+./claude-toggle --provider openai
+```
+
+## Example: Adding a Self-Hosted Provider (Ollama)
+
+```json
+{
+  "version": "1.0",
+  "providers": {
+    "ollama": {
+      "description": "Local Ollama instance",
+      "enabled": true,
+      "env_vars": {
+        "ANTHROPIC_BASE_URL": {
+          "value": "http://localhost:11434/v1"
+        },
+        "ANTHROPIC_DEFAULT_HAIKU_MODEL": {
+          "value": "llama3.2"
+        },
+        "ANTHROPIC_DEFAULT_SONNET_MODEL": {
+          "value": "llama3.2"
+        },
+        "ANTHROPIC_DEFAULT_OPUS_MODEL": {
+          "value": "llama3.2"
+        }
+      },
+      "validation": {
+        "optional_commands": ["ollama --version"]
+      }
+    }
+  }
+}
+```
+
+## Tips
+
+1. **Variable References**: Use `${VAR_NAME}` in `value` fields to reference environment variables. The script will expand these at runtime.
+
+2. **Model Mappings**: Claude Code uses three model tiers (haiku, sonnet, opus). Map these to appropriate models for your provider.
+
+3. **API Timeouts**: For slower providers, increase `API_TIMEOUT_MS` (value is in milliseconds).
+
+4. **Disable Providers**: Set `"enabled": false` to temporarily disable a provider without removing its configuration.
+
+5. **Validation**: Use `required_env_vars` to ensure credentials are set before launching. The script will show helpful setup instructions if they're missing.
+
+## Testing Your Configuration
+
+After adding a new provider, validate it:
+
+```bash
+# List all providers
+./claude-toggle --list-providers
+
+# Validate specific provider
+./claude-toggle --validate --provider <name>
+
+# Test with verbose output
+./claude-toggle --verbose --provider <name> --help
+```

package/README.md

@@ -0,0 +1,382 @@
+# claude-toggle
+
+A provider-agnostic utility for toggling between different Claude API providers in Claude Code. Switch seamlessly between Anthropic's official API, Z.AI GLM models, OpenAI-compatible endpoints, or self-hosted solutions.
+
+## Features
+
+- **Provider-agnostic architecture** - JSON-based configuration for easy provider management
+- **Zero file modifications** - All changes are scoped to the subprocess environment
+- **Pass-through design** - All Claude Code CLI options work transparently
+- **Actionable error messages** - Missing credentials trigger detailed setup instructions
+- **Extensible** - Add new providers by editing a single JSON file
+
+## Prerequisites
+
+- Bash (version 4.0+)
+- Python 3 (for JSON parsing, no external packages required)
+- [Claude Code CLI](https://claude.ai/code) installed and available as `claude`
+
+## Installation
+
+### Option 1: npm (Recommended)
+
+```bash
+npm install -g @sekora_ai/claude-toggle
+```
+
+This works on macOS, Linux, and Windows (via WSL or Git Bash).
+
+### Option 2: Manual Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/seansekora/claude-toggle.git
+cd claude-toggle
+chmod +x claude-toggle
+
+# Copy default config to user directory
+mkdir -p ~/.config/claude-providers
+cp providers.json ~/.config/claude-providers/
+
+# Add to PATH (choose your shell)
+# For bash:
+echo 'export PATH="$HOME/path/to/claude-toggle:$PATH"' >> ~/.bashrc
+source ~/.bashrc
+
+# For zsh:
+echo 'export PATH="$HOME/path/to/claude-toggle:$PATH"' >> ~/.zshrc
+source ~/.zshrc
+```
+
+## Usage
+
+### Basic Usage
+
+```bash
+# Launch with default provider (Anthropic)
+./claude-toggle
+
+# Launch with specific provider
+./claude-toggle --provider glm
+
+# List available providers
+./claude-toggle --list-providers
+
+# Validate provider configuration
+./claude-toggle --validate --provider glm
+```
+
+### Pass-through Options
+
+All unrecognized options are forwarded to the Claude Code CLI:
+
+```bash
+# Pass options to Claude Code
+./claude-toggle --provider glm --dangerously-skip-permissions
+
+# Any Claude Code option works
+./claude-toggle --provider anthropic --help
+```
+
+### Command Reference
+
+| Option | Description |
+|--------|-------------|
+| `-p, --provider <name>` | Select a specific provider |
+| `-l, --list-providers` | List all available providers |
+| `--validate` | Validate provider configuration without launching |
+| `-v, --verbose` | Enable verbose output |
+| `-h, --help` | Show help message |
+| `--glm` | Legacy alias for `--provider glm` |
+
+## Configuration
+
+### Configuration File Location
+
+The script searches for `providers.json` in this order:
+
+1. `~/.config/claude-providers/providers.json` (recommended)
+2. `~/.claude-providers.json`
+3. `<script-directory>/providers.json`
+
+### Provider Configuration
+
+Providers are configured in `providers.json`:
+
+```json
+{
+  "version": "1.0",
+  "default_provider": "anthropic",
+  "providers": {
+    "anthropic": {
+      "description": "Anthropic's official API",
+      "enabled": true,
+      "env_vars": {},
+      "validation": {}
+    },
+    "glm": {
+      "description": "Z.AI GLM models via proxy",
+      "enabled": true,
+      "env_vars": {
+        "ANTHROPIC_AUTH_TOKEN": {
+          "value": "${ZAI_API_KEY}",
+          "required": true
+        },
+        "ANTHROPIC_BASE_URL": {
+          "value": "https://api.z.ai/api/anthropic"
+        }
+      },
+      "validation": {
+        "required_env_vars": ["ZAI_API_KEY"]
+      }
+    }
+  }
+}
+```
+
+### Adding New Providers
+
+**Interactive wizard (recommended):**
+
+If you're using Claude Code in this repository, run:
+
+```
+/add-provider
+```
+
+This walks you through the entire process interactively.
+
+**Manual configuration:**
+
+See [PROVIDERS.md](PROVIDERS.md) for detailed instructions on adding new providers.
+
+**Quick example:**
+
+```json
+"my-provider": {
+  "description": "My custom provider",
+  "enabled": true,
+  "env_vars": {
+    "ANTHROPIC_AUTH_TOKEN": {"value": "${MY_API_KEY}"},
+    "ANTHROPIC_BASE_URL": {"value": "https://api.example.com/v1"}
+  },
+  "validation": {
+    "required_env_vars": ["MY_API_KEY"]
+  }
+}
+```
+
+## Built-in Providers
+
+| Provider | Description | Required Env Var |
+|----------|-------------|------------------|
+| `anthropic` | Anthropic's official API (default) | None (uses default auth) |
+| `glm` | Z.AI GLM models via proxy | `ZAI_API_KEY` |
+
+## Examples
+
+### Using Z.AI GLM Provider
+
+```bash
+# Set your API key
+export ZAI_API_KEY="your-key-here"
+
+# Launch Claude Code with GLM
+./claude-toggle --provider glm
+```
+
+### Validating Before Launch
+
+```bash
+# Check if provider is properly configured
+./claude-toggle --validate --provider glm
+
+# Output: Provider 'glm' is valid and ready to use
+```
+
+### Verbose Mode
+
+```bash
+# See which provider is being used
+./claude-toggle --verbose --provider glm
+
+# Output: Using provider: glm
+```
+
+## CI/CD Setup (For Maintainers)
+
+This project uses GitLab CI/CD to automatically publish to npm when version tags are pushed.
+
+### npm Token Setup
+
+> **Important**: As of December 9, 2025, npm classic tokens have been permanently revoked. You must use **Granular Access Tokens** for CI/CD automation.
+
+#### Creating a Granular Access Token
+
+1. Go to [npmjs.com](https://www.npmjs.com) → Sign in
+2. Click your avatar → **Access Tokens**
+3. Click **Generate New Token**
+4. Configure the token:
+   - **Token name**: `gitlab-ci-publish` (or similar descriptive name)
+   - **Expiration**: Up to 90 days (maximum allowed for write tokens)
+   - **Permissions**: Read and write
+   - **Packages**: All packages or select `claude-toggle` specifically
+   - **2FA**: Enable "Bypass 2FA for automation" for CI/CD workflows
+5. Click **Generate token** and copy it immediately (it won't be shown again)
+
+Alternatively, create a token via CLI:
+```bash
+npm token create
+```
+
+#### GitLab CI/CD Configuration
+
+1. Go to your GitLab project → **Settings** → **CI/CD** → **Variables**
+2. Add a new variable:
+   - **Key**: `NPM_TOKEN`
+   - **Value**: Your granular access token
+   - **Type**: Variable
+   - **Protected**: Yes (recommended)
+   - **Masked**: Yes
+3. If using protected variables, ensure version tags are protected:
+   - Go to **Settings** → **Repository** → **Protected tags**
+   - Add pattern: `v*`
+
+#### Token Rotation
+
+Since granular tokens expire after 90 days maximum, set a reminder to rotate the token before expiration. Update the `NPM_TOKEN` variable in GitLab with the new token.
+
+### Publishing a Release
+
+```bash
+# 1. Update version in package.json and claude-toggle
+# 2. Commit changes
+git add -A && git commit -m "chore: bump version to X.Y.Z"
+
+# 3. Create and push version tag
+git tag vX.Y.Z
+git push origin main --tags
+```
+
+The pipeline will automatically validate and publish to npm.
+
+## Development
+
+### Project Structure
+
+```
+claude-toggle/
+├── claude-toggle              # Main executable script
+├── providers.json             # Provider configuration
+├── package.json               # npm package manifest
+├── bin/
+│   ├── wrapper.js             # Node.js wrapper for npm
+│   └── postinstall.js         # Post-install config setup
+├── docs/
+│   └── NPM_PUBLISHING.md      # Publishing guide
+├── .claude/
+│   └── commands/
+│       └── add-provider.md    # Interactive provider wizard
+├── CLAUDE.md                  # Claude Code project instructions
+├── PROVIDERS.md               # Provider configuration guide
+├── DEVELOPER_GUIDE.md         # Development documentation
+├── LICENSE                    # MIT license
+└── README.md                  # This file
+```
+
+### Running Tests
+
+```bash
+# Test help output
+./claude-toggle --help
+
+# Test provider listing
+./claude-toggle --list-providers
+
+# Validate all providers
+./claude-toggle --validate --provider anthropic
+./claude-toggle --validate --provider glm  # Requires ZAI_API_KEY
+```
+
+### Contributing
+
+See [DEVELOPER_GUIDE.md](DEVELOPER_GUIDE.md) for development setup, coding standards, and contribution guidelines.
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feature/my-feature`
+3. Make changes and test thoroughly
+4. Commit with clear messages
+5. Open a Pull Request
+
+## How It Works
+
+1. **Configuration Loading** - Finds and parses `providers.json`
+2. **Provider Validation** - Checks required environment variables
+3. **Environment Export** - Sets provider-specific env vars for subprocess
+4. **Process Replacement** - Uses `exec claude` to launch Claude Code
+
+All environment changes are scoped to the Claude Code subprocess - your shell environment remains unchanged.
+
+## Platform Compatibility
+
+| Platform | npm | Manual |
+|----------|-----|--------|
+| macOS | Full support | Full support |
+| Linux | Full support | Full support |
+| Windows | Via WSL/Git Bash | Via WSL/Git Bash |
+
+### Windows Users
+
+claude-toggle is a bash script and requires a Unix-like environment:
+
+1. **Windows Subsystem for Linux (WSL)** - Recommended
+   ```bash
+   # Install WSL, then inside WSL:
+   npm install -g claude-toggle
+   ```
+
+2. **Git Bash** - With Python 3 installed
+   ```bash
+   npm install -g claude-toggle
+   ```
+
+## Troubleshooting
+
+### "Configuration file not found"
+
+Create a configuration file in one of the search paths:
+
+```bash
+mkdir -p ~/.config/claude-providers
+cp providers.json ~/.config/claude-providers/
+```
+
+### "Missing required credentials"
+
+The error message includes detailed setup instructions. For example, for GLM:
+
+```bash
+export ZAI_API_KEY="your-api-key-here"
+```
+
+### "python3: command not found"
+
+Install Python 3:
+
+```bash
+# macOS (using Homebrew)
+brew install python3
+
+# Ubuntu/Debian
+sudo apt install python3
+
+# Fedora
+sudo dnf install python3
+
+# Windows (WSL)
+sudo apt install python3
+```
+
+## License
+
+MIT License - See [LICENSE](LICENSE) for details.

package/bin/postinstall.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+
+/**
+ * Post-install script for claude-toggle npm package
+ * Sets up default configuration if not present
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execSync } = require('child_process');
+
+// Skip setup on Windows (package shouldn't install there, but just in case)
+if (process.platform === 'win32') {
+  console.log('claude-toggle: Skipping setup on Windows (not supported)');
+  process.exit(0);
+}
+
+const CONFIG_DIR = path.join(os.homedir(), '.config', 'claude-providers');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'providers.json');
+const DEFAULT_CONFIG = path.join(__dirname, '..', 'providers.json');
+
+// Setup configuration
+if (!fs.existsSync(CONFIG_FILE)) {
+  try {
+    // Create config directory if it doesn't exist
+    if (!fs.existsSync(CONFIG_DIR)) {
+      fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+
+    // Copy default config
+    if (fs.existsSync(DEFAULT_CONFIG)) {
+      fs.copyFileSync(DEFAULT_CONFIG, CONFIG_FILE);
+      console.log(`claude-toggle: Created default config at ${CONFIG_FILE}`);
+    }
+  } catch (err) {
+    // Non-fatal: script will still work with bundled config
+    console.warn(`claude-toggle: Could not create user config: ${err.message}`);
+    console.warn('claude-toggle: Script will use bundled configuration');
+  }
+} else {
+  console.log(`claude-toggle: Using existing config at ${CONFIG_FILE}`);
+}
+
+// Verify dependencies
+let hasWarnings = false;
+
+// Check bash
+try {
+  execSync('which bash', { stdio: 'pipe' });
+} catch {
+  console.warn('claude-toggle: Warning - bash not found in PATH');
+  hasWarnings = true;
+}
+
+// Check python3
+try {
+  execSync('which python3', { stdio: 'pipe' });
+} catch {
+  console.warn('claude-toggle: Warning - python3 not found in PATH');
+  console.warn('claude-toggle: Python 3 is required for JSON parsing');
+  hasWarnings = true;
+}
+
+// Check claude CLI (optional)
+try {
+  execSync('which claude', { stdio: 'pipe' });
+} catch {
+  console.log('claude-toggle: Note - Claude Code CLI not found');
+  console.log('claude-toggle: Install it with: npm install -g @anthropic-ai/claude-code');
+}
+
+if (!hasWarnings) {
+  console.log('claude-toggle: Installation complete!');
+  console.log('claude-toggle: Run "claude-toggle --help" to get started');
+}

package/bin/wrapper.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+
+/**
+ * Node.js wrapper for claude-toggle bash script
+ * Provides cross-platform error handling and spawns the bash script
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// Platform check - Windows is not supported
+if (process.platform === 'win32') {
+  console.error('Error: claude-toggle requires a Unix-like environment (bash, Python 3).');
+  console.error('');
+  console.error('Options for Windows users:');
+  console.error('  1. Use Windows Subsystem for Linux (WSL)');
+  console.error('     https://docs.microsoft.com/en-us/windows/wsl/install');
+  console.error('  2. Use Git Bash with Python 3 installed');
+  console.error('  3. Use a Linux or macOS system');
+  console.error('');
+  console.error('After setting up WSL or Git Bash, install claude-toggle inside that environment.');
+  process.exit(1);
+}
+
+// Locate the bash script relative to this wrapper
+const scriptPath = path.join(__dirname, '..', 'claude-toggle');
+
+// Verify script exists
+if (!fs.existsSync(scriptPath)) {
+  console.error(`Error: claude-toggle script not found at ${scriptPath}`);
+  console.error('This may indicate a corrupted installation. Try reinstalling:');
+  console.error('  npm uninstall -g claude-toggle && npm install -g claude-toggle');
+  process.exit(1);
+}
+
+// Spawn the bash script with all arguments passed through
+const child = spawn('bash', [scriptPath, ...process.argv.slice(2)], {
+  stdio: 'inherit',
+  env: process.env
+});
+
+child.on('error', (err) => {
+  if (err.code === 'ENOENT') {
+    console.error('Error: bash not found.');
+    console.error('');
+    console.error('Please ensure bash is installed and in your PATH.');
+    console.error('On most Unix systems, bash is pre-installed.');
+  } else {
+    console.error(`Error spawning claude-toggle: ${err.message}`);
+  }
+  process.exit(1);
+});
+
+child.on('close', (code) => {
+  process.exit(code || 0);
+});

package/claude-toggle

@@ -0,0 +1,490 @@
+#!/bin/bash
+
+# Claude Code Provider Toggle Script
+# Provider-agnostic architecture for multiple Claude API providers
+# Usage: ./claude-toggle [OPTIONS] [claude options...]
+
+set -e
+
+# =============================================
+# Script Constants
+# =============================================
+SCRIPT_VERSION="1.0.0"
+SCRIPT_NAME="$(basename "$0")"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+CONFIG_SEARCH_PATHS=(
+  "$HOME/.config/claude-providers/providers.json"
+  "$HOME/.claude-providers.json"
+  "$SCRIPT_DIR/providers.json"
+)
+
+# =============================================
+# Global Variables
+# =============================================
+PROVIDER_NAME=""
+CLAUDE_ARGS=()
+ACTION="launch"  # launch, list, validate, help
+VERBOSE=false
+
+# =============================================
+# Usage Information
+# =============================================
+usage() {
+  cat << EOF
+Usage: $SCRIPT_NAME [OPTIONS] [claude options...]
+
+Provider-agnostic toggle script for Claude Code API providers.
+
+OPTIONS:
+  -p, --provider <name>    Select provider (default: default_provider from config)
+  -l, --list-providers     List all available providers
+  -v, --verbose            Enable verbose output
+  -h, --help               Show this help message
+  --validate               Validate provider configuration without launching
+
+EXAMPLES:
+  # Launch with default provider (anthropic)
+  $SCRIPT_NAME
+
+  # Launch with specific provider
+  $SCRIPT_NAME --provider glm
+
+  # List available providers
+  $SCRIPT_NAME --list-providers
+
+  # Pass additional options to claude
+  $SCRIPT_NAME --provider glm --dangerously-skip-permissions
+
+  # Validate provider configuration
+  $SCRIPT_NAME --validate --provider glm
+
+LEGACY OPTIONS:
+  --glm                    Alias for --provider glm (backward compatibility)
+
+EOF
+}
+
+# =============================================
+# Configuration File Management
+# =============================================
+find_config_file() {
+  local config_file=""
+  for path in "${CONFIG_SEARCH_PATHS[@]}"; do
+    if [[ -f "$path" ]]; then
+      config_file="$path"
+      break
+    fi
+  done
+  echo "$config_file"
+}
+
+# =============================================
+# JSON Parsing (using embedded Python)
+# =============================================
+parse_json() {
+  local json_file="$1"
+  local json_path="$2"
+
+  python3 -c "
+import json, sys
+try:
+    with open('$json_file', 'r') as f:
+        data = json.load(f)
+    keys = '$json_path'.split('.')
+    result = data
+    for key in keys:
+        if key.isdigit():
+            result = result[int(key)]
+        else:
+            result = result.get(key)
+    if result is None:
+        sys.exit(1)
+    if isinstance(result, (str, int, float, bool)):
+        print(result)
+    elif isinstance(result, list):
+        print('\n'.join(str(x) for x in result))
+    else:
+        print(json.dumps(result))
+except Exception as e:
+    sys.exit(1)
+" 2>/dev/null
+}
+
+# =============================================
+# Provider Setup Instructions
+# =============================================
+show_setup_instructions() {
+  local missing_var="$1"
+
+  case "$missing_var" in
+    ZAI_API_KEY)
+      cat >&2 << 'EOF'
+
+To set up your ZAI_API_KEY:
+
+1. Get your API key from Z.AI (智谱AI):
+   - Visit: https://open.bigmodel.cn/usercenter/apikeys
+   - Sign in or create an account
+   - Click "Create API Key" to generate a new key
+   - Copy your API key
+
+2. Set the environment variable:
+
+   # For current session only (temporary):
+   export ZAI_API_KEY="your-api-key-here"
+
+   # For permanent setup (recommended):
+   # Add this line to your shell configuration file:
+
+   # For bash (~/.bashrc or ~/.bash_profile):
+   echo 'export ZAI_API_KEY="your-api-key-here"' >> ~/.bashrc
+   source ~/.bashrc
+
+   # For zsh (~/.zshrc):
+   echo 'export ZAI_API_KEY="your-api-key-here"' >> ~/.zshrc
+   source ~/.zshrc
+
+   # For fish (~/.config/fish/config.fish):
+   echo 'set -x ZAI_API_KEY "your-api-key-here"' >> ~/.config/fish/config.fish
+
+3. Verify the key is set:
+   echo $ZAI_API_KEY
+
+EOF
+      ;;
+    OPENAI_API_KEY)
+      cat >&2 << 'EOF'
+
+To set up your OPENAI_API_KEY:
+
+1. Get your API key from OpenAI:
+   - Visit: https://platform.openai.com/api-keys
+   - Sign in to your account
+   - Click "Create new secret key"
+   - Copy your API key (it won't be shown again!)
+
+2. Set the environment variable:
+
+   # For current session only (temporary):
+   export OPENAI_API_KEY="your-api-key-here"
+
+   # For permanent setup (recommended):
+   # Add this line to your shell configuration file:
+
+   # For bash (~/.bashrc or ~/.bash_profile):
+   echo 'export OPENAI_API_KEY="your-api-key-here"' >> ~/.bashrc
+   source ~/.bashrc
+
+   # For zsh (~/.zshrc):
+   echo 'export OPENAI_API_KEY="your-api-key-here"' >> ~/.zshrc
+   source ~/.zshrc
+
+   # For fish (~/.config/fish/config.fish):
+   echo 'set -x OPENAI_API_KEY "your-api-key-here"' >> ~/.config/fish/config.fish
+
+3. Verify the key is set:
+   echo $OPENAI_API_KEY
+
+EOF
+      ;;
+    ANTHROPIC_API_KEY)
+      cat >&2 << 'EOF'
+
+To set up your ANTHROPIC_API_KEY:
+
+1. Get your API key from Anthropic:
+   - Visit: https://console.anthropic.com/settings/keys
+   - Sign in to your account
+   - Click "Create Key"
+   - Copy your API key
+
+2. Set the environment variable:
+
+   # For current session only (temporary):
+   export ANTHROPIC_API_KEY="your-api-key-here"
+
+   # For permanent setup (recommended):
+   # Add this line to your shell configuration file:
+
+   # For bash (~/.bashrc or ~/.bash_profile):
+   echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.bashrc
+   source ~/.bashrc
+
+   # For zsh (~/.zshrc):
+   echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.zshrc
+   source ~/.zshrc
+
+   # For fish (~/.config/fish/config.fish):
+   echo 'set -x ANTHROPIC_API_KEY "your-api-key-here"' >> ~/.config/fish/config.fish
+
+3. Verify the key is set:
+   echo $ANTHROPIC_API_KEY
+
+EOF
+      ;;
+    *)
+      cat >&2 << EOF
+
+To set up your $missing_var:
+
+1. Set the environment variable:
+
+   # For current session only (temporary):
+   export $missing_var="your-value-here"
+
+   # For permanent setup (recommended):
+   # Add this line to your shell configuration file:
+
+   # For bash (~/.bashrc or ~/.bash_profile):
+   echo 'export $missing_var="your-value-here"' >> ~/.bashrc
+   source ~/.bashrc
+
+   # For zsh (~/.zshrc):
+   echo 'export $missing_var="your-value-here"' >> ~/.zshrc
+   source ~/.zshrc
+
+   # For fish (~/.config/fish/config.fish):
+   echo 'set -x $missing_var "your-value-here"' >> ~/.config/fish/config.fish
+
+2. Verify the value is set:
+   echo \$$missing_var
+
+EOF
+      ;;
+  esac
+}
+
+# =============================================
+# Provider Validation
+# =============================================
+validate_provider() {
+  local provider="$1"
+  local config_file="$2"
+
+  # Check if provider exists and is enabled
+  local enabled
+  enabled=$(parse_json "$config_file" "providers.$provider.enabled" 2>/dev/null || echo "false")
+
+  if [[ "$enabled" != "True" && "$enabled" != "true" ]]; then
+    echo "Error: Provider '$provider' not found or disabled" >&2
+    echo "" >&2
+    echo "Available providers:" >&2
+    echo "  Run: $SCRIPT_NAME --list-providers" >&2
+    return 1
+  fi
+
+  # Check required environment variables
+  local required_vars
+  required_vars=$(parse_json "$config_file" "providers.$provider.validation.required_env_vars" 2>/dev/null || echo "")
+
+  if [[ -n "$required_vars" ]]; then
+    local missing_vars=()
+    while IFS= read -r var; do
+      [[ -z "$var" ]] && continue
+      if [[ -z "${!var}" ]]; then
+        missing_vars+=("$var")
+      fi
+    done <<< "$required_vars"
+
+    if [[ ${#missing_vars[@]} -gt 0 ]]; then
+      echo "Error: Missing required credentials for provider '$provider'" >&2
+      echo "" >&2
+      for var in "${missing_vars[@]}"; do
+        echo "  Missing: $var" >&2
+      done
+      echo "" >&2
+      show_setup_instructions "${missing_vars[0]}"
+      return 1
+    fi
+  fi
+
+  return 0
+}
+
+# =============================================
+# List Providers
+# =============================================
+list_providers() {
+  local config_file="$1"
+  local default_provider
+  local json_output
+
+  default_provider=$(parse_json "$config_file" "default_provider" 2>/dev/null || echo "")
+
+  echo "Available providers:"
+  echo "===================="
+
+  # Get provider names using Python
+  json_output=$(parse_json "$config_file" "providers" 2>/dev/null || echo "{}")
+
+  if [[ -z "$json_output" || "$json_output" == "{}" ]]; then
+    echo "No providers found in configuration"
+    return 1
+  fi
+
+  # Parse provider names
+  python3 << PYTHON_SCRIPT
+import json, sys
+try:
+    data = json.loads(open('$config_file').read())
+    providers = data.get('providers', {})
+    default = data.get('default_provider', '')
+
+    for name, config in providers.items():
+        enabled = config.get('enabled', False)
+        if not enabled:
+            continue
+        desc = config.get('description', '')
+        marker = ' * (default)' if name == default else ''
+        print(f"  {name:<20} {desc}{marker}")
+except Exception as e:
+    sys.exit(1)
+PYTHON_SCRIPT
+
+  echo ""
+  echo "* = default provider"
+}
+
+# =============================================
+# Export Provider Environment Variables
+# =============================================
+export_provider_vars() {
+  local provider="$1"
+  local config_file="$2"
+
+  # For anthropic/default, no env vars needed
+  if [[ "$provider" == "anthropic" ]]; then
+    return 0
+  fi
+
+  # Get env_vars as JSON
+  local env_vars_json
+  env_vars_json=$(parse_json "$config_file" "providers.$provider.env_vars" 2>/dev/null || echo "{}")
+
+  if [[ "$env_vars_json" == "{}" || "$env_vars_json" == "null" ]]; then
+    return 0
+  fi
+
+  # Parse and export each variable using Python
+  python3 << PYTHON_SCRIPT
+import json, sys, os
+try:
+    data = json.loads(open('$config_file').read())
+    env_vars = data.get('providers', {}).get('$provider', {}).get('env_vars', {})
+
+    for key, val in env_vars.items():
+        value = val.get('value', '')
+        # Expand \${VAR} references
+        if value.startswith('\${') and value.endswith('}'):
+            env_var = value[2:-1]
+            value = os.environ.get(env_var, '')
+        if value:
+            print(f"export {key}=\"{value}\"")
+except Exception as e:
+    sys.exit(1)
+PYTHON_SCRIPT
+}
+
+# =============================================
+# Main Script Logic
+# =============================================
+main() {
+  # Parse command-line arguments
+  while [[ $# -gt 0 ]]; do
+    case $1 in
+      -p|--provider)
+        PROVIDER_NAME="$2"
+        shift 2
+        ;;
+      -l|--list-providers)
+        ACTION="list"
+        shift
+        ;;
+      -v|--verbose)
+        VERBOSE=true
+        shift
+        ;;
+      -h|--help)
+        ACTION="help"
+        shift
+        ;;
+      --validate)
+        ACTION="validate"
+        shift
+        ;;
+      # Legacy backward compatibility
+      --glm)
+        PROVIDER_NAME="glm"
+        shift
+        ;;
+      # Passthrough to claude
+      *)
+        CLAUDE_ARGS+=("$1")
+        shift
+        ;;
+    esac
+  done
+
+  # Handle help action
+  if [[ "$ACTION" == "help" ]]; then
+    usage
+    exit 0
+  fi
+
+  # Find configuration file
+  local config_file
+  config_file=$(find_config_file)
+
+  # Handle list action
+  if [[ "$ACTION" == "list" ]]; then
+    if [[ -z "$config_file" ]]; then
+      echo "Error: Configuration file not found" >&2
+      echo "Searched paths:" >&2
+      printf "  - %s\n" "${CONFIG_SEARCH_PATHS[@]}" >&2
+      exit 1
+    fi
+    list_providers "$config_file"
+    exit 0
+  fi
+
+  # Validate config file exists for other actions
+  if [[ -z "$config_file" ]]; then
+    echo "Error: Configuration file not found" >&2
+    echo "Searched paths:" >&2
+    printf "  - %s\n" "${CONFIG_SEARCH_PATHS[@]}" >&2
+    echo "" >&2
+    echo "Please create a configuration file or run: $SCRIPT_NAME --help" >&2
+    exit 1
+  fi
+
+  # Determine provider name
+  if [[ -z "$PROVIDER_NAME" ]]; then
+    PROVIDER_NAME=$(parse_json "$config_file" "default_provider" 2>/dev/null || echo "anthropic")
+  fi
+
+  # Validate provider
+  if ! validate_provider "$PROVIDER_NAME" "$config_file"; then
+    exit 1
+  fi
+
+  # Handle validate action
+  if [[ "$ACTION" == "validate" ]]; then
+    echo "Provider '$PROVIDER_NAME' is valid and ready to use"
+    exit 0
+  fi
+
+  # Export provider environment variables
+  if [[ "$VERBOSE" == true ]]; then
+    echo "Using provider: $PROVIDER_NAME" >&2
+  fi
+
+  # Export the environment variables
+  eval "$(export_provider_vars "$PROVIDER_NAME" "$config_file")"
+
+  # Launch claude with passthrough arguments
+  exec claude "${CLAUDE_ARGS[@]}"
+}
+
+# Run main function
+main "$@"

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@sekora_ai/claude-toggle",
+  "version": "1.0.0",
+  "description": "Provider-agnostic toggle for Claude Code API providers",
+  "keywords": [
+    "claude",
+    "anthropic",
+    "api",
+    "provider",
+    "toggle",
+    "cli",
+    "glm",
+    "ai"
+  ],
+  "homepage": "https://github.com/seansekora/claude-toggle",
+  "bugs": {
+    "url": "https://github.com/seansekora/claude-toggle/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/seansekora/claude-toggle.git"
+  },
+  "license": "MIT",
+  "author": "Sean Sekora",
+  "bin": {
+    "claude-toggle": "./bin/wrapper.js"
+  },
+  "files": [
+    "bin/",
+    "claude-toggle",
+    "providers.json",
+    "PROVIDERS.md",
+    "README.md"
+  ],
+  "os": [
+    "darwin",
+    "linux",
+    "!win32"
+  ],
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "scripts": {
+    "postinstall": "node bin/postinstall.js",
+    "test": "bash claude-toggle --help && bash claude-toggle --list-providers"
+  }
+}

package/providers.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "version": "1.0",
+  "default_provider": "anthropic",
+  "providers": {
+    "anthropic": {
+      "description": "Anthropic's official API",
+      "enabled": true,
+      "env_vars": {},
+      "validation": {}
+    },
+    "glm": {
+      "description": "Z.AI GLM models via proxy",
+      "enabled": true,
+      "env_vars": {
+        "ANTHROPIC_AUTH_TOKEN": {
+          "value": "${ZAI_API_KEY}",
+          "required": true
+        },
+        "ANTHROPIC_BASE_URL": {
+          "value": "https://api.z.ai/api/anthropic"
+        },
+        "API_TIMEOUT_MS": {
+          "value": "3000000"
+        },
+        "ANTHROPIC_DEFAULT_HAIKU_MODEL": {
+          "value": "glm-4.5-air"
+        },
+        "ANTHROPIC_DEFAULT_SONNET_MODEL": {
+          "value": "glm-4.7"
+        },
+        "ANTHROPIC_DEFAULT_OPUS_MODEL": {
+          "value": "glm-4.7"
+        }
+      },
+      "validation": {
+        "required_env_vars": ["ZAI_API_KEY"]
+      }
+    }
+  }
+}