cc-x10ded 3.0.0

package/.serena/project.yml

@@ -0,0 +1,84 @@
+# list of languages for which language servers are started; choose from:
+#   al               bash             clojure          cpp              csharp           csharp_omnisharp
+#   dart             elixir           elm              erlang           fortran          go
+#   haskell          java             julia            kotlin           lua              markdown
+#   nix              perl             php              python           python_jedi      r
+#   rego             ruby             ruby_solargraph  rust             scala            swift
+#   terraform        typescript       typescript_vts   yaml             zig
+# Note:
+#   - For C, use cpp
+#   - For JavaScript, use typescript
+# Special requirements:
+#   - csharp: Requires the presence of a .sln file in the project folder.
+# When using multiple languages, the first language server that supports a given file will be used for that file.
+# The first language is the default language and the respective language server will be used as a fallback.
+# Note that when using the JetBrains backend, language servers are not used and this list is correspondingly ignored.
+languages:
+- typescript
+
+# the encoding used by text files in the project
+# For a list of possible encodings, see https://docs.python.org/3.11/library/codecs.html#standard-encodings
+encoding: "utf-8"
+
+# whether to use the project's gitignore file to ignore files
+# Added on 2025-04-07
+ignore_all_files_in_gitignore: true
+
+# list of additional paths to ignore
+# same syntax as gitignore, so you can use * and **
+# Was previously called `ignored_dirs`, please update your config if you are using that.
+# Added (renamed) on 2025-04-07
+ignored_paths: []
+
+# whether the project is in read-only mode
+# If set to true, all editing tools will be disabled and attempts to use them will result in an error
+# Added on 2025-04-18
+read_only: false
+
+# list of tool names to exclude. We recommend not excluding any tools, see the readme for more details.
+# Below is the complete list of tools for convenience.
+# To make sure you have the latest list of tools, and to view their descriptions, 
+# execute `uv run scripts/print_tool_overview.py`.
+#
+#  * `activate_project`: Activates a project by name.
+#  * `check_onboarding_performed`: Checks whether project onboarding was already performed.
+#  * `create_text_file`: Creates/overwrites a file in the project directory.
+#  * `delete_lines`: Deletes a range of lines within a file.
+#  * `delete_memory`: Deletes a memory from Serena's project-specific memory store.
+#  * `execute_shell_command`: Executes a shell command.
+#  * `find_referencing_code_snippets`: Finds code snippets in which the symbol at the given location is referenced.
+#  * `find_referencing_symbols`: Finds symbols that reference the symbol at the given location (optionally filtered by type).
+#  * `find_symbol`: Performs a global (or local) search for symbols with/containing a given name/substring (optionally filtered by type).
+#  * `get_current_config`: Prints the current configuration of the agent, including the active and available projects, tools, contexts, and modes.
+#  * `get_symbols_overview`: Gets an overview of the top-level symbols defined in a given file.
+#  * `initial_instructions`: Gets the initial instructions for the current project.
+#     Should only be used in settings where the system prompt cannot be set,
+#     e.g. in clients you have no control over, like Claude Desktop.
+#  * `insert_after_symbol`: Inserts content after the end of the definition of a given symbol.
+#  * `insert_at_line`: Inserts content at a given line in a file.
+#  * `insert_before_symbol`: Inserts content before the beginning of the definition of a given symbol.
+#  * `list_dir`: Lists files and directories in the given directory (optionally with recursion).
+#  * `list_memories`: Lists memories in Serena's project-specific memory store.
+#  * `onboarding`: Performs onboarding (identifying the project structure and essential tasks, e.g. for testing or building).
+#  * `prepare_for_new_conversation`: Provides instructions for preparing for a new conversation (in order to continue with the necessary context).
+#  * `read_file`: Reads a file within the project directory.
+#  * `read_memory`: Reads the memory with the given name from Serena's project-specific memory store.
+#  * `remove_project`: Removes a project from the Serena configuration.
+#  * `replace_lines`: Replaces a range of lines within a file with new content.
+#  * `replace_symbol_body`: Replaces the full definition of a symbol.
+#  * `restart_language_server`: Restarts the language server, may be necessary when edits not through Serena happen.
+#  * `search_for_pattern`: Performs a search for a pattern in the project.
+#  * `summarize_changes`: Provides instructions for summarizing the changes made to the codebase.
+#  * `switch_modes`: Activates modes by providing a list of their names
+#  * `think_about_collected_information`: Thinking tool for pondering the completeness of collected information.
+#  * `think_about_task_adherence`: Thinking tool for determining whether the agent is still on track with the current task.
+#  * `think_about_whether_you_are_done`: Thinking tool for determining whether the task is truly completed.
+#  * `write_memory`: Writes a named memory (for future reference) to Serena's project-specific memory store.
+excluded_tools: []
+
+# initial prompt for the project. It will always be given to the LLM upon activating the project
+# (contrary to the memories, which are loaded on demand).
+initial_prompt: ""
+
+project_name: "claude-glm-wrapper"
+included_optional_tools: []

