ccman 0.0.1

package/.editorconfig

@@ -0,0 +1,15 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[{package.json,*.yml,*.yaml}]
+indent_size = 2

package/.eslintrc.js

@@ -0,0 +1,28 @@
+module.exports = {
+  root: true,
+  parser: '@typescript-eslint/parser',
+  plugins: ['@typescript-eslint'],
+  extends: [
+    'eslint:recommended'
+  ],
+  parserOptions: {
+    ecmaVersion: 2020,
+    sourceType: 'module'
+  },
+  env: {
+    node: true,
+    es2020: true,
+  },
+  rules: {
+    // 基本规则
+    'no-unused-vars': 'off',
+    '@typescript-eslint/no-unused-vars': 'error',
+    'no-console': 'off', // CLI工具需要console输出
+    'no-process-exit': 'off', // CLI工具需要process.exit
+  },
+  ignorePatterns: [
+    'dist/',
+    'node_modules/',
+    '*.js', // 忽略根目录的JS配置文件
+  ],
+};

package/.github/workflows/release.yml

@@ -0,0 +1,213 @@
+name: Release and Publish
+
+# 触发条件：推送 tag 或手动触发
+on:
+  push:
+    tags:
+      - 'v*.*.*'  # 匹配语义化版本标签 (v1.0.0, v1.2.3, etc.)
+  workflow_dispatch:  # 支持手动触发
+    inputs:
+      version:
+        description: 'Release version (e.g., 1.0.0)'
+        required: true
+        default: 'patch'
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
+
+jobs:
+  release:
+    name: Release and Publish to NPM
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write  # 需要写入权限来创建 release
+      id-token: write  # NPM 发布需要
+
+    steps:
+      # 1. 检出代码
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # 获取完整历史记录用于生成 changelog
+
+      # 2. 设置 pnpm
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 8.15.1  # 固定版本保证稳定性
+
+      # 3. 设置 Node.js 和缓存
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'pnpm'
+
+      # 4. 安装依赖
+      - name: Install dependencies
+        run: pnpm install
+
+      # 5. 运行测试和代码检查
+      - name: Run tests and linting
+        run: |
+          pnpm run lint
+          pnpm run build
+        continue-on-error: false
+
+      # 6. 获取版本信息
+      - name: Get version info
+        id: version
+        run: |
+          if [ "${{ github.event_name }}" == "push" ]; then
+            # 从 tag 中提取版本
+            VERSION=${GITHUB_REF#refs/tags/v}
+            echo "version=$VERSION" >> $GITHUB_OUTPUT
+            echo "tag=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT
+          else
+            # 手动触发时使用输入的版本
+            VERSION=$(npm version ${{ github.event.inputs.version }} --no-git-tag-version --preid=beta)
+            VERSION=${VERSION#v}
+            echo "version=$VERSION" >> $GITHUB_OUTPUT
+            echo "tag=v$VERSION" >> $GITHUB_OUTPUT
+          fi
+          echo "package_version=$(node -p "require('./package.json').version")" >> $GITHUB_OUTPUT
+
+      # 7. 验证版本一致性（仅对 tag 触发的构建）
+      - name: Validate version consistency
+        if: github.event_name == 'push'
+        run: |
+          PACKAGE_VERSION=$(node -p "require('./package.json').version")
+          TAG_VERSION="${{ steps.version.outputs.version }}"
+          if [ "$PACKAGE_VERSION" != "$TAG_VERSION" ]; then
+            echo "❌ Version mismatch: package.json($PACKAGE_VERSION) != tag($TAG_VERSION)"
+            exit 1
+          fi
+          echo "✅ Version validation passed: $PACKAGE_VERSION"
+
+      # 8. 生成构建产物
+      - name: Build project
+        run: |
+          pnpm run clean
+          pnpm run build
+
+      # 9. 创建发布包
+      - name: Create release archive
+        run: |
+          # 创建临时目录用于打包
+          mkdir -p release-temp
+
+          # 复制必要文件到临时目录
+          cp -r dist release-temp/
+          cp package.json release-temp/
+          cp README.md release-temp/
+          cp LICENSE release-temp/ 2>/dev/null || echo "No LICENSE file found"
+
+          # 创建压缩包
+          cd release-temp
+          tar -czf ../ccm-v${{ steps.version.outputs.version }}.tar.gz .
+          cd ..
+
+          echo "✅ Release archive created: ccm-v${{ steps.version.outputs.version }}.tar.gz"
+
+      # 10. 配置 NPM 认证
+      - name: Configure NPM authentication
+        run: |
+          echo "//registry.npmjs.org/:_authToken=${{ secrets.NPM_TOKEN }}" >> ~/.npmrc
+          ls -la ~/
+          echo "NPM configuration:"
+          cat ~/.npmrc
+
+      # 11. 验证 NPM 认证
+      - name: Verify NPM authentication
+        run: |
+          npm whoami
+          echo "✅ NPM authentication verified"
+
+      # 12. 发布到 NPM（使用 npm 确保兼容性）
+      - name: Publish to NPM
+        run: |
+          echo "Publishing to NPM..."
+
+          # 检查是否为预发布版本
+          VERSION="${{ steps.version.outputs.version }}"
+          if [[ "$VERSION" =~ -beta\.|alpha\.|rc\. ]]; then
+            echo "📦 Publishing pre-release version $VERSION with 'beta' tag"
+            npm publish --tag beta --access public
+          else
+            echo "📦 Publishing stable version $VERSION"
+            npm publish --access public
+          fi
+
+          echo "✅ Published to NPM successfully"
+
+      # 13. 创建 GitHub Release
+      - name: Create GitHub Release
+        uses: actions/create-release@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          tag_name: ${{ steps.version.outputs.tag }}
+          release_name: "CCM v${{ steps.version.outputs.version }}"
+          body: |
+            ## CCM (Claude Code Manager) v${{ steps.version.outputs.version }}
+
+            🚀 **新版本发布！**
+
+            ### 📦 安装方式
+            ```bash
+            npm install -g ccm@${{ steps.version.outputs.version }}
+            ```
+
+            ### 🔗 相关链接
+            - [NPM 包](https://www.npmjs.com/package/ccm)
+            - [GitHub 仓库](https://github.com/2ue/ccm)
+            - [中文文档](./README_zh.md)
+
+            ### 📋 发布信息
+            - **发布时间**: ${{ github.event.head_commit.timestamp }}
+            - **提交哈希**: ${{ github.sha }}
+            - **构建环境**: GitHub Actions (ubuntu-latest)
+
+            ---
+
+            *该版本通过 GitHub Actions 自动构建和发布*
+          draft: false
+          prerelease: ${{ contains(steps.version.outputs.version, 'beta') || contains(steps.version.outputs.version, 'alpha') || contains(steps.version.outputs.version, 'rc') }}
+
+      # 14. 上传发布文件到 Release
+      - name: Upload release assets
+        uses: actions/upload-release-asset@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          upload_url: ${{ steps.create_release.outputs.upload_url }}
+          asset_path: ./ccm-v${{ steps.version.outputs.version }}.tar.gz
+          asset_name: ccm-v${{ steps.version.outputs.version }}.tar.gz
+          asset_content_type: application/gzip
+
+      # 15. 发布结果通知
+      - name: Release Summary
+        run: |
+          echo "## 🎉 发布成功 v${{ steps.version.outputs.version }}" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "### 📋 发布详情" >> $GITHUB_STEP_SUMMARY
+          echo "- **版本**: ${{ steps.version.outputs.version }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **NPM**: https://www.npmjs.com/package/ccm/v/${{ steps.version.outputs.version }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **GitHub Release**: ${{ github.server_url }}/${{ github.repository }}/releases/tag/${{ steps.version.outputs.tag }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **安装命令**: \`npm install -g ccm@${{ steps.version.outputs.version }}\`" >> $GITHUB_STEP_SUMMARY
+
+  # 可选：部署文档或通知其他系统
+  post-release:
+    name: Post-release tasks
+    needs: release
+    runs-on: ubuntu-latest
+    if: always()
+
+    steps:
+      - name: Post-release cleanup
+        run: |
+          echo "✅ Release workflow completed"
+          echo "Version ${{ needs.release.outputs.version }} has been published"

package/.prettierrc

@@ -0,0 +1,10 @@
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 80,
+  "tabWidth": 2,
+  "useTabs": false,
+  "endOfLine": "lf",
+  "arrowParens": "avoid"
+}

package/CLAUDE.md

@@ -0,0 +1,215 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+CCM (Claude Code Manager) is a TypeScript-based command-line tool for managing Claude Code API configurations. It provides structured, modular environment management with **safe shell integration** through independent configuration files.
+
+## Architecture
+
+### Core Modules
+- **src/types/index.ts**: TypeScript type definitions for all interfaces
+- **src/config/ConfigManager.ts**: Core configuration management with JSON storage
+- **src/config/EnvironmentManager.ts**: High-level environment group operations
+- **src/shell/ShellManager.ts**: Safe shell configuration file management using ..ccmanrc approach
+- **src/cli.ts**: Command-line interface with Commander.js and unified interaction logic
+
+### Project Structure
+```
+src/
+├── types/           # TypeScript type definitions
+├── config/          # Configuration management modules  
+├── shell/           # Shell integration modules
+├── utils/           # Utility functions (future)
+├── cli.ts           # CLI entry point with performUseEnvironment() shared function
+└── index.ts         # Module exports
+```
+
+## Key Features Implemented
+
+### 1. Safe Shell Integration Architecture
+- **Independent .ccmanrc file**: `~/.ccman/.ccmanrc` contains all environment variables
+- **Minimal shell reference**: Single line added to `.bashrc`/`.zshrc` to source .ccmanrc
+- **Non-invasive approach**: User's shell config remains largely untouched
+- **Easy cleanup**: Remove reference line and delete .ccmanrc file
+
+### 2. Interactive Source Control
+- After environment switching, user chooses source method:
+  - **Manual**: User manually sources or restarts terminal (recommended)
+  - **Auto-source**: Tool attempts automatic sourcing with risk warnings
+
+### 3. Unified Use Logic
+- `performUseEnvironment()` function provides consistent behavior across:
+  - `add` command's "set as current" flow
+  - Standalone `use` command
+  - `config` command's switch environment option
+
+### 4. Complete Interactive Workflows
+- **config command**: Full menu-driven interface for all operations
+- **add command**: Interactive API key input + use confirmation + source choice
+- **Consistent interactions**: All use operations have identical user experience
+
+## Current Environment Variables
+
+The tool manages these Claude Code environment variables:
+- `ANTHROPIC_BASE_URL`: API base URL
+- `ANTHROPIC_AUTH_TOKEN`: API authentication token
+
+*Note: Updated from previous CLAUDE_API_BASE_URL and ANTHROPIC_API_KEY*
+
+## Common Commands
+
+### Development
+```bash
+npm run build         # Compile TypeScript to dist/
+npm run dev           # Run CLI in development mode with tsx
+npm start             # Run compiled CLI
+npm run clean         # Remove dist/ directory
+npm run lint          # Run ESLint on TypeScript files (requires config)
+```
+
+### Basic Usage
+```bash
+ccman ls                # List all environment groups (* = current)
+ccman add <name> <url>  # Add environment group with interactive flow
+ccman use <name>        # Switch environment with source interaction
+ccman remove <name>     # Delete environment group
+ccman current           # Show current environment
+ccman status            # Show CCM statistics
+ccman config            # Interactive configuration menu
+ccman clear             # Clear all environments and shell integration (DESTRUCTIVE)
+```
+
+### Advanced Features
+```bash
+ccman env               # Generate shell script for manual sourcing
+ccman test [name]       # Test environment configuration
+ccman add <name> <url> --no-auto-write    # Add without shell integration
+ccman use <name> --no-auto-write          # Switch without shell integration
+ccman use <name> --auto-source            # Force auto-source with risk warning
+```
+
+## Implementation Details
+
+### 1. Environment Group Management
+- Add/remove/switch between environment groups
+- Each group contains: name, baseUrl, apiKey, timestamps
+- Automatic validation of URLs and required fields
+- Interactive API key input if not provided
+
+### 2. Shell Integration Process
+1. **Write .ccmanrc**: Environment variables written to `~/.ccman/.ccmanrc`
+2. **Add reference**: Shell config updated to source .ccmanrc if not already present
+3. **User choice**: Interactive prompt for sourcing method
+4. **Auto-source**: Optional automatic sourcing with error handling
+
+### 3. Type Safety Implementation
+- Full TypeScript implementation with strict typing
+- Interfaces for all data structures and operations:
+  - `ClaudeEnv`: Environment configuration
+  - `ShellEnvVars`: Environment variables with correct naming
+  - `AddEnvOptions`: Add operation parameters
+  - `ShellWriteResult`: Shell operation results
+- Compile-time error checking
+
+### 4. Interactive CLI Features
+- Inquirer.js for consistent prompts
+- Colored output with chalk
+- Confirmation prompts for destructive operations
+- Menu-driven configuration interface
+- Progress feedback and error handling
+
+## Configuration Storage
+
+- Config directory: `~/.ccman/`
+- Main config: `~/.ccman/config.json`
+- Environment variables: `~/.ccman/.ccmanrc`
+- Structure includes environments, current selection, and global settings
+
+## Shell Integration Technical Details
+
+### File Locations
+- **Configuration**: `~/.ccman/.ccmanrc` - Contains current environment variables
+- **Shell reference**: Added to `.bashrc`, `.zshrc`, or `config.fish`
+- **Detection order**: zsh → bash → fish → fallback
+
+### Shell Reference Format
+```bash
+# CCM (Claude Code Manager) - Auto Generated Reference
+# This line sources CCM environment variables from /home/user/.ccman/.ccmanrc
+[ -f "/home/user/.ccman/.ccmanrc" ] && source "/home/user/.ccman/.ccmanrc"
+# End CCM Reference
+```
+
+### .ccmanrc File Format
+```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
+```
+
+## Build Process
+
+1. TypeScript compilation targets ES2020 with CommonJS modules
+2. Output goes to `dist/` directory with source maps
+3. CLI entry point is `dist/cli.js` with proper shebang
+4. Supports both development (`tsx`) and production (`node`) execution
+
+## Code Organization
+
+### CLI Structure (`src/cli.ts`)
+- **performUseEnvironment()**: Shared function for consistent use behavior across commands
+- **Command definitions**: Using Commander.js with proper option handling
+- **Interactive prompts**: Inquirer.js integration for user input
+- **Error handling**: Consistent error reporting and process exit codes
+
+### Shell Manager (`src/shell/ShellManager.ts`)
+- **.ccmanrc management**: Independent file creation and updates
+- **Shell reference management**: Minimal invasive approach
+- **Auto-source capability**: Subprocess execution with error handling
+- **Multi-shell support**: bash, zsh, fish detection and handling
+
+### Environment Manager (`src/config/EnvironmentManager.ts`)
+- **High-level operations**: Add, remove, update, switch environments
+- **Shell integration coordination**: Works with ShellManager for safe updates
+- **Validation**: URL validation, environment name checking
+- **Statistics**: Usage tracking and reporting
+
+## Recent Major Changes
+
+1. **Shell Architecture Redesign**: From direct modification to .ccmanrc + reference approach
+2. **Environment Variable Renaming**: Updated to ANTHROPIC_BASE_URL and ANTHROPIC_AUTH_TOKEN
+3. **Interactive Source Control**: Added user choice for manual vs automatic sourcing
+4. **Unified Use Logic**: Single function for consistent behavior across all use scenarios
+5. **Time Format Improvement**: Human-readable timestamps instead of ISO format
+6. **Enhanced config Command**: Complete menu-driven interface for all operations
+7. **Clear All Functionality**: Added clearAll command for complete CCM reset with confirmation
+
+## Testing Approach
+
+- Manual testing of CLI interactions
+- Verification of file system operations
+- Shell integration testing across different shells  
+- Error condition handling validation
+- User experience flow testing
+
+## Important Notes for Development
+
+- **Always test shell integration**: Verify .ccmanrc creation and shell reference addition
+- **Test interactive flows**: Ensure prompts work correctly in different scenarios
+- **Validate file operations**: Check permissions and error handling
+- **Cross-shell compatibility**: Test with bash, zsh, and fish when possible
+- **User experience focus**: Prioritize clear messaging and helpful guidance
+
+## Future Enhancement Areas
+
+- Configuration validation and migration
+- Backup and restore functionality
+- Environment templates or presets
+- Integration with external credential stores
+- Enhanced error reporting and diagnostics
+- Network connectivity testing for environments