ccman 0.0.1

package/release-temp/README.md

@@ -0,0 +1,361 @@
+# CCM - Claude Code Manager
+
+A TypeScript-based command-line tool to manage Claude Code API configurations with **safe shell integration** through independent configuration files.
+
+> **English Documentation** | [中文文档](./README_zh.md)
+
+## ✨ Features
+
+✅ **Environment Group Management** - Add, remove, switch between Claude Code environments  
+✅ **Safe Shell Integration** - Uses independent `~/.ccman/.ccmanrc` file to avoid modifying user configs  
+✅ **Interactive Source Control** - Choose manual or automatic source with risk warnings  
+✅ **Type Safety** - Full TypeScript implementation with strict typing  
+✅ **Interactive CLI** - User-friendly commands with colored output and inquirer prompts  
+✅ **Multi-Shell Support** - Works with bash, zsh, and fish  
+✅ **Complete Workflow** - From setup to usage in one seamless flow  
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+# Install from NPM
+npm install -g ccman
+
+# Or install dependencies for development
+npm install && npm run build
+```
+
+### Basic Usage
+
+```bash
+# Interactive setup (recommended)
+ccman config
+
+# Or add environment directly
+ccman add default https://api.anthropic.com your-api-key
+
+# List all environments
+ccman ls
+
+# Switch to an environment with source options
+ccman use default
+
+# Show current environment
+ccman current
+```
+
+## 📖 Commands Reference
+
+### Core Environment Management
+```bash
+ccman add <name> <baseUrl> [apiKey]     # Add environment (interactive API key if not provided)
+ccman remove <name>                     # Remove environment group
+ccman use <name>                        # Switch environment with source interaction
+ccman list|ls                           # List all environments (* = current)
+ccman current                           # Show current environment details
+ccman clear|clearall                    # Clear ALL environments and shell integration (DESTRUCTIVE)
+```
+
+### Interactive Configuration
+```bash
+ccman config                            # Full interactive configuration wizard
+                                     # - Add/switch/edit/remove environments
+                                     # - No existing environments? Guided setup
+                                     # - Complete menu-driven interface
+```
+
+### Advanced Operations
+```bash
+ccman status                            # Show detailed CCM statistics
+ccman test [name]                       # Test environment configuration
+ccman env                               # Generate shell export script
+```
+
+### Shell Integration Options
+```bash
+# Disable automatic shell writing
+ccman add <name> <url> --no-auto-write  
+ccman use <name> --no-auto-write        
+
+# Force automatic source (risky)
+ccman use <name> --auto-source          
+```
+
+## 🔧 Interactive Workflows
+
+### 1. Adding Environment with Smart Use Flow
+
+```bash
+$ ccman add myenv https://api.example.com
+? Enter API Key: ****************
+✓ Added environment group "myenv"
+  Base URL: https://api.example.com
+  Created: 2025-08-06 11:45:30
+
+? Set "myenv" as current environment? Yes
+✓ Environment variables written to /home/user/.ccman/.ccmanrc
+
+? How would you like to apply the environment variables?
+❯ Manual - I will restart terminal or source manually (Recommended)
+  Auto-source - Try to source automatically (May not work in all environments)
+
+> Manual
+To apply changes, restart your terminal or run:
+source ~/.bashrc (or ~/.zshrc)
+```
+
+### 2. Interactive Configuration Menu
+
+```bash
+$ ccman config
+? What would you like to do?
+❯ Switch environment
+  Add new environment  
+  Edit environment
+  Remove environment
+  Show current status
+
+> Add new environment
+? Environment name: staging
+? Base URL: https://staging-api.example.com
+? API Key: ****************
+✓ Added environment "staging"
+```
+
+### 3. Environment Switching with Source Control
+
+```bash
+$ ccman use production  
+✓ Switched to environment "production"
+  Base URL: https://api.anthropic.com
+✓ Environment variables written to /home/user/.ccman/.ccmanrc
+
+? How would you like to apply the environment variables?
+  Manual - I will restart terminal or source manually (Recommended)
+❯ Auto-source - Try to source automatically (May not work in all environments)
+
+> Auto-source
+⚠️  Attempting auto-source - this may not work in all terminal environments
+✓ Shell configuration sourced successfully
+```
+
+## 🛡️ Safe Shell Integration Architecture
+
+### How It Works
+
+CCM uses a **two-tier architecture** for safe shell integration:
+
+1. **Independent Configuration File**: `~/.ccman/.ccmanrc`
+   ```bash
+   # CCM (Claude Code Manager) Environment Variables - Auto Generated
+   # Generated at: 2025-08-06 11:45:30
+   # Environment: production
+   export ANTHROPIC_BASE_URL="https://api.anthropic.com"
+   export ANTHROPIC_AUTH_TOKEN="your-api-key"
+   # End CCM Environment Variables
+   ```
+
+2. **Minimal Shell Reference**: One line added to `.bashrc`/`.zshrc`
+   ```bash
+   # CCM (Claude Code Manager) - Auto Generated Reference
+   [ -f "/home/user/.ccman/.ccmanrc" ] && source "/home/user/.ccman/.ccmanrc"
+   # End CCM Reference
+   ```
+
+### Benefits
+- ✅ **Non-invasive**: Only adds one reference line to shell config
+- ✅ **Safe**: User's existing shell config remains untouched
+- ✅ **Clean**: Easy to remove completely
+- ✅ **Isolated**: All CCM variables in separate file
+
+### Environment Variables Managed
+- `ANTHROPIC_BASE_URL` - API base URL
+- `ANTHROPIC_AUTH_TOKEN` - API authentication token
+
+## 📊 Configuration Structure
+
+CCM stores configuration in `~/.ccman/config.json`:
+
+```json
+{
+  "current": "production",
+  "environments": {
+    "production": {
+      "name": "production",
+      "baseUrl": "https://api.anthropic.com",
+      "apiKey": "your-key",
+      "createdAt": "2025-08-06T03:45:30.000Z",
+      "lastUsed": "2025-08-06T03:50:15.000Z"
+    },
+    "staging": {
+      "name": "staging", 
+      "baseUrl": "https://staging-api.example.com",
+      "apiKey": "staging-key",
+      "createdAt": "2025-08-06T03:46:00.000Z"
+    }
+  },
+  "settings": {
+    "autoWriteShell": true,
+    "preferredShell": "auto",
+    "shellConfigPath": null
+  }
+}
+```
+
+## 💡 Usage Examples
+
+### Complete Setup Workflow
+```bash
+# Start with interactive setup
+ccman config
+# → Guided through adding first environment
+# → Automatically prompted to set as current
+# → Choose source method (manual/auto)
+
+# Add more environments
+ccman add staging https://staging.example.com
+ccman add dev https://dev.example.com
+
+# Switch with full interaction
+ccman use dev
+# → Writes to ~/.ccman/.ccmanrc
+# → Asks about sourcing method
+# → Provides clear instructions
+
+# Check status
+ccman status
+# CCM Status:
+# Total environments: 3
+# Current environment: dev
+# Shell integration: Enabled
+```
+
+### Manual Environment Variable Setup
+```bash
+# If you prefer manual control
+ccman use prod --no-auto-write
+ccman env  # Shows export script
+source <(ccman env)  # Apply manually
+```
+
+### Advanced Usage
+```bash
+# Test environment connectivity
+ccman test production
+
+# Force auto-source (with risk warning)
+ccman use staging --auto-source
+
+# Edit existing environment
+ccman config  # → Edit environment → Select → Update values
+
+# Complete reset (removes EVERYTHING - environments, shell config)
+ccman clear   # Interactive confirmation required
+```
+
+## ⚙️ Development
+
+```bash
+# Development mode (with file watching)
+npm run dev
+
+# Build TypeScript
+npm run build
+
+# Clean build artifacts  
+npm run clean
+
+# Start built CLI
+npm start
+```
+
+## 🎯 Command Line Options
+
+### Global Options
+All commands support standard CLI conventions:
+- `-h, --help` - Show command help
+- `-V, --version` - Show version
+
+### Add Command Options
+```bash
+ccman add <name> <baseUrl> [apiKey] [options]
+
+Options:
+  --no-auto-write    Do not automatically write to shell config
+```
+
+### Use Command Options  
+```bash
+ccman use <name> [options]
+
+Options:
+  --no-auto-write    Do not automatically write to shell config
+  --auto-source      Automatically source shell config (risky)
+```
+
+## 🔍 Troubleshooting
+
+### Environment Variables Not Applied
+```bash
+# Check if .ccmanrc exists
+ls -la ~/.ccman/.ccmanrc
+
+# Check shell reference
+grep "ccman" ~/.bashrc ~/.zshrc
+
+# Manual application
+source ~/.ccman/.ccmanrc
+
+# Or regenerate
+ccman use <current-env>
+```
+
+### Shell Integration Issues
+```bash
+# Check shell type detection
+ccman status
+
+# Force manual setup
+ccman use <env> --no-auto-write
+source <(ccman env)
+```
+
+## 📋 Requirements
+
+- Node.js >= 16.0.0  
+- TypeScript 5.0+
+- Supported shells: bash, zsh, fish
+- Operating systems: Linux, macOS, Windows (WSL)
+
+## 📄 License
+
+MIT License - see LICENSE file for details.
+
+---
+
+## 🚀 From Setup to Usage - Complete Flow
+
+```bash
+# 1. Interactive first-time setup
+ccman config
+  → No environments? Guided creation
+  → Set as current? Yes
+  → Source method? Manual/Auto
+
+# 2. Add more environments  
+ccman add dev https://dev.api.com
+  → Interactive API key input
+  → Set as current? Yes/No
+  → Full source interaction if Yes
+
+# 3. Switch anytime with full control
+ccman use production
+  → Safe .ccmanrc update
+  → Source method choice
+  → Clear instructions
+
+# 4. Everything just works! ✨
+```
+
+*CCM - Making Claude Code API configuration management safe, interactive, and user-friendly.*

package/release-temp/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "ccman",
+  "version": "0.0.1",
+  "description": "Claude Code Manager - A TypeScript tool to manage Claude Code API configurations",
+  "main": "dist/index.js",
+  "packageManager": "pnpm@8.15.1",
+  "bin": {
+    "ccman": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "start": "node dist/cli.js",
+    "test": "jest --passWithNoTests",
+    "lint": "eslint src/**/*.ts",
+    "clean": "rm -rf dist",
+    "release": "./scripts/release.sh",
+    "release:patch": "./scripts/quick-release.sh patch",
+    "release:minor": "./scripts/quick-release.sh minor",
+    "release:major": "./scripts/quick-release.sh major",
+    "release:interactive": "./scripts/quick-release.sh",
+    "publish:local": "./scripts/publish-local.sh",
+    "prepublishOnly": "pnpm run clean && pnpm run build && pnpm run lint"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "api",
+    "config",
+    "manager",
+    "cli",
+    "typescript"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^11.0.0",
+    "chalk": "^4.1.2",
+    "inquirer": "^8.2.6"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/inquirer": "^9.0.0",
+    "typescript": "^5.0.0",
+    "tsx": "^4.0.0",
+    "eslint": "^8.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "jest": "^29.0.0",
+    "@types/jest": "^29.0.0",
+    "ts-jest": "^29.0.0",
+    "prettier": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}

package/scripts/publish-local.sh

@@ -0,0 +1,91 @@
+#!/bin/bash
+
+# Local NPM Publish Script
+# 本地 NPM 发布脚本（备用方案）
+
+set -e
+
+# 颜色定义
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+print_success() { echo -e "${GREEN}✅ $1${NC}"; }
+print_warning() { echo -e "${YELLOW}⚠️  $1${NC}"; }
+print_error() { echo -e "${RED}❌ $1${NC}"; exit 1; }
+print_info() { echo -e "${BLUE}ℹ️  $1${NC}"; }
+
+echo "🚀 CCM 本地 NPM 发布脚本"
+echo "==============================="
+echo ""
+
+# 检查前置条件
+[ ! -f "package.json" ] && print_error "package.json 未找到"
+[ ! -d "dist" ] && print_error "dist 目录不存在，请先运行 npm run build"
+
+# 检查 NPM 登录状态
+print_info "检查 NPM 登录状态..."
+if ! npm whoami > /dev/null 2>&1; then
+    print_warning "未登录 NPM，开始登录流程..."
+    npm login
+    print_success "NPM 登录成功"
+else
+    current_user=$(npm whoami)
+    print_success "已登录 NPM，用户: $current_user"
+fi
+
+# 获取版本信息
+current_version=$(node -p "require('./package.json').version")
+package_name=$(node -p "require('./package.json').name")
+
+print_info "包名: $package_name"
+print_info "当前版本: $current_version"
+
+# 检查版本是否已存在
+print_info "检查版本是否已存在..."
+if npm view $package_name@$current_version > /dev/null 2>&1; then
+    print_error "版本 $current_version 已存在于 NPM 上"
+fi
+
+print_success "版本检查通过"
+
+# 运行预发布检查
+print_info "运行预发布检查..."
+pnpm run lint
+pnpm run build
+
+print_success "预发布检查通过"
+
+# 确认发布
+echo ""
+print_warning "即将发布到 NPM:"
+echo "  包名: $package_name"
+echo "  版本: $current_version"
+echo "  用户: $(npm whoami)"
+echo ""
+
+read -p "确认发布？ (y/N): " -n 1 -r
+echo
+[[ ! $REPLY =~ ^[Yy]$ ]] && { echo "取消发布"; exit 0; }
+
+# 执行发布
+print_info "开始发布..."
+
+# 检查是否为预发布版本
+if [[ $current_version =~ -beta\.|alpha\.|rc\. ]]; then
+    print_info "检测到预发布版本，使用 beta tag"
+    npm publish --tag beta --access public
+else
+    print_info "发布稳定版本"
+    npm publish --access public
+fi
+
+print_success "发布成功！"
+echo ""
+print_info "📦 NPM 包信息:"
+echo "  URL: https://www.npmjs.com/package/$package_name/v/$current_version"
+echo "  安装: npm install -g $package_name@$current_version"
+echo ""
+print_success "本地发布完成！"

package/scripts/quick-release.sh

@@ -0,0 +1,100 @@
+#!/bin/bash
+
+# CCM Quick Release Script
+# 快速发布补丁版本的简化脚本
+
+set -e
+
+# 颜色定义
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+print_success() { echo -e "${GREEN}✅ $1${NC}"; }
+print_warning() { echo -e "${YELLOW}⚠️  $1${NC}"; }
+print_error() { echo -e "${RED}❌ $1${NC}"; exit 1; }
+print_info() { echo -e "${BLUE}ℹ️  $1${NC}"; }
+
+# 快速检查
+[ ! -f "package.json" ] && print_error "package.json 未找到"
+[ ! -d ".git" ] && print_error "不在 Git 仓库中"
+git diff-index --quiet HEAD -- || print_error "工作目录有未提交更改"
+
+# 获取当前版本和升级类型
+current_version=$(node -p "require('./package.json').version")
+version_type=${1:-""}
+
+echo "🚀 CCM 快速发布"
+echo "当前版本: $current_version"
+
+# 如果没有提供版本类型，让用户选择
+if [ -z "$version_type" ]; then
+    echo ""
+    print_info "选择版本类型:"
+    echo "1) patch (修订版本): $current_version → $(pnpm version patch --dry-run 2>/dev/null | cut -d'v' -f2 || echo '计算中...')"
+    echo "2) minor (次版本): $current_version → $(pnpm version minor --dry-run 2>/dev/null | cut -d'v' -f2 || echo '计算中...')"
+    echo "3) major (主版本): $current_version → $(pnpm version major --dry-run 2>/dev/null | cut -d'v' -f2 || echo '计算中...')"
+    echo ""
+    
+    read -p "请选择 (1-3, 回车默认选择 patch): " choice
+    
+    case ${choice:-1} in
+        1|"") version_type="patch" ;;
+        2) version_type="minor" ;;
+        3) version_type="major" ;;
+        *) print_error "无效选择" ;;
+    esac
+fi
+
+print_info "升级类型: $version_type"
+
+# 确认发布
+echo ""
+read -p "确认发布？ (y/N): " -n 1 -r
+echo
+[[ ! $REPLY =~ ^[Yy]$ ]] && { print_warning "取消发布"; exit 0; }
+
+# 执行发布流程
+print_success "开始发布流程..."
+
+# 1. 构建和测试
+print_info "运行构建和代码检查..."
+pnpm run build
+pnpm run lint
+
+# 2. 更新版本
+print_info "更新版本号..."
+new_version=$(pnpm version $version_type --no-git-tag-version)
+new_version=${new_version#v}
+
+print_success "版本已更新: $current_version → $new_version"
+
+# 3. 提交和打标签
+print_info "创建提交和标签..."
+git add .
+git commit -m "chore: 发布版本 v$new_version
+
+🚀 快速发布 $version_type 版本
+⏰ $(date '+%Y-%m-%d %H:%M:%S')
+
+🤖 Generated with [Claude Code](https://claude.ai/code)
+
+Co-Authored-By: Claude <noreply@anthropic.com>"
+
+git tag -a "v$new_version" -m "Release v$new_version"
+
+# 4. 推送
+print_info "推送到远程仓库..."
+git push origin $(git branch --show-current)
+git push origin "v$new_version"
+
+print_success "发布完成！版本 v$new_version 已推送"
+echo ""
+print_info "🔗 相关链接:"
+echo "   GitHub Actions: https://github.com/2ue/ccm/actions"
+echo "   GitHub Release: https://github.com/2ue/ccm/releases/tag/v$new_version"
+echo ""
+print_info "📦 NPM 包将在 GitHub Actions 完成后发布:"
+echo "   https://www.npmjs.com/package/ccm"