Skip to content

faugustdev/git-context-controller

Git Context Controller (GCC) v2 — Lean agent memory backed by real git. Stores hash + intent + optional decision notes instead of verbose markdown. Auto-bridges to aiyoucli vector memory when available. Dual mode: git-backed (lean index.yaml) or standalone (markdown fallback). Triggers on /gcc commands or natural language like 'commit this progress', 'branch to try an alternative', 'merge results', 'recover context'.

FileKindSize
SKILL.mdskill md7.8 KB
examples/sample_session.mdmarkdown4.3 KB
references/file_formats.mdmarkdown3.6 KB
scripts/gcc_bridge.shexecutablescript3.9 KB
scripts/gcc_cleanup.shexecutablescript4.8 KB
scripts/gcc_commit.shexecutablescript3.5 KB
scripts/gcc_context.shexecutablescript4.2 KB
scripts/gcc_init.shexecutablescript2.5 KB

scripts/gcc_init.sh

View on GitHub
#!/bin/bash
# GCC v2 Initialization Script
# Detects git repo and creates appropriate structure (git mode or standalone)

set -e

GCC_DIR="${1:-.GCC}"
NOW=$(date -u +"%Y-%m-%dT%H:%M:%SZ")

if [ -d "$GCC_DIR" ]; then
  # Check if upgrading from v1
  if [ -f "$GCC_DIR/metadata.yaml" ] && ! [ -f "$GCC_DIR/index.yaml" ]; then
    echo "GCC v1 detected. Run with --upgrade to migrate to v2."
    if [ "$2" = "--upgrade" ]; then
      echo "Migrating to v2..."
      # Preserve v1 files as backup
      mkdir -p "$GCC_DIR/.v1-backup"
      cp "$GCC_DIR/metadata.yaml" "$GCC_DIR/.v1-backup/" 2>/dev/null || true
      cp "$GCC_DIR/commit.md" "$GCC_DIR/.v1-backup/" 2>/dev/null || true
      cp "$GCC_DIR/log.md" "$GCC_DIR/.v1-backup/" 2>/dev/null || true
      cp "$GCC_DIR/main.md" "$GCC_DIR/.v1-backup/" 2>/dev/null || true
    else
      exit 0
    fi
  elif [ -f "$GCC_DIR/index.yaml" ]; then
    echo "GCC v2 already initialized at $GCC_DIR"
    exit 0
  fi
fi

# Detect git
MODE="standalone"
if git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
  MODE="git"
  BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "main")
  LAST_HASH=$(git rev-parse --short HEAD 2>/dev/null || echo "none")
fi

mkdir -p "$GCC_DIR/branches"
mkdir -p "$GCC_DIR/worktrees"

# Create index.yaml — the single source of truth for v2
if [ "$MODE" = "git" ]; then
  cat > "$GCC_DIR/index.yaml" << EOF
version: 2
mode: git
created: "$NOW"
config:
  proactive_commits: true
  worktree_ttl: 24h
  bridge_to_aiyoucli: auto

current_branch: $BRANCH

timeline:
  - id: INIT
    hash: $LAST_HASH
    intent: "gcc initialized"
    branch: $BRANCH
    date: "$NOW"

worktrees: []

decisions: []
EOF
else
  cat > "$GCC_DIR/index.yaml" << EOF
version: 2
mode: standalone
created: "$NOW"
config:
  proactive_commits: true

current_branch: main

timeline:
  - id: INIT
    hash: null
    intent: "gcc initialized (standalone mode)"
    branch: main
    date: "$NOW"

decisions: []
EOF

  # Standalone mode also creates markdown fallback files
  cat > "$GCC_DIR/main.md" << 'MAINEOF'
# Project Roadmap

## Objectives
- [ ] (Define project objectives here)

## Milestones
(Milestones will be populated as commits are made)

## Active Branches
(No active branches)
MAINEOF

  cat > "$GCC_DIR/log.md" << 'LOGEOF'
# OTA Execution Log

> Most recent entries at the bottom. Keep last 50 entries max.

---
LOGEOF
fi

echo "GCC v2 initialized at $GCC_DIR/"
echo "  Mode: $MODE"
echo "  Index: $GCC_DIR/index.yaml"
if [ "$MODE" = "git" ]; then
  echo "  Branch: $BRANCH"
  echo "  Last commit: $LAST_HASH"
fi
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 464kUpdated Claude CodeCodexVerifiedInstall
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 464kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 318kUpdated Claude CodeCodexUnverifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 318kUpdated Claude CodeCodexUnverifiedInstall