cc-x10ded 3.0.0 → 3.0.9

package/CHANGELOG.md

@@ -5,6 +5,31 @@ 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).
 
+## [3.0.0] - 2025-12-24
+
+### 🚀 Major Rewrite (The "30x" Release)
+This release is a complete reimagining of the project, rewriting the entire codebase from Bash/PowerShell to **Bun/TypeScript**.
+
+### Added
+- **Single Binary (`ccx`)**: Replaced 5+ wrapper scripts with a single, standalone executable. No dependencies required.
+- **Interactive Setup (`ccx setup`)**: Beautiful CLI wizard to configure keys and aliases safely.
+- **Self-Healing Diagnostics (`ccx doctor`)**: Checks for API keys, Claude installation, shell paths, and configuration health.
+- **Auto-Discovery**: Automatically detects API keys (`ZAI_API_KEY`, `OPENAI_API_KEY`, etc.) from your environment.
+- **Smart Proxy**: `ccx` acts as a transparent proxy for OpenAI, Gemini, Minimax, and GLM models.
+- **Port Hunting**: Automatically finds an available port if 17870 is busy.
+- **Binary Hunting**: Robustly locates the `claude` binary in standard locations (Homebrew, NVM, npm global) even if it's missing from PATH.
+- **PowerShell Integration**: Native support for PowerShell profiles and aliases.
+
+### Changed
+- **Renamed**: Project package name changed to `cc-x10ded`.
+- **Runtime**: Switched from Node.js to **Bun** for instant startup performance.
+- **Config**: Moved from hardcoded script variables to `~/.config/claude-glm/config.json`.
+- **Proxy**: Migrated from Fastify to `Bun.serve()` for lower latency streaming.
+
+### Removed
+- Removed legacy `install.sh` and `install.ps1` scripts.
+- Removed dependency on user having Node.js installed (for binary usage).
+
 ## [Unreleased]
 
 ### Added

package/CONTRIBUTING.md

@@ -1,6 +1,6 @@
 # Contributing to Claude-GLM Wrapper
 
-Thank you for your interest in contributing to the **Bun-based** version of cc-x10ded!
+Thank you for your interest in contributing to the **Bun-based** version of Claude-GLM Wrapper!
 
 ## Development Setup
 

package/README.md

@@ -5,7 +5,7 @@
 > 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.
+> Install via: `bunx claude-glm-wrapper` or download the binary.
 
 ---
 
@@ -27,7 +27,7 @@ Use [Z.AI's GLM models](https://z.ai), [Minimax](https://minimax.io), [OpenAI](h
 
 **If you have Bun:**
 ```bash
-bunx cc-x10ded setup
+bunx claude-glm-wrapper setup
 ```
 
 **Manual Download (Mac/Linux/Windows):**

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "cc-x10ded",
-  "version": "3.0.0",
-  "description": "Cross-platform wrapper for Claude Code with Z.AI GLM models (Bun Edition)",
+  "version": "3.0.9",
+  "description": "Extend Claude Code with custom OpenAI-compatible model providers",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MohMaya/claude-glm-wrapper"
+  },
   "type": "module",
   "bin": {
     "ccx": "./src/index.ts"
@@ -12,7 +16,9 @@
     "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"
+    "build:darwin": "bun build --compile --minify --sourcemap --target=bun-darwin-arm64 ./src/index.ts --outfile dist/ccx-darwin",
+    "typecheck": "tsc --noEmit --skipLibCheck",
+    "prepare": "husky"
   },
   "dependencies": {
     "@clack/prompts": "^0.11.0",
@@ -22,6 +28,9 @@
     "zod": "^3.22.4"
   },
   "devDependencies": {
-    "@types/bun": "latest"
+    "@types/bun": "latest",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "typescript": "^5.9.3"
   }
 }

package/src/commands/config.ts

@@ -1,5 +1,5 @@
 import { ConfigManager } from "../core/config";
-import pc from "picocolors";
+import * as pc from "picocolors";
 import { spawn } from "bun";
 
 export async function configCommand() {
@@ -14,7 +14,7 @@ export async function configCommand() {
   
   try {
     const proc = spawn([editor, path], {
-        stdio: "inherit"
+        stdio: ["inherit", "inherit", "inherit"]
     });
     await proc.exited;
   } catch (e) {

package/src/commands/doctor.ts

@@ -1,7 +1,7 @@
 import { intro, outro, spinner } from "@clack/prompts";
 import { ShellIntegrator } from "../core/shell";
 import { ConfigManager } from "../core/config";
-import pc from "picocolors";
+import * as pc from "picocolors";
 import { existsSync } from "fs";
 
 export async function doctorCommand() {

package/src/commands/run.ts

@@ -2,7 +2,7 @@ import { spawn } from "bun";
 import { ConfigManager } from "../core/config";
 import { startProxyServer } from "../proxy/server";
 import { ShellIntegrator } from "../core/shell";
-import pc from "picocolors";
+import * as pc from "picocolors";
 
 export async function runCommand(args: string[], options: { model?: string; port?: number }) {
   const configManager = new ConfigManager();

package/src/commands/setup.ts

@@ -2,7 +2,7 @@ import { intro, outro, text, confirm, select, spinner, isCancel, cancel, note }
 import { ConfigManager } from "../core/config";
 import { ShellIntegrator } from "../core/shell";
 import { spawn } from "bun";
-import pc from "picocolors";
+import * as pc from "picocolors";
 
 export async function setupCommand() {
   intro(pc.bgBlue(pc.white(" Claude-GLM Setup ")));
@@ -49,9 +49,9 @@ export async function setupCommand() {
     });
     
     if (openBrowser && !isCancel(openBrowser)) {
-        spawn(["open", "https://z.ai/manage-apikey/apikey-list"]).catch(() => {});
-        spawn(["xdg-open", "https://z.ai/manage-apikey/apikey-list"]).catch(() => {}); // Linux
-        spawn(["explorer", "https://z.ai/manage-apikey/apikey-list"]).catch(() => {}); // Windows
+        try { spawn(["open", "https://z.ai/manage-apikey/apikey-list"]); } catch {}
+        try { spawn(["xdg-open", "https://z.ai/manage-apikey/apikey-list"]); } catch {} // Linux
+        try { spawn(["explorer", "https://z.ai/manage-apikey/apikey-list"]); } catch {} // Windows
     }
 
     const zaiKey = await text({

package/src/core/shell.ts

@@ -1,6 +1,6 @@
 import { join } from "path";
 import { homedir, platform } from "os";
-import { existsSync, readFileSync, appendFileSync, writeFileSync } from "fs";
+import { existsSync, mkdirSync } from "fs";
 
 export type ShellType = "bash" | "zsh" | "fish" | "powershell" | "unknown";
 

package/src/index.ts

@@ -25,7 +25,7 @@ cli
   .action(async () => {
     console.log("Updating ccx...");
     const { spawn } = await import("bun");
-    const proc = spawn(["npm", "install", "-g", "claude-glm-wrapper"], { stdio: "inherit" });
+    const proc = spawn(["npm", "install", "-g", "claude-glm-wrapper"], { stdio: ["inherit", "inherit", "inherit"] });
     await proc.exited;
     if (proc.exitCode === 0) {
         console.log("✅ Update complete!");

package/src/proxy/map.ts

@@ -1,4 +1,4 @@
-import { AnthropicMessage, AnthropicRequest, ProviderKey, ProviderModel } from "./types";
+import type { AnthropicMessage, AnthropicRequest, ProviderKey, ProviderModel } from "./types";
 
 const PROVIDER_PREFIXES: ProviderKey[] = ["openai", "openrouter", "gemini", "glm", "anthropic", "minimax"];
 
@@ -38,11 +38,11 @@ export function parseProviderModel(modelField: string, defaults?: ProviderModel)
   }
 
   const [maybeProv, ...rest] = modelField.split(sep);
-  let prov = maybeProv.toLowerCase();
+  let prov = (maybeProv || "").toLowerCase();
 
   // Resolve alias
   if (PROVIDER_ALIASES[prov]) {
-      prov = PROVIDER_ALIASES[prov];
+      prov = PROVIDER_ALIASES[prov] || prov;
   }
 
   if (!PROVIDER_PREFIXES.includes(prov as ProviderKey)) {

package/src/proxy/providers.ts

@@ -1,5 +1,5 @@
 import { createParser } from "eventsource-parser";
-import { AnthropicRequest } from "./types";
+import type { AnthropicRequest } from "./types";
 import { toOpenAIMessages, toGeminiContents } from "./map";
 import { createStartMessage, createDelta, createStopMessage, ApiError } from "./utils";
 
@@ -36,7 +36,7 @@ export async function* streamOpenAI(
   const decoder = new TextDecoder();
   let buffer = ""; // Store partial chunks if needed, but parser handles it
 
-  const parser = createParser((event) => {
+  const parser = createParser(((event: any) => {
     if (event.type !== "event") return;
     const data = event.data;
     if (!data || data === "[DONE]") return;
@@ -45,7 +45,7 @@ export async function* streamOpenAI(
       const chunk = json.choices?.[0]?.delta?.content ?? "";
       if (chunk) buffer += createDelta(chunk);
     } catch {}
-  });
+  }) as any);
 
   while (true) {
     const { value, done } = await reader.read();
@@ -91,7 +91,7 @@ export async function* streamGemini(
   const decoder = new TextDecoder();
   let buffer = "";
 
-  const parser = createParser((event) => {
+  const parser = createParser(((event: any) => {
     if (event.type !== "event") return;
     const data = event.data;
     if (!data) return;
@@ -100,7 +100,7 @@ export async function* streamGemini(
       const text = json?.candidates?.[0]?.content?.parts?.map((p: any) => p?.text || "").join("") || "";
       if (text) buffer += createDelta(text);
     } catch {}
-  });
+  }) as any);
 
   while (true) {
     const { value, done } = await reader.read();

package/src/proxy/server.ts

@@ -1,8 +1,9 @@
 import { serve } from "bun";
 import { parseProviderModel } from "./map";
 import { streamOpenAI, streamGemini, streamPassThrough } from "./providers";
-import { Config } from "../core/config";
-import { AnthropicRequest } from "./types";
+import { toReadableStream } from "./utils";
+import type { Config } from "../core/config";
+import type { AnthropicRequest } from "./types";
 
 export function startProxyServer(config: Config, port: number = 17870) {
   return serve({
@@ -32,19 +33,19 @@ export function startProxyServer(config: Config, port: number = 17870) {
         if (provider === "openai") {
           const conf = providers.openai;
           if (!conf?.apiKey) throw new Error("Missing OpenAI API Key");
-          return new Response(streamOpenAI(body, model, conf.apiKey, conf.baseUrl || "https://api.openai.com/v1"), { headers });
+          return new Response(toReadableStream(streamOpenAI(body, model, conf.apiKey, conf.baseUrl || "https://api.openai.com/v1")), { headers });
         }
 
         if (provider === "openrouter") {
           const conf = providers.openrouter;
           if (!conf?.apiKey) throw new Error("Missing OpenRouter API Key");
-          return new Response(streamOpenAI(body, model, conf.apiKey, conf.baseUrl || "https://openrouter.ai/api/v1"), { headers });
+          return new Response(toReadableStream(streamOpenAI(body, model, conf.apiKey, conf.baseUrl || "https://openrouter.ai/api/v1")), { headers });
         }
 
         if (provider === "gemini") {
           const conf = providers.gemini;
           if (!conf?.apiKey) throw new Error("Missing Gemini API Key");
-          return new Response(streamGemini(body, model, conf.apiKey, conf.baseUrl || "https://generativelanguage.googleapis.com/v1beta"), { headers });
+          return new Response(toReadableStream(streamGemini(body, model, conf.apiKey, conf.baseUrl || "https://generativelanguage.googleapis.com/v1beta")), { headers });
         }
         
         // Anthropic-compatible handlers (Passthrough)
@@ -77,7 +78,7 @@ export function startProxyServer(config: Config, port: number = 17870) {
             ...extraHeaders
         };
 
-        return new Response(streamPassThrough(body, baseUrl, apiHeaders), { headers });
+        return new Response(toReadableStream(streamPassThrough(body, baseUrl, apiHeaders)), { headers });
 
       } catch (e: any) {
         return new Response(JSON.stringify({ error: e.message }), { status: 500, headers: { "Content-Type": "application/json" } });

package/src/proxy/utils.ts

@@ -48,7 +48,24 @@ export function createStopMessage() {
 }
 
 export class ApiError extends Error {
-  constructor(public message: string, public statusCode: number = 500) {
+  constructor(public override message: string, public statusCode: number = 500) {
     super(message);
   }
 }
+
+// Convert an async generator to a ReadableStream
+export function toReadableStream<T>(gen: AsyncGenerator<T>): ReadableStream<T> {
+  return new ReadableStream({
+    async pull(controller) {
+      const { value, done } = await gen.next();
+      if (done) {
+        controller.close();
+      } else {
+        controller.enqueue(value);
+      }
+    },
+    cancel() {
+      gen.return(undefined);
+    }
+  });
+}

package/tsconfig.json

@@ -13,6 +13,7 @@
     "allowImportingTsExtensions": true,
     "verbatimModuleSyntax": true,
     "noEmit": true,
+    "resolveJsonModule": true,
 
     // Best practices
     "strict": true,

package/.serena/project.yml

@@ -1,84 +0,0 @@
-# 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/bun.lock

@@ -1,47 +0,0 @@
-{
-  "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=="],
-  }
-}