claude-copilot: Command for Claude Code

Setup Project

Install the complete Claude + Codex reference through the canonical cc transaction. Never manually copy framework files. The transaction installs executable .claude/hooks/copilot-hook.sh, registers supported hook events and records the shim in copilot.lock.json. Verification rejects a missing, non-executable, unregistered or unlocked shim.

The former partial minimal / quick start profile is retired. If requested, explain complete setup preserves memory and project-authored files and ask whether to continue; a decline stops without mutation. Repair existing minimal installs through this transaction.

Solo and organization setups

Without configured or inherited organization settings, solo setup needs no sign-in, layer manifest or signed pins. Layers report not-configured; personal/local content and full hook wiring still install. When an organization is configured, all organization checks apply: broken or signed-out configurations block.

Projects must be inside projects.roots. If outside, ask the person to confirm a folder, run cc config add projects.roots "<absolute folder>" and retry. Prefer the project or parent folder, never $HOME.

0. Verify the local CLI prerequisites

Both Copilot CLIs must be ready. The cc-owned prerequisite fact rejects macOS' unrelated C compiler and names machine setup as recovery. Never plan or mutate on failed prerequisites.

1. Build and inspect the exact plan

Run from the project root. Planning is read-only; shell exit removes the temporary request.

set -eu
CC_BIN=""
for CANDIDATE in "$(command -v cc 2>/dev/null || true)" "$HOME/.local/bin/cc"; do
  if [ -n "$CANDIDATE" ] && [ -x "$CANDIDATE" ] && "$CANDIDATE" --version 2>/dev/null | grep -q '^cc version'; then
    CC_BIN="$CANDIDATE"
    break
  fi
done
if [ -z "$CC_BIN" ] || ! command -v tc >/dev/null 2>&1; then
  echo "Claude Copilot machine setup is required: the Copilot cc and tc CLIs must both be available. Open ~/.claude/copilot, run /setup, open a fresh shell, then retry." >&2
  exit 3
fi
PROJECT_ROOT="$(git rev-parse --show-toplevel)"
REQUEST_FILE="$(mktemp -t cc-project-request.XXXXXX)"
trap 'rm -f "$REQUEST_FILE"' EXIT
chmod 600 "$REQUEST_FILE"
"$CC_BIN" reconcile request --project "$PROJECT_ROOT" --output "$REQUEST_FILE"
"$CC_BIN" reconcile plan --request "$REQUEST_FILE" --json