@acampkin/mcc 2.1.0

package/README.md

@@ -0,0 +1,227 @@
+# MCC - Multi-Client Coder for Claude
+
+A session-aware launcher for Claude Code that enables seamless switching between multiple AI providers with secure credential management, session recovery, and autopilot mode.
+
+**[npm](https://www.npmjs.com/package/@velocity-digital/mcc)** | **[GitHub](https://github.com/velocity-digital/mcc)** | **[Documentation](https://github.com/velocity-digital/mcc#readme)**
+
+## v2.1 Features
+
+- **Multi-Provider Support**: Claude Max, Z.AI GLM, MiniMax, DeepInfra, local LLMs, and custom endpoints
+- **Claude Agent SDK Integration**: Native support for Anthropic Agent SDK with full tool support
+- **Interactive Setup Wizard**: Guided first-run experience for new users
+- **Latest Models**: Pre-configured with Claude 4.6 (Opus 4.6, Sonnet 4.6)
+- **Session Recovery**: Save and resume sessions with full context transfer
+- **Autopilot Mode**: Fully autonomous execution from idea to working code
+- **Secure Credential Storage**: AES-256-GCM encrypted local storage with environment variable fallback
+- **Simplified UI**: Compact, efficient interactive menu
+- **Workspace Awareness**: Git-aware session detection and organization
+- **Health Monitoring**: Real-time provider status with detailed diagnostics
+
+## Installation
+
+### From npm (Recommended)
+
+```bash
+npm install -g @velocity-digital/mcc
+```
+
+### From Source
+
+```bash
+git clone https://github.com/velocity-digital/mcc.git
+cd mcc/mcc
+npm install
+npm run build:bundle
+npm link
+```
+
+### One-Line Install (macOS/Linux)
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/velocity-digital/mcc/main/release/install.sh | sh
+```
+
+## Quick Start
+
+```bash
+# First run - guided setup wizard
+mcc
+
+# Quick launch with specific provider
+mcc launch claude-max
+
+# Run setup wizard manually
+mcc setup
+
+# List all providers
+mcc list
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `mcc` | Interactive menu (default) |
+| `mcc setup` | Run guided setup wizard |
+| `mcc launch [id]` | Launch Claude with provider |
+| `mcc list` | List all providers |
+| `mcc health [id]` | Check provider health |
+| `mcc switch [id]` | Switch active provider without restarting |
+| `mcc status` | Show current provider status |
+| `mcc resume [id]` | Resume previous session |
+| `mcc sessions ls` | List all sessions |
+| `mcc sessions export <id>` | Export session to file |
+| `mcc sessions import <file>` | Import session from file |
+| `mcc sessions clean [days]` | Remove old sessions |
+| `mcc autopilot <prompt>` | Fully autonomous execution |
+| `mcc update` | Check for and install updates |
+
+## Prepopulated Providers
+
+MCC comes with these providers pre-configured (disabled by default):
+
+| Provider | ID | Default Model | Auth |
+|----------|-----|---------------|------|
+| **Claude Max** | `claude-max` | claude-sonnet-4-6-20250219 | Bearer token |
+| **Z.AI GLM** | `zai-coding-plan` | glm-5 | Bearer token |
+| **MiniMax** | `minimax-coding-plan` | MiniMax-M2.5-highspeed | API key |
+| **DeepInfra** | `deepinfra` | claude-sonnet-4-5-20250929 | API key |
+| **LM Studio** | `lm-studio` | custom-model | None |
+| **GLM-4.7** | `glm-local` | zai-org/glm-4.7-flash | None |
+
+### Setting Up Claude Max
+
+1. Run `claude setup-token` in a separate terminal
+2. Launch MCC: `mcc`
+3. Select provider from menu
+4. Enter your bearer token when prompted
+
+### Setting Up Z.AI or MiniMax
+
+1. Get API key from [z.ai](https://z.ai) or [platform.minimax.io](https://platform.minimax.io)
+2. Launch MCC: `mcc`
+3. Select provider from menu
+4. Enter your API key when prompted
+
+## Credential Management
+
+MCC stores credentials in `~/.config/mcc/.credentials` with AES-256-GCM encryption.
+
+### Priority Order
+1. **Encrypted store** (primary) - Secure, persistent
+2. **Environment variables** (fallback) - For CI/CD or system-level config
+
+### Environment Variables
+
+```bash
+export ANTHROPIC_AUTH_TOKEN="sk-ant-..."
+export ZAI_API_KEY="your-zai-key"
+export MINIMAX_API_KEY="your-minimax-key"
+```
+
+## Configuration
+
+Config location: `~/.config/mcc/config.yaml`
+
+### Example Provider
+
+```yaml
+providers:
+  - id: claude-max
+    name: Claude Max Subscription
+    type: anthropic
+    enabled: true
+    auth:
+      method: bearer
+      tokenEnv: ANTHROPIC_AUTH_TOKEN
+    defaultModel: claude-sonnet-4-5-20250929
+    models:
+      - claude-opus-4-5-20251101
+      - claude-sonnet-4-5-20250929
+      - claude-haiku-4-5-20251001
+    timeout: 120000
+```
+
+## Directory Structure
+
+```
+~/.config/mcc/
+├── config.yaml          # Provider configuration
+├── .credentials         # Encrypted credential store
+├── .active-session.json # Current session pointer
+└── sessions/            # Session files
+    ├── abc12345.json
+    └── def67890.json
+```
+
+## Autopilot Mode (Coming Soon)
+
+Autopilot enables fully autonomous execution:
+
+```bash
+mcc autopilot "add dark mode to the app"
+mcc autopilot "fix the login bug" --provider zai
+mcc autopilot "refactor auth" --export
+```
+
+Flow:
+1. **Planning**: Break down prompt into tasks
+2. **Execution**: Run tasks with verification
+3. **Self-Correction**: Fix issues automatically
+4. **Completion**: Export session with summary
+
+## Multi-Provider Switching
+
+Switch providers without restarting Claude Code:
+
+```bash
+# Launch Claude with multi-provider proxy
+mcc launch claude-max
+
+# In another terminal, switch providers
+mcc switch                    # Interactive selection
+mcc switch zai-coding-plan     # Direct selection
+mcc status                     # Show current status
+```
+
+How it works:
+1. MCC runs a local proxy between Claude and providers
+2. All enabled providers are loaded at launch
+3. The `mcc switch` command updates the proxy's active provider
+4. Next request from Claude routes to the new provider seamlessly
+
+This is useful for:
+- Comparing outputs from different providers
+- Using cheaper providers for simple tasks
+- Switching to specialized providers for specific workloads
+
+## Troubleshooting
+
+### "No credentials configured"
+
+1. For Claude Max: Run `claude setup-token` first
+2. Use interactive menu to enter credentials
+3. Or set environment variable
+
+### Provider not responding
+
+1. Run `mcc health -v` for diagnostics
+2. Check endpoint is accessible
+3. Increase timeout in config
+
+## Development
+
+```bash
+npm run dev      # Development mode
+npm run build    # Build
+npm run link     # Link globally
+npm run test     # Run tests
+```
+
+## License
+
+MIT
+
+---
+
+Built by [Velocity Digital](https://velocitydigi.com)