ai-account-switch 1.1.0 → 1.3.0

package/INSTALL_WINDOWS.md

@@ -0,0 +1,109 @@
+# Windows Installation Guide
+
+This guide provides detailed instructions for installing AI Account Switch (ais) on Windows.
+
+## Quick Install (Recommended)
+
+### Method 1: One-Line PowerShell Install
+
+Open PowerShell and run:
+
+```powershell
+irm https://github.com/yourusername/ai-agent-user-swith/releases/latest/download/install.ps1 | iex
+```
+
+This will:
+- Download the latest version
+- Install to `%LOCALAPPDATA%\ais` (no admin rights required)
+- Automatically add to your PATH
+- Verify the installation
+
+### Method 2: Download and Run Installer
+
+1. Download `install.ps1` or `install.bat` from the [Releases page](https://github.com/yourusername/ai-agent-user-swith/releases)
+2. Right-click `install.ps1` → "Run with PowerShell"
+   - Or double-click `install.bat`
+
+### System-Wide Installation
+
+If you want to install for all users (requires Administrator):
+
+```powershell
+# Run PowerShell as Administrator
+irm https://github.com/yourusername/ai-agent-user-swith/releases/latest/download/install.ps1 | iex -SystemWide
+```
+
+Or run the downloaded `install.ps1` with the `-SystemWide` parameter:
+
+```powershell
+.\install.ps1 -SystemWide
+```
+
+This installs to `C:\Program Files\ais` instead of the user directory.
+
+## Manual Installation
+
+If you prefer to install manually, see the main [README.md](README.md) for detailed instructions.
+
+## Verify Installation
+
+After installation, open a **new terminal window** and run:
+
+```cmd
+ais --version
+```
+
+You should see the version number displayed.
+
+## Troubleshooting
+
+### Command not found
+
+If `ais` command is not found after installation:
+
+1. Close and reopen your terminal (PATH changes require a new session)
+2. Verify the installation directory is in your PATH:
+   ```cmd
+   echo %PATH%
+   ```
+3. Re-run the installer
+
+### Permission Denied
+
+If you get permission errors:
+
+1. Run PowerShell as Administrator
+2. Or use the user-local installation (default, no admin required)
+
+### Antivirus Blocking
+
+Some antivirus software may flag the executable. This is a false positive. You can:
+
+1. Add an exception in your antivirus software
+2. Download and verify the file manually from GitHub Releases
+3. Install from npm instead: `npm install -g ai-account-switch`
+
+## Uninstallation
+
+To uninstall ais:
+
+1. Remove the installation directory:
+   ```cmd
+   rmdir /s "%LOCALAPPDATA%\ais"
+   ```
+   Or for system-wide installation:
+   ```cmd
+   rmdir /s "C:\Program Files\ais"
+   ```
+
+2. Remove from PATH:
+   - Open "Edit the system environment variables"
+   - Click "Environment Variables"
+   - Find "Path" and remove the ais directory entry
+
+## Alternative Installation Methods
+
+- **npm**: `npm install -g ai-account-switch` (requires Node.js)
+- **From source**: Clone the repository and run `npm link`
+
+See [README.md](README.md) for more details.

package/README.md

@@ -1,5 +1,7 @@
 # AI Account Switch (ais)
 
+English | [简体中文](README_ZH.md)
+
 A cross-platform CLI tool to manage and switch between Claude/Codex account configurations for different projects.
 
 ## Features
@@ -15,28 +17,173 @@ A cross-platform CLI tool to manage and switch between Claude/Codex account conf
 
 ## Installation
 
-### Option 1: Download Pre-built Binary (Recommended)
-
-Download the latest release for your platform from the [Releases page](https://github.com/yourusername/ai-agent-user-swith/releases):
+### Option 1: Global npm Installation (Recommended)
 
-**macOS:**
 ```bash
-# Download and install
-curl -L https://github.com/yourusername/ai-agent-user-swith/releases/latest/download/ais-macos -o /usr/local/bin/ais
-chmod +x /usr/local/bin/ais
+npm install -g ai-account-switch
 ```
 
-**Linux:**
+After installation, the `ais` command will be available globally.
+
+**Note**: If you encounter "command not found" after installation, you may need to add npm's global bin directory to your PATH:
+
 ```bash
-# Download and install
-curl -L https://github.com/yourusername/ai-agent-user-swith/releases/latest/download/ais-linux -o /usr/local/bin/ais
-chmod +x /usr/local/bin/ais
+# Check npm global bin path
+npm config get prefix
+
+# Add to PATH (Linux/macOS)
+export PATH="$PATH:$(npm config get prefix)/bin"
+
+# On Windows, add to system PATH: %APPDATA%\npm
 ```
 
-**Windows:**
-Download `ais-win.exe` from the releases page and add it to your PATH.
+### Option 2: Download Pre-built Binary
+
+Download the latest release for your platform from the [Releases page](https://github.com/yourusername/ai-agent-user-swith/releases):
+
+**Windows (Automatic Installation - Recommended):**
+
+Use the automated installer that downloads the latest version and adds it to PATH automatically:
+
+**Method 1: PowerShell (Recommended)**
+```powershell
+# Run in PowerShell (Administrator recommended for system-wide install)
+irm https://github.com/yourusername/ai-agent-user-swith/releases/latest/download/install.ps1 | iex
+```
+
+**Method 2: Download and Run Installer Script**
+1. Download `install.ps1` or `install.bat` from the [Releases page](https://github.com/yourusername/ai-agent-user-swith/releases)
+2. Right-click on `install.ps1` and select "Run with PowerShell"
+   - Or run `install.bat` by double-clicking it
+
+The installer will:
+- Download the latest `ais-win.exe`
+- Install to `%LOCALAPPDATA%\ais` (user install) or `C:\Program Files\ais` (system install)
+- Automatically add to PATH
+- Verify the installation
+
+After installation, open a **new terminal** and verify:
+```cmd
+ais --version
+```
+
+**Windows (Manual Installation):**
+
+If you prefer manual installation:
+
+1. Download `ais-win.exe` from the [Releases page](https://github.com/yourusername/ai-agent-user-swith/releases)
+
+2. Choose an installation location (recommended: `C:\Program Files\ais\`)
+   ```cmd
+   mkdir "C:\Program Files\ais"
+   ```
+
+3. Move the downloaded file to the installation directory and rename it:
+   ```cmd
+   move "%USERPROFILE%\Downloads\ais-win.exe" "C:\Program Files\ais\ais.exe"
+   ```
+
+4. Add to PATH:
+
+   **Method 1: Using System Settings (Recommended)**
+   - Open Start Menu and search for "Environment Variables"
+   - Click "Edit the system environment variables"
+   - Click "Environment Variables..." button
+   - Under "System variables" (or "User variables" for current user only), find and select "Path"
+   - Click "Edit..."
+   - Click "New"
+   - Add `C:\Program Files\ais`
+   - Click "OK" on all dialogs
+   - **Restart your terminal** for changes to take effect
+
+   **Method 2: Using PowerShell (Administrator)**
+   ```powershell
+   # Add to User PATH
+   [Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Program Files\ais", "User")
+
+   # Or add to System PATH (requires admin)
+   [Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Program Files\ais", "Machine")
+   ```
+
+   **Method 3: Using Command Prompt (Administrator)**
+   ```cmd
+   setx PATH "%PATH%;C:\Program Files\ais"
+   ```
+
+5. Verify installation:
+   ```cmd
+   # Open a NEW terminal window
+   ais --version
+   ```
+
+**Note**: If you prefer a user-local installation without admin rights, use `%LOCALAPPDATA%\ais` instead:
+```cmd
+mkdir "%LOCALAPPDATA%\ais"
+move "%USERPROFILE%\Downloads\ais-win.exe" "%LOCALAPPDATA%\ais\ais.exe"
+# Then add %LOCALAPPDATA%\ais to your User PATH
+```
+
+**macOS:**
+
+1. Download and install to `/usr/local/bin`:
+   ```bash
+   curl -L https://github.com/yourusername/ai-agent-user-swith/releases/latest/download/ais-macos -o /usr/local/bin/ais
+   chmod +x /usr/local/bin/ais
+   ```
+
+2. If you don't have write permissions for `/usr/local/bin`, use sudo:
+   ```bash
+   sudo curl -L https://github.com/yourusername/ai-agent-user-swith/releases/latest/download/ais-macos -o /usr/local/bin/ais
+   sudo chmod +x /usr/local/bin/ais
+   ```
+
+3. Alternatively, install to your user directory (no sudo required):
+   ```bash
+   mkdir -p ~/.local/bin
+   curl -L https://github.com/yourusername/ai-agent-user-swith/releases/latest/download/ais-macos -o ~/.local/bin/ais
+   chmod +x ~/.local/bin/ais
+
+   # Add to PATH if not already there
+   echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
+   source ~/.zshrc
+   ```
+
+4. Verify installation:
+   ```bash
+   ais --version
+   ```
+
+**Linux:**
+
+1. Download and install to `/usr/local/bin`:
+   ```bash
+   curl -L https://github.com/yourusername/ai-agent-user-swith/releases/latest/download/ais-linux -o /usr/local/bin/ais
+   chmod +x /usr/local/bin/ais
+   ```
+
+2. If you don't have write permissions for `/usr/local/bin`, use sudo:
+   ```bash
+   sudo curl -L https://github.com/yourusername/ai-agent-user-swith/releases/latest/download/ais-linux -o /usr/local/bin/ais
+   sudo chmod +x /usr/local/bin/ais
+   ```
+
+3. Alternatively, install to your user directory (no sudo required):
+   ```bash
+   mkdir -p ~/.local/bin
+   curl -L https://github.com/yourusername/ai-agent-user-swith/releases/latest/download/ais-linux -o ~/.local/bin/ais
+   chmod +x ~/.local/bin/ais
 
-### Option 2: Install from Source
+   # Add to PATH if not already there
+   echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
+   source ~/.bashrc
+   ```
+
+4. Verify installation:
+   ```bash
+   ais --version
+   ```
+
+### Option 3: Install from Source
 
 ```bash
 # Clone the repository
@@ -50,15 +197,7 @@ npm install
 npm link
 ```
 
-### Option 3: Global npm Installation
-
-```bash
-npm install -g ai-account-switch
-```
-
-After installation, the `ais` command will be available globally.
-
-**Note**: See [NPM_PUBLISH.md](NPM_PUBLISH.md) for publishing instructions if you're a maintainer.
+**For Maintainers**: See [NPM_PUBLISH.md](NPM_PUBLISH.md) for publishing instructions.
 
 ## Usage
 
@@ -100,6 +239,10 @@ You'll be prompted to enter:
 - Organization ID (optional)
 - Email (optional)
 - Description (optional)
+- Custom environment variables (optional)
+  - Enter in `KEY=VALUE` format (e.g., `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1`)
+  - The tool will display all added variables before completion
+  - Press Enter without input to finish adding variables
 
 #### 2. List All Accounts
 
@@ -202,7 +345,8 @@ When you run `ais use`, the tool automatically creates `.claude/settings.local.j
   "env": {
     "ANTHROPIC_AUTH_TOKEN": "your-api-key",
     "ANTHROPIC_BASE_URL": "your-api-url",
-    "ANTHROPIC_ORGANIZATION_ID": "your-org-id"
+    "ANTHROPIC_ORGANIZATION_ID": "your-org-id",
+    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
   },
   "permissions": {
     "allow": [],
@@ -214,6 +358,33 @@ When you run `ais use`, the tool automatically creates `.claude/settings.local.j
 
 This ensures Claude Code CLI automatically uses the correct account for your project.
 
+#### Custom Environment Variables
+
+You can add custom environment variables when creating an account. When prompted, enter them in `KEY=VALUE` format:
+
+**Input Format:**
+```
+? Environment variable (KEY=VALUE format): CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
+✓ Added: CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
+
+📋 Current environment variables:
+   • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
+
+? Add another environment variable? (y/N)
+```
+
+**Common Examples:**
+- `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` - Disable non-essential network traffic
+- `HTTP_PROXY=http://proxy.example.com:8080` - Set HTTP proxy
+- `HTTPS_PROXY=https://proxy.example.com:8080` - Set HTTPS proxy
+- Any other environment variables needed for your setup
+
+**Features:**
+- One-line input format (`KEY=VALUE`)
+- Real-time display of added variables
+- Press Enter without input to finish
+- Variables are automatically included in `.claude/settings.local.json`
+
 ## Examples
 
 ### Example 1: Setting Up Multiple Accounts
@@ -328,6 +499,40 @@ Make sure you've added at least one account:
 ais add
 ```
 
+### Claude Code uses wrong account
+
+If Claude Code is using a different account than expected:
+
+1. Run diagnostics:
+   ```bash
+   ais doctor
+   ```
+
+2. Check if global Claude config is overriding project config:
+   - If `~/.claude/settings.json` contains `env.ANTHROPIC_AUTH_TOKEN`, it may conflict
+   - **Solution**: Remove the `env` section from global config, or only keep `permissions`
+
+3. Ensure you're starting Claude Code from your project directory or subdirectory
+
+4. Regenerate project config:
+   ```bash
+   ais use <your-account-name>
+   ```
+
+### Project config not found in subdirectory
+
+The tool should work in any subdirectory. If it doesn't:
+
+```bash
+# Make sure you're within a configured project
+cd /path/to/your/project
+ais use <account>
+
+# Then try from subdirectory
+cd src/
+ais current  # Should show your account
+```
+
 ## Contributing
 
 Contributions are welcome! Feel free to:
@@ -341,6 +546,22 @@ MIT License - feel free to use this tool in your projects!
 
 ## Changelog
 
+### v1.3.0
+- **Improved custom environment variables input**:
+  - One-line `KEY=VALUE` format input (e.g., `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1`)
+  - Real-time display of added variables during configuration
+  - Press Enter without input to finish adding variables
+  - Better error messages and user guidance
+- Enhanced documentation with detailed examples and usage instructions
+
+### v1.2.0
+- Added custom environment variables support for accounts
+- Added `ais doctor` command for configuration diagnostics
+- Enhanced `ais help` with all new features
+- Updated installation documentation (npm as recommended method)
+- Improved PATH configuration instructions
+- Display custom env variables in `ais list` and `ais info`
+
 ### v1.1.0
 - Added smart directory detection (works in any subdirectory)
 - Automatic Claude Code `.claude/settings.local.json` generation