codexkit 1.0.4 → 1.0.6

package/.codex/.version

@@ -1 +1 @@
-1.0.4
+1.0.6

package/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.6] — 2026-03-18
+
+### Fixed
+
+- **Windows compatibility**: CLI entry point changed from bash script (`bin/codexkit`) to Node.js wrapper (`bin/codexkit.js`), fixing `The term '/bin/bash.exe' is not recognized` error when installing via `npm install -g`, `pnpm add -g`, or `bun add -g` on Windows
+- Node.js wrapper auto-detects bash from Git for Windows, MSYS2, WSL, or PATH; provides clear error message with install links if bash is not found
+- Works cross-platform with all major package managers (npm, pnpm, bun, yarn)
+- All install scripts now use `_python` / `_sha256` cross-platform helpers (via `install/_compat.sh`) instead of hardcoded `python3` / `shasum`, fixing failures on Windows where only `python` and `sha256sum` are available
+
 ## [1.0.4] — 2026-03-18
 
 ### Added

package/bin/codexkit

@@ -23,6 +23,9 @@ SCRIPT_PATH="$(resolve_script_path)"
 SCRIPT_DIR="$(cd "$(dirname "$SCRIPT_PATH")" && pwd)"
 REPO_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
 
+# shellcheck source=../install/_compat.sh
+source "$REPO_DIR/install/_compat.sh"
+
 usage() {
     cat <<'EOF'
 Codexkit CLI
@@ -99,7 +102,7 @@ print_version() {
     if [ -f "$REPO_DIR/.codex/.version" ]; then
         cat "$REPO_DIR/.codex/.version"
     elif [ -f "$REPO_DIR/package.json" ]; then
-        python3 -c 'import json,sys; print(json.load(open(sys.argv[1]))["version"])' "$REPO_DIR/package.json"
+        _python -c 'import json,sys; print(json.load(open(sys.argv[1]))["version"])' "$REPO_DIR/package.json"
     else
         echo "unknown"
     fi

package/bin/codexkit.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+"use strict";
+
+const { execFileSync, execSync } = require("child_process");
+const path = require("path");
+const fs = require("fs");
+const os = require("os");
+
+const BASH_SCRIPT = path.join(__dirname, "codexkit");
+
+function findBash() {
+  if (os.platform() !== "win32") {
+    return "/bin/bash";
+  }
+
+  // On Windows, try common bash locations in order
+  const candidates = [];
+
+  // Git for Windows (most common)
+  const programFiles = process.env.ProgramFiles || "C:\\Program Files";
+  const programFilesX86 =
+    process.env["ProgramFiles(x86)"] || "C:\\Program Files (x86)";
+  candidates.push(
+    path.join(programFiles, "Git", "bin", "bash.exe"),
+    path.join(programFilesX86, "Git", "bin", "bash.exe"),
+    path.join(programFiles, "Git", "usr", "bin", "bash.exe")
+  );
+
+  // MSYS2
+  candidates.push("C:\\msys64\\usr\\bin\\bash.exe");
+
+  // WSL
+  const system32 = path.join(
+    process.env.SystemRoot || "C:\\Windows",
+    "System32"
+  );
+  candidates.push(path.join(system32, "bash.exe"));
+
+  // Check PATH via where
+  try {
+    const result = execSync("where bash.exe", {
+      encoding: "utf8",
+      stdio: ["pipe", "pipe", "pipe"],
+    }).trim();
+    if (result) {
+      const first = result.split(/\r?\n/)[0];
+      if (first && fs.existsSync(first)) {
+        return first;
+      }
+    }
+  } catch (_) {
+    // not found via where
+  }
+
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate)) {
+      return candidate;
+    }
+  }
+
+  console.error(
+    "Error: bash not found. Codexkit requires bash to run.\n\n" +
+      "On Windows, install one of the following:\n" +
+      "  - Git for Windows: https://git-scm.com/download/win\n" +
+      "  - WSL: wsl --install\n" +
+      "  - MSYS2: https://www.msys2.org/\n"
+  );
+  process.exit(1);
+}
+
+const bash = findBash();
+const args = process.argv.slice(2);
+
+try {
+  const result = execFileSync(bash, [BASH_SCRIPT, ...args], {
+    stdio: "inherit",
+    env: { ...process.env },
+    windowsHide: false,
+  });
+  process.exit(0);
+} catch (err) {
+  if (err.status != null) {
+    process.exit(err.status);
+  }
+  console.error(err.message);
+  process.exit(1);
+}

package/install/_compat.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+# Cross-platform compatibility helpers for Windows (Git Bash), macOS, and Linux.
+# Source this file at the top of any install script that uses python3 or shasum.
+
+_python() {
+    if command -v python3 &>/dev/null; then
+        python3 "$@"
+    elif command -v python &>/dev/null; then
+        python "$@"
+    else
+        echo "✗ Python not found. Codexkit requires Python 3." >&2
+        exit 1
+    fi
+}
+
+_sha256() {
+    if command -v shasum &>/dev/null; then
+        shasum -a 256 "$@"
+    elif command -v sha256sum &>/dev/null; then
+        sha256sum "$@"
+    else
+        echo ""
+    fi
+}

package/install/generate-manifest.sh

@@ -3,6 +3,9 @@ set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 REPO_DIR="$(dirname "$SCRIPT_DIR")"
+
+# shellcheck source=_compat.sh
+source "$SCRIPT_DIR/_compat.sh"
 OUTPUT_FILE="$REPO_DIR/.template-manifest.json"
 CODEX_OUTPUT_FILE="$REPO_DIR/.codex/.template-manifest.json"
 
@@ -38,7 +41,7 @@ while IFS= read -r file; do FILES+=("$file"); done < <(find .codex/plans -type f
   for file in "${FILES[@]}"; do
     normalized="${file#./}"
     [[ -f "$normalized" ]] || continue
-    hash="$(shasum -a 256 "$normalized" | cut -d' ' -f1)"
+    hash="$(_sha256 "$normalized" | cut -d' ' -f1)"
     if $first; then
       first=false
     else

package/install/install-global.sh

@@ -4,6 +4,9 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 REPO_DIR="$(dirname "$SCRIPT_DIR")"
 
+# shellcheck source=_compat.sh
+source "$SCRIPT_DIR/_compat.sh"
+
 # Parse flags
 FORCE=false
 UPGRADE=false
@@ -38,8 +41,8 @@ check_copy_action() {
     $FORCE && return 2
 
     if $UPGRADE && [ -f "$MANIFEST" ]; then
-        manifest_hash=$(python3 -c 'import json,sys; d=json.load(open(sys.argv[1])); print(d.get("files",{}).get(sys.argv[2],""))' "$MANIFEST" "$source_path" 2>/dev/null || echo "")
-        installed_hash=$(shasum -a 256 "$target" 2>/dev/null | cut -d' ' -f1)
+        manifest_hash=$(_python -c 'import json,sys; d=json.load(open(sys.argv[1])); print(d.get("files",{}).get(sys.argv[2],""))' "$MANIFEST" "$source_path" 2>/dev/null || echo "")
+        installed_hash=$(_sha256 "$target" 2>/dev/null | cut -d' ' -f1)
         if [ -n "$manifest_hash" ] && [ "$installed_hash" = "$manifest_hash" ]; then
             return 2
         fi

package/install/install-project.sh

@@ -4,6 +4,9 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 REPO_DIR="$(dirname "$SCRIPT_DIR")"
 
+# shellcheck source=_compat.sh
+source "$SCRIPT_DIR/_compat.sh"
+
 # Parse args
 PROJECT_DIR=""
 FORCE=false
@@ -66,8 +69,8 @@ check_copy_action() {
 
     # Upgrade mode → check if customized
     if $UPGRADE && [ -f "$MANIFEST" ]; then
-        manifest_hash=$(python3 -c 'import json,sys; d=json.load(open(sys.argv[1])); print(d.get("files",{}).get(sys.argv[2],""))' "$MANIFEST" "$source_path" 2>/dev/null || echo "")
-        installed_hash=$(shasum -a 256 "$target" 2>/dev/null | cut -d' ' -f1)
+        manifest_hash=$(_python -c 'import json,sys; d=json.load(open(sys.argv[1])); print(d.get("files",{}).get(sys.argv[2],""))' "$MANIFEST" "$source_path" 2>/dev/null || echo "")
+        installed_hash=$(_sha256 "$target" 2>/dev/null | cut -d' ' -f1)
 
         if [ -n "$manifest_hash" ] && [ "$installed_hash" = "$manifest_hash" ]; then
             # File matches original template → safe to upgrade
@@ -174,7 +177,7 @@ detect_orphans() {
 
     # Write manifest keys to a temp file for O(1) lookup via grep -Fxf
     manifest_file=$(mktemp)
-    python3 -c '
+    _python -c '
 import json, sys
 d = json.load(open(sys.argv[1]))
 for k in sorted(d.get("files", {}).keys()):
@@ -734,9 +737,9 @@ if [ -n "$TEMPLATE_NAME" ]; then
     echo "Applying template: $TEMPLATE_NAME"
 
     # Collect variables from template.json and prompt user
-    if command -v python3 &>/dev/null; then
+    if command -v python3 &>/dev/null || command -v python &>/dev/null; then
         # Extract variable names and defaults
-        _var_json=$(python3 -c '
+        _var_json=$(_python -c '
 import json, sys
 t = json.load(open(sys.argv[1]))
 vars = t.get("variables", {})

package/install/patch.sh

@@ -3,6 +3,9 @@ set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 REPO_DIR="$(dirname "$SCRIPT_DIR")"
+
+# shellcheck source=_compat.sh
+source "$SCRIPT_DIR/_compat.sh"
 PROJECT_DIR="${CODEXKIT_PROJECT_DIR:-$(pwd)}"
 PATCHES_DIR="$PROJECT_DIR/Codexkit_patches"
 MANIFEST_FILE="$PROJECT_DIR/.codex/.template-manifest.json"
@@ -45,7 +48,7 @@ require_project() {
 }
 
 slugify() {
-    python3 - "$1" <<'PY'
+    _python - "$1" <<'PY'
 import re
 import sys
 value = sys.argv[1].strip().lower()
@@ -56,7 +59,7 @@ PY
 }
 
 split_patch_input() {
-    python3 - "$1" <<'PY'
+    _python - "$1" <<'PY'
 import sys
 raw = sys.argv[1].strip()
 if " - " in raw:
@@ -69,7 +72,7 @@ PY
 }
 
 json_get() {
-    python3 - "$1" "$2" <<'PY'
+    _python - "$1" "$2" <<'PY'
 import json
 import sys
 data = json.load(open(sys.argv[1]))
@@ -90,7 +93,7 @@ PY
 }
 
 metadata_update_enabled() {
-    python3 - "$1" "$2" <<'PY'
+    _python - "$1" "$2" <<'PY'
 import json
 import sys
 path = sys.argv[1]
@@ -105,7 +108,7 @@ PY
 }
 
 manifest_hash_for() {
-    python3 - "$MANIFEST_FILE" "$1" <<'PY'
+    _python - "$MANIFEST_FILE" "$1" <<'PY'
 import json
 import sys
 data = json.load(open(sys.argv[1]))
@@ -114,7 +117,7 @@ PY
 }
 
 find_customized_pairs() {
-    python3 -c '
+    _python -c '
 import hashlib
 import json
 import os
@@ -287,7 +290,7 @@ cmd_create() {
 
     mv "$tmp_patch" "$patch_file"
 
-    python3 - "$metadata_file" "$slug" "$title" "$description" "$(project_version)" "$(date +%F)" "${target_files[@]}" <<'PY'
+    _python - "$metadata_file" "$slug" "$title" "$description" "$(project_version)" "$(date +%F)" "${target_files[@]}" <<'PY'
 import json
 import sys
 path, name, title, desc, version, created, *targets = sys.argv[1:]

package/install/plugin.sh

@@ -5,6 +5,9 @@
 # ──────────────────────────────────────────────────────────────
 set -euo pipefail
 
+# shellcheck source=_compat.sh
+source "$(cd "$(dirname "$0")" && pwd)/_compat.sh"
+
 CODEXKIT_HOME="${CODEXKIT_HOME:-$HOME/.codexkit}"
 PLUGINS_DIR="$CODEXKIT_HOME/plugins"
 REGISTRY_FILE="$CODEXKIT_HOME/registry.json"
@@ -79,7 +82,7 @@ _registry_add_entry() {
   local tmp
   tmp=$(mktemp)
   # Read current registry, build new one
-  python3 -c "
+  _python -c "
 import json, sys
 with open('$REGISTRY_FILE') as f:
     reg = json.load(f)
@@ -94,7 +97,7 @@ _registry_remove_entry() {
   local section="$1" name="$2"
   local tmp
   tmp=$(mktemp)
-  python3 -c "
+  _python -c "
 import json
 with open('$REGISTRY_FILE') as f:
     reg = json.load(f)

package/install/template.sh

@@ -5,6 +5,9 @@
 # ──────────────────────────────────────────────────────────────
 set -euo pipefail
 
+# shellcheck source=_compat.sh
+source "$(cd "$(dirname "$0")" && pwd)/_compat.sh"
+
 CODEXKIT_HOME="${CODEXKIT_HOME:-$HOME/.codexkit}"
 TEMPLATES_DIR="$CODEXKIT_HOME/templates"
 REGISTRY_FILE="$CODEXKIT_HOME/registry.json"
@@ -46,7 +49,7 @@ registry_add_template() {
       '.templates[$n] = {"version": $v, "source": $s, "installed": $d}' \
       "$REGISTRY_FILE" > "$tmp" && mv "$tmp" "$REGISTRY_FILE"
   else
-    python3 -c "
+    _python -c "
 import json
 with open('$REGISTRY_FILE') as f:
     reg = json.load(f)
@@ -65,7 +68,7 @@ registry_remove_template() {
     tmp=$(mktemp)
     jq --arg n "$name" 'del(.templates[$n])' "$REGISTRY_FILE" > "$tmp" && mv "$tmp" "$REGISTRY_FILE"
   else
-    python3 -c "
+    _python -c "
 import json
 with open('$REGISTRY_FILE') as f:
     reg = json.load(f)
@@ -93,7 +96,7 @@ get_variables() {
   if command -v jq &>/dev/null; then
     jq -r '.variables // {} | keys[]' "$manifest" 2>/dev/null
   else
-    python3 -c "
+    _python -c "
 import json
 with open('$manifest') as f:
     t = json.load(f)
@@ -109,7 +112,7 @@ get_variable_prop() {
   if command -v jq &>/dev/null; then
     jq -r ".variables[\"$var_name\"].$prop // empty" "$manifest" 2>/dev/null
   else
-    python3 -c "
+    _python -c "
 import json
 with open('$manifest') as f:
     t = json.load(f)

package/install/validate.sh

@@ -3,6 +3,9 @@ set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 REPO_DIR="$(dirname "$SCRIPT_DIR")"
+
+# shellcheck source=_compat.sh
+source "$SCRIPT_DIR/_compat.sh"
 PASS=0
 FAIL=0
 WARN=0
@@ -58,7 +61,7 @@ project_has_local_shared_inventory() {
 }
 
 path_sha256() {
-    shasum -a 256 "$1" 2>/dev/null | cut -d' ' -f1
+    _sha256 "$1" 2>/dev/null | cut -d' ' -f1
 }
 
 classify_local_shared_files() {
@@ -113,7 +116,7 @@ patch_inventory_counts() {
     }
 
     while IFS= read -r metadata; do
-        if enabled="$(python3 -c 'import json,sys; print(str(json.load(open(sys.argv[1])).get("enabled", True)).lower())' "$metadata" 2>/dev/null)"; then
+        if enabled="$(_python -c 'import json,sys; print(str(json.load(open(sys.argv[1])).get("enabled", True)).lower())' "$metadata" 2>/dev/null)"; then
             if [ "$enabled" = "true" ]; then
                 enabled_count=$((enabled_count + 1))
             else
@@ -559,7 +562,7 @@ if [ -d "$CODEXKIT_HOME/plugins" ]; then
             plugin_invalid=$((plugin_invalid + 1))
         else
             # Validate required fields
-            if python3 -c '
+            if _python -c '
 import json, sys
 p = json.load(open(sys.argv[1]))
 assert p.get("name"), "missing name"
@@ -595,7 +598,7 @@ if [ -d "$CODEXKIT_HOME/templates" ]; then
             check "Template '$tname' missing template.json" "fail"
             template_invalid=$((template_invalid + 1))
         else
-            if python3 -c '
+            if _python -c '
 import json, sys
 t = json.load(open(sys.argv[1]))
 assert t.get("name"), "missing name"
@@ -621,7 +624,7 @@ fi
 echo ""
 echo "Registry:"
 if [ -f "$CODEXKIT_HOME/registry.json" ]; then
-    if python3 -c '
+    if _python -c '
 import json, sys
 r = json.load(open(sys.argv[1]))
 assert isinstance(r.get("plugins", {}), dict)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codexkit",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "Professional configuration kit for OpenAI Codex CLI",
   "license": "MIT",
   "keywords": [
@@ -11,7 +11,7 @@
     "installer"
   ],
   "bin": {
-    "codexkit": "bin/codexkit"
+    "codexkit": "bin/codexkit.js"
   },
   "files": [
     "bin",