package/CHANGELOG.md

@@ -0,0 +1,85 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- GLM-4.7 model support as new default
+- GLM-4.6 wrapper (ccg46) for backward compatibility
+
+### Changed
+- Updated default model from GLM-4.6 to GLM-4.7
+
+## [1.0.3] - 2025-10-01
+
+### Changed
+- Removed global installation support - npx only
+- Updated preinstall script to block ALL installation methods (local and global)
+- Clearer error messaging emphasizing npx as the only supported method
+
+## [1.0.2] - 2025-10-01
+
+### Added
+- Preinstall check to prevent incorrect installation method
+- Error message directing users to use `npx` instead of `npm i`
+- Support for global installation with `-g` flag
+
+### Changed
+- Installation now blocks when users try `npm i claude-glm-installer` locally
+- Improved user guidance for correct installation method
+
+## [1.0.1] - 2025-10-01
+
+### Changed
+- Updated package description to include npx usage instructions
+- Clarified installation method in npm package listing
+
+## [1.0.0] - 2025-10-01
+
+### Added
+- Windows PowerShell support with full feature parity
+- Cross-platform npm package installer (`npx claude-glm-installer`)
+- Automatic detection and cleanup of old wrapper installations
+- GLM-4.6 model support as new default
+- GLM-4.5 wrapper (ccg45) for backward compatibility
+- Universal bootstrap script for OS auto-detection
+- Comprehensive Windows documentation and troubleshooting
+- Platform-specific installation paths and configuration
+- Bash installer for Unix/Linux/macOS
+- Support for GLM-4.5 and GLM-4.5-Air models
+- Isolated configuration directories per model
+- Shell aliases (ccg, ccg45, ccf, cc)
+- No sudo/admin required installation
+- Wrapper scripts in ~/.local/bin
+- Z.AI API key integration
+- Separate chat histories per model
+- Error reporting system with GitHub issue integration
+- Test mode for error reporting (`--test-error` flag)
+- Debug mode (`--debug` flag)
+- User consent prompts for error reporting
+
+### Changed
+- Updated default model from GLM-4.5 to GLM-4.6
+- Renamed aliases: removed `cca`, kept `cc` for regular Claude
+- Improved installation flow with old wrapper detection
+- Enhanced README with collapsible platform-specific sections
+- Updated cross-platform support documentation
+
+### Fixed
+- PATH conflicts when multiple wrapper installations exist
+- Version mismatches from old wrapper files
+- Installation detection across different locations
+- PowerShell parsing errors when piping through `iex`
+- Nested here-string issues in PowerShell
+- Subexpression parsing errors in piped contexts
+- Terminal/PowerShell window persistence after errors
+
+[Unreleased]: https://github.com/JoeInnsp23/claude-glm-wrapper/compare/v1.0.3...HEAD
+[1.0.3]: https://github.com/JoeInnsp23/claude-glm-wrapper/compare/v1.0.2...v1.0.3
+[1.0.2]: https://github.com/JoeInnsp23/claude-glm-wrapper/compare/v1.0.1...v1.0.2
+[1.0.1]: https://github.com/JoeInnsp23/claude-glm-wrapper/compare/v1.0.0...v1.0.1
+[1.0.0]: https://github.com/JoeInnsp23/claude-glm-wrapper/releases/tag/v1.0.0

package/CONTRIBUTING.md

@@ -0,0 +1,74 @@
+# Contributing to Claude-GLM Wrapper
+
+Thank you for your interest in contributing to the **Bun-based** version of cc-x10ded!
+
+## Development Setup
+
+### Prerequisites
+
+- **Bun**: This project is built entirely on Bun. [Install Bun](https://bun.sh/).
+- **Claude Code**: Recommended for testing integration.
+
+### Getting Started
+
+1. **Clone the repository**:
+   ```bash
+   git clone https://github.com/MohMaya/claude-glm-wrapper.git
+   cd claude-glm-wrapper
+   ```
+
+2. **Install dependencies**:
+   ```bash
+   bun install
+   ```
+
+3. **Run in development mode**:
+   ```bash
+   bun run dev --help
+   bun run dev doctor
+   ```
+
+### Project Structure
+
+```
+src/
+├── commands/       # CLI commands (run, setup, doctor, config)
+├── core/           # Core logic (ConfigManager, ShellIntegrator)
+├── proxy/          # Proxy server logic & provider adapters
+└── index.ts        # Entry point
+```
+
+## Adding Features
+
+1. **New Providers**: Add logic to `src/proxy/server.ts` and `src/proxy/providers.ts`. Update `src/core/config.ts` to support new keys.
+2. **New Commands**: Create a new file in `src/commands/` and register it in `src/index.ts`.
+
+## Building
+
+To compile the standalone binaries:
+
+```bash
+bun run build       # Builds for current OS
+bun run build:all   # Builds for Linux, macOS, and Windows
+```
+
+Artifacts will be placed in `dist/`.
+
+## Testing
+
+Please run the doctor command to verify your environment changes didn't break core diagnostics:
+
+```bash
+bun run dev doctor
+```
+
+## Pull Request Process
+
+1. Fork the repo and create your branch from `main`.
+2. Ensure your code follows the existing style (Bun/TypeScript).
+3. Update documentation if you add user-facing features.
+4. Submit a PR!
+
+## License
+
+MIT

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Joseph Stephenson-Mouzo
+
+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/README.md

@@ -0,0 +1,122 @@
+# Claude-GLM Wrapper (ccx)
+
+> **📢 Community Fork Notice**
+> 
+> This is an actively maintained community fork of the original [claude-glm-wrapper](https://github.com/JoeInnsp23/claude-glm-wrapper). 
+> Now rewritten in **Bun** for 10x speed and single-binary simplicity.
+> 
+> Install via: `bunx cc-x10ded` or download the binary.
+
+---
+
+Use [Z.AI's GLM models](https://z.ai), [Minimax](https://minimax.io), [OpenAI](https://openai.com), and more with [Claude Code](https://www.anthropic.com/claude-code).
+
+**One Binary. Zero Friction.**
+
+## Why ccx?
+
+**🚀 10x Faster**: Native binary (written in Bun/TypeScript), starts instantly.
+**📦 Single Binary**: No more "wrapper hell". One `ccx` executable handles everything.
+**🛡️ Safe & Clean**: No more `eval` in shell scripts. Configs stored safely in `~/.config`.
+**🔀 Multi-Provider**: Switch between GLM, Minimax, OpenAI, Gemini, and Claude instantly.
+**🩺 Self-Healing**: Includes a `doctor` command to diagnose and fix configuration issues automatically.
+
+## Quick Start
+
+### Installation
+
+**If you have Bun:**
+```bash
+bunx cc-x10ded setup
+```
+
+**Manual Download (Mac/Linux/Windows):**
+1. Download the latest release from [GitHub Releases](https://github.com/MohMaya/claude-glm-wrapper/releases).
+2. Run `./ccx setup` (or `.\ccx.exe setup` on Windows).
+
+### Setup Wizard
+
+Run `ccx setup` to:
+1. Configure your API keys (Z.AI, Minimax, OpenAI, etc.).
+2. Install shell aliases (`cc`, `ccg`, `ccm`...) automatically.
+3. Verify your Claude Code installation.
+
+## Usage
+
+### Commands
+
+| Command | Action |
+|---------|--------|
+| `ccx` | Run Claude Code with your default model (e.g. GLM-4.7) |
+| `ccx setup` | Run the interactive setup wizard |
+| `ccx config` | Open configuration file |
+| `ccx doctor` | Run self-diagnostics to check API keys, paths, and dependencies |
+| `ccx update` | Update to the latest version |
+| `ccx --model=gpt-4o` | Run with a specific model override |
+
+### Aliases (Optional)
+
+If you enabled aliases during setup:
+
+| Alias | Equivalent Command |
+|-------|-------------------|
+| `cc` | `claude` (Standard Anthropic) |
+| `ccg` | `ccx --model=glm-4.7` |
+| `ccg45` | `ccx --model=glm-4.5` |
+| `ccf` | `ccx --model=glm-4.5-air` |
+| `ccm` | `ccx --model=MiniMax-M2.1` |
+
+### Multi-Provider Proxy
+
+`ccx` automatically acts as a local proxy. You can use ANY supported provider by specifying the prefix:
+
+```bash
+ccx --model=openai:gpt-4o
+ccx --model=gemini:gemini-1.5-pro
+ccx --model=minimax:MiniMax-M2.1
+```
+
+Or switch **in-session** using Claude's slash command:
+`/model openai:gpt-4o`
+
+### Auto-Discovery (Zero Config)
+
+`ccx` is smart! It automatically detects API keys in your environment variables, so you might not even need to run setup.
+
+Supported variables:
+- `ZAI_API_KEY` or `GLM_API_KEY`
+- `MINIMAX_API_KEY`
+- `OPENAI_API_KEY`
+- `ANTHROPIC_API_KEY`
+- `GEMINI_API_KEY`
+- `OPENROUTER_API_KEY`
+
+## Configuration
+
+Config is stored in `~/.config/claude-glm/config.json`.
+You can edit it with `ccx config`.
+
+```json
+{
+  "zaiApiKey": "sk-...",
+  "minimaxApiKey": "...",
+  "providers": {
+    "openai": { "apiKey": "sk-..." }
+  },
+  "defaults": {
+    "model": "glm-4.7"
+  }
+}
+```
+
+## Troubleshooting
+
+**"ccx: command not found"**
+Ensure the binary is in your PATH, or that you've run the setup which helps install aliases.
+
+**"Error: 'claude' command not found"**
+Run `ccx doctor` or `ccx setup` — it will offer to install Claude Code for you automatically!
+
+## License
+
+MIT

package/bun.lock

@@ -0,0 +1,47 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "claude-glm-wrapper",
+      "dependencies": {
+        "@clack/prompts": "^0.11.0",
+        "cac": "^6.7.14",
+        "eventsource-parser": "^3.0.6",
+        "picocolors": "^1.1.1",
+        "zod": "^4.2.1",
+      },
+      "devDependencies": {
+        "@types/bun": "latest",
+      },
+      "peerDependencies": {
+        "typescript": "^5",
+      },
+    },
+  },
+  "packages": {
+    "@clack/core": ["@clack/core@0.5.0", "", { "dependencies": { "picocolors": "^1.0.0", "sisteransi": "^1.0.5" } }, "sha512-p3y0FIOwaYRUPRcMO7+dlmLh8PSRcrjuTndsiA0WAFbWES0mLZlrjVoBRZ9DzkPFJZG6KGkJmoEAY0ZcVWTkow=="],
+
+    "@clack/prompts": ["@clack/prompts@0.11.0", "", { "dependencies": { "@clack/core": "0.5.0", "picocolors": "^1.0.0", "sisteransi": "^1.0.5" } }, "sha512-pMN5FcrEw9hUkZA4f+zLlzivQSeQf5dRGJjSUbvVYDLvpKCdQx5OaknvKzgbtXOizhP+SJJJjqEbOe55uKKfAw=="],
+
+    "@types/bun": ["@types/bun@1.3.5", "", { "dependencies": { "bun-types": "1.3.5" } }, "sha512-RnygCqNrd3srIPEWBd5LFeUYG7plCoH2Yw9WaZGyNmdTEei+gWaHqydbaIRkIkcbXwhBT94q78QljxN0Sk838w=="],
+
+    "@types/node": ["@types/node@25.0.3", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-W609buLVRVmeW693xKfzHeIV6nJGGz98uCPfeXI1ELMLXVeKYZ9m15fAMSaUPBHYLGFsVRcMmSCksQOrZV9BYA=="],
+
+    "bun-types": ["bun-types@1.3.5", "", { "dependencies": { "@types/node": "*" } }, "sha512-inmAYe2PFLs0SUbFOWSVD24sg1jFlMPxOjOSSCYqUgn4Hsc3rDc7dFvfVYjFPNHtov6kgUeulV4SxbuIV/stPw=="],
+
+    "cac": ["cac@6.7.14", "", {}, "sha512-b6Ilus+c3RrdDk+JhLKUAQfzzgLEPy6wcXqS7f/xe1EETvsDP6GORG7SFuOs6cID5YkqchW/LXZbX5bc8j7ZcQ=="],
+
+    "eventsource-parser": ["eventsource-parser@3.0.6", "", {}, "sha512-Vo1ab+QXPzZ4tCa8SwIHJFaSzy4R6SHf7BY79rFBDf0idraZWAkYrDjDj8uWaSm3S2TK+hJ7/t1CEmZ7jXw+pg=="],
+
+    "picocolors": ["picocolors@1.1.1", "", {}, "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA=="],
+
+    "sisteransi": ["sisteransi@1.0.5", "", {}, "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
+
+    "zod": ["zod@4.2.1", "", {}, "sha512-0wZ1IRqGGhMP76gLqz8EyfBXKk0J2qo2+H3fi4mcUP/KtTocoX08nmIAHl1Z2kJIZbZee8KOpBCSNPRgauucjw=="],
+  }
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "cc-x10ded",
+  "version": "3.0.0",
+  "description": "Cross-platform wrapper for Claude Code with Z.AI GLM models (Bun Edition)",
+  "type": "module",
+  "bin": {
+    "ccx": "./src/index.ts"
+  },
+  "scripts": {
+    "dev": "bun run src/index.ts",
+    "build": "bun build --compile --minify --sourcemap ./src/index.ts --outfile dist/ccx",
+    "build:all": "bun run build:linux && bun run build:windows && bun run build:darwin",
+    "build:linux": "bun build --compile --minify --sourcemap --target=bun-linux-x64 ./src/index.ts --outfile dist/ccx-linux",
+    "build:windows": "bun build --compile --minify --sourcemap --target=bun-windows-x64 ./src/index.ts --outfile dist/ccx.exe",
+    "build:darwin": "bun build --compile --minify --sourcemap --target=bun-darwin-arm64 ./src/index.ts --outfile dist/ccx-darwin"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "cac": "^6.7.14",
+    "eventsource-parser": "^3.0.6",
+    "picocolors": "^1.1.1",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/bun": "latest"
+  }
+}

package/src/commands/config.ts

@@ -0,0 +1,23 @@
+import { ConfigManager } from "../core/config";
+import pc from "picocolors";
+import { spawn } from "bun";
+
+export async function configCommand() {
+  const manager = new ConfigManager();
+  const path = manager.getPath();
+  manager.ensureConfigDir();
+  
+  console.log(`Config file: ${path}`);
+  
+  // Try to open with default editor
+  const editor = process.env.EDITOR || "nano"; // Fallback to nano if EDITOR not set
+  
+  try {
+    const proc = spawn([editor, path], {
+        stdio: "inherit"
+    });
+    await proc.exited;
+  } catch (e) {
+      console.log(pc.red("Could not open editor. Please edit the file manually."));
+  }
+}

package/src/commands/doctor.ts

@@ -0,0 +1,73 @@
+import { intro, outro, spinner } from "@clack/prompts";
+import { ShellIntegrator } from "../core/shell";
+import { ConfigManager } from "../core/config";
+import pc from "picocolors";
+import { existsSync } from "fs";
+
+export async function doctorCommand() {
+  intro(pc.bgBlue(pc.white(" ccx Doctor 🩺 ")));
+
+  const s = spinner();
+  const issues: string[] = [];
+  const checks: string[] = [];
+
+  // 1. Check Config
+  s.start("Checking configuration...");
+  const configManager = new ConfigManager();
+  const config = await configManager.read();
+  
+  if (!config.zaiApiKey && !config.minimaxApiKey && Object.keys(config.providers).length === 0) {
+      issues.push("❌ No API keys configured. Run 'ccx setup'.");
+  } else {
+      checks.push("✅ Configuration loaded");
+  }
+  s.stop("Configuration check complete");
+
+  // 2. Check Claude Binary
+  s.start("Checking Claude Code installation...");
+  const shellInt = new ShellIntegrator();
+  const claudePath = await shellInt.findClaudeBinary();
+  
+  if (claudePath) {
+      checks.push(`✅ Claude binary found: ${claudePath}`);
+  } else {
+      issues.push("❌ 'claude' command not found in common locations.");
+      issues.push("   👉 Suggestion: Run 'npm install -g @anthropic-ai/claude-code'");
+  }
+  s.stop("Claude check complete");
+
+  // 3. Check Shell Integration
+  s.start("Checking shell integration...");
+  const shell = shellInt.detectShell();
+  const profile = shellInt.getProfilePath(shell);
+  
+  if (shell === "unknown") {
+      issues.push("⚠️  Could not detect shell type.");
+  } else {
+      checks.push(`✅ Shell detected: ${shell}`);
+      if (profile && existsSync(profile)) {
+          const content = await Bun.file(profile).text();
+          if (content.includes("ccx")) {
+              checks.push("✅ Aliases found in profile");
+          } else {
+              issues.push(`⚠️  Aliases missing in ${profile}. Run 'ccx setup'.`);
+          }
+      }
+  }
+  s.stop("Shell check complete");
+
+  // 4. Check Network/Proxy (Port 17870)
+  // We won't actually bind, just check if we can
+  
+  console.log("\n" + pc.bold("Diagnostic Report:"));
+  checks.forEach(c => console.log(c));
+  console.log("");
+  
+  if (issues.length > 0) {
+      issues.forEach(i => console.log(i));
+      outro(pc.yellow("Issues found. Please resolve them above."));
+      process.exit(1);
+  } else {
+      outro(pc.green("All systems operational! 🚀"));
+  }
+}

package/src/commands/run.ts

@@ -0,0 +1,76 @@
+import { spawn } from "bun";
+import { ConfigManager } from "../core/config";
+import { startProxyServer } from "../proxy/server";
+import { ShellIntegrator } from "../core/shell";
+import pc from "picocolors";
+
+export async function runCommand(args: string[], options: { model?: string; port?: number }) {
+  const configManager = new ConfigManager();
+  const config = await configManager.read();
+
+  if (!config.zaiApiKey && !config.minimaxApiKey && Object.keys(config.providers).length === 0) {
+    console.log(pc.yellow("Configuration missing. Running setup..."));
+    const { setupCommand } = await import("./setup");
+    await setupCommand();
+    // Re-read config
+    Object.assign(config, await configManager.read());
+  }
+
+  // Port hunting logic
+  let port = options.port || 17870;
+  let server;
+  let retries = 0;
+  
+  while (retries < 10) {
+      try {
+          server = startProxyServer(config, port);
+          break;
+      } catch (e: any) {
+          if (e.code === "EADDRINUSE" || e.message.includes("EADDRINUSE")) {
+              port++;
+              retries++;
+          } else {
+              throw e;
+          }
+      }
+  }
+  
+  if (!server) {
+      console.error(pc.red(`Failed to start proxy server after 10 attempts (ports ${options.port || 17870}-${port}).`));
+      process.exit(1);
+  }
+
+  const model = options.model || config.defaults.model || "glm-4.7";
+
+  // Robust binary finding
+  const shellInt = new ShellIntegrator();
+  const claudePath = await shellInt.findClaudeBinary();
+
+  if (!claudePath) {
+      console.error(pc.red("Error: 'claude' command not found."));
+      console.error(pc.yellow("Self-Healing Tip: Run 'ccx setup' or 'npm install -g @anthropic-ai/claude-code'"));
+      process.exit(1);
+  }
+
+  const env = {
+    ...process.env,
+    ANTHROPIC_BASE_URL: `http://127.0.0.1:${port}`,
+    ANTHROPIC_AUTH_TOKEN: "ccx-proxy-token", // Dummy token for the client
+    ANTHROPIC_MODEL: model,
+  };
+
+  try {
+    const proc = spawn([claudePath, ...args], {
+      env,
+      stdio: ["inherit", "inherit", "inherit"],
+    });
+
+    const code = await proc.exited;
+    process.exit(code);
+  } catch (e: any) {
+    console.error(pc.red(`Error starting Claude: ${e.message}`));
+    process.exit(1);
+  } finally {
+    server.stop();
+  }
+}