@mcgrapeng/ccg 3.1.0

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@mcgrapeng/ccg",
+  "version": "3.1.0",
+  "description": "Code Divergence Detector for Claude Code — runs Codex + Gemini in parallel on the same diff and surfaces where they disagree.",
+  "keywords": [
+    "claude-code",
+    "code-review",
+    "codex",
+    "gemini",
+    "ai",
+    "slash-command",
+    "cli",
+    "divergence",
+    "diff"
+  ],
+  "homepage": "https://github.com/mcgrapeng/ccg#readme",
+  "bugs": {
+    "url": "https://github.com/mcgrapeng/ccg/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mcgrapeng/ccg.git"
+  },
+  "license": "MIT",
+  "author": "mcgrapeng",
+  "type": "commonjs",
+  "engines": {
+    "node": ">=16"
+  },
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "bin": {
+    "ccg": "bin/ccg.js"
+  },
+  "main": "bin/ccg.js",
+  "files": [
+    "bin/",
+    "ccg.sh",
+    "ccg.md",
+    "scripts/",
+    "LICENSE",
+    "README.md",
+    "README.zh-CN.md",
+    "README.ja.md",
+    "README.ko.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "test": "bash tests/test_ccg.sh",
+    "lint:sh": "shellcheck ccg.sh scripts/install.sh || true"
+  }
+}

package/scripts/curl-install.sh

@@ -0,0 +1,97 @@
+#!/usr/bin/env bash
+# curl-install.sh — one-line remote installer for /ccg.
+#
+# Usage:
+#   curl -fsSL https://raw.githubusercontent.com/mcgrapeng/ccg/main/scripts/curl-install.sh | bash
+#   curl -fsSL https://raw.githubusercontent.com/mcgrapeng/ccg/main/scripts/curl-install.sh | bash -s -- --version v3.0.0
+#
+# What it does:
+#   1. Downloads the requested release tarball from GitHub Releases (default: latest)
+#   2. Extracts ccg.sh + ccg.md into ~/.claude/commands/
+#   3. Runs preflight checks (Codex / Gemini / API key)
+#
+# No npm / Node.js required. Just bash + curl + tar.
+set -eu
+
+REPO="${CCG_REPO_OVERRIDE:-mcgrapeng/ccg}"
+TAG="${CCG_VERSION:-latest}"
+TARGET_DIR="${HOME}/.claude/commands"
+TMPDIR="$(mktemp -d -t ccg-install.XXXXXXXX)"
+cleanup() { rm -rf "$TMPDIR"; }
+trap cleanup EXIT
+
+# parse flags
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --version) TAG="$2"; shift 2 ;;
+    --version=*) TAG="${1#*=}"; shift ;;
+    -h|--help)
+      cat <<EOF
+Usage: install.sh [--version <tag>]
+
+Installs the /ccg slash command into ~/.claude/commands/ from GitHub Releases.
+
+Options:
+  --version <tag>    Install a specific release (default: latest)
+                     Example: --version v3.0.0
+
+Environment:
+  CCG_REPO_OVERRIDE  Override repo (default: mcgrapeng/ccg)
+EOF
+      exit 0 ;;
+    *) echo "Unknown flag: $1" >&2; exit 2 ;;
+  esac
+done
+
+# Resolve "latest" → actual tag via GitHub API (no auth required for public repos)
+if [ "$TAG" = "latest" ]; then
+  echo "→ Resolving latest release of $REPO ..."
+  if command -v jq >/dev/null 2>&1; then
+    TAG=$(curl -fsSL "https://api.github.com/repos/$REPO/releases/latest" | jq -r .tag_name)
+  else
+    TAG=$(curl -fsSL "https://api.github.com/repos/$REPO/releases/latest" \
+      | grep -E '"tag_name"' | head -1 | sed -E 's/.*"tag_name":[[:space:]]*"([^"]+)".*/\1/')
+  fi
+  [ -n "$TAG" ] && [ "$TAG" != "null" ] || { echo "FATAL: could not resolve latest release tag" >&2; exit 2; }
+fi
+echo "→ Installing $REPO@$TAG"
+
+TARBALL_URL="https://github.com/$REPO/archive/refs/tags/$TAG.tar.gz"
+ARCHIVE="$TMPDIR/ccg.tar.gz"
+
+echo "→ Downloading $TARBALL_URL"
+curl -fsSL -o "$ARCHIVE" "$TARBALL_URL" || { echo "FATAL: download failed" >&2; exit 2; }
+
+echo "→ Extracting"
+tar -xzf "$ARCHIVE" -C "$TMPDIR"
+SRC_DIR=$(find "$TMPDIR" -maxdepth 1 -type d -name 'ccg-*' | head -1)
+[ -d "$SRC_DIR" ] || { echo "FATAL: extracted dir not found" >&2; exit 2; }
+
+[ -r "$SRC_DIR/ccg.sh" ] || { echo "FATAL: ccg.sh missing in archive" >&2; exit 2; }
+[ -r "$SRC_DIR/ccg.md" ] || { echo "FATAL: ccg.md missing in archive" >&2; exit 2; }
+
+echo "→ Installing to $TARGET_DIR"
+mkdir -p "$TARGET_DIR"
+install -m 0755 "$SRC_DIR/ccg.sh" "$TARGET_DIR/ccg.sh"
+install -m 0644 "$SRC_DIR/ccg.md" "$TARGET_DIR/ccg.md"
+echo "  ✓ $TARGET_DIR/ccg.sh"
+echo "  ✓ $TARGET_DIR/ccg.md"
+
+echo
+echo "→ Preflight checks:"
+. "$TARGET_DIR/ccg.sh"
+out=$(ccg_preflight)
+echo "$out" | sed 's/^/  /'
+
+if echo "$out" | grep -q "CCG_PREFLIGHT_CODEX=missing"; then
+  echo "  ⚠ install: npm i -g @openai/codex"
+fi
+if echo "$out" | grep -q "CCG_PREFLIGHT_GEMINI=missing"; then
+  echo "  ⚠ install: npm i -g @google/gemini-cli"
+fi
+if echo "$out" | grep -q "CCG_PREFLIGHT_GEMINI=no-api-key"; then
+  echo "  ⚠ add to ~/.zshenv: export GEMINI_API_KEY=<your-key>"
+fi
+
+echo
+echo "✓ Installed @ $TAG. Open Claude Code and type: /ccg"

package/scripts/install.sh

@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+# install.sh — install /ccg into ~/.claude/commands for Claude Code.
+# Idempotent; safe to re-run for upgrades. Pass --dry-run to preview.
+set -eu
+
+DRY=0
+case "${1:-}" in
+  --dry-run|-n) DRY=1 ;;
+  --help|-h)
+    cat <<EOF
+Usage: $0 [--dry-run]
+Installs ccg.md + ccg.sh into ~/.claude/commands/ so /ccg becomes available
+in Claude Code. Also runs preflight checks for Codex CLI / Gemini CLI / API key.
+EOF
+    exit 0 ;;
+esac
+
+HERE="$(cd "$(dirname "$0")/.." && pwd)"
+CCG_SH="$HERE/ccg.sh"
+CCG_MD="$HERE/ccg.md"
+TARGET_DIR="${HOME}/.claude/commands"
+
+[ -r "$CCG_SH" ] || { echo "FATAL: $CCG_SH not found"; exit 2; }
+[ -r "$CCG_MD" ] || { echo "FATAL: $CCG_MD not found"; exit 2; }
+
+echo "→ Installing /ccg to: $TARGET_DIR"
+
+if [ "$DRY" = "0" ]; then
+  mkdir -p "$TARGET_DIR"
+  install -m 0755 "$CCG_SH" "$TARGET_DIR/ccg.sh"
+  install -m 0644 "$CCG_MD" "$TARGET_DIR/ccg.md"
+  echo "  ✓ wrote $TARGET_DIR/ccg.sh ($(wc -l <"$CCG_SH" | tr -d ' ') lines)"
+  echo "  ✓ wrote $TARGET_DIR/ccg.md"
+else
+  echo "  [dry-run] would write: $TARGET_DIR/{ccg.sh,ccg.md}"
+fi
+
+echo
+echo "→ Preflight checks:"
+. "$CCG_SH"
+out=$(ccg_preflight)
+echo "$out" | sed 's/^/  /'
+
+if echo "$out" | grep -q "CCG_PREFLIGHT_CODEX=missing"; then
+  echo "  ⚠ install: npm i -g @openai/codex"
+fi
+if echo "$out" | grep -q "CCG_PREFLIGHT_GEMINI=missing"; then
+  echo "  ⚠ install: npm i -g @google/gemini-cli"
+fi
+if echo "$out" | grep -q "CCG_PREFLIGHT_GEMINI=no-api-key"; then
+  echo "  ⚠ add to ~/.zshenv: export GEMINI_API_KEY=<your-key>"
+fi
+
+echo
+echo "→ Done. Open a new Claude Code session and type: /ccg <your task>"