faugustdev/git-context-controller
gcc
UnverifiedGit 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'.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.8 KB |
| examples/sample_session.md | markdown | 4.3 KB |
| references/file_formats.md | markdown | 3.6 KB |
| scripts/gcc_bridge.shexecutable | script | 3.9 KB |
| scripts/gcc_cleanup.shexecutable | script | 4.8 KB |
| scripts/gcc_commit.shexecutable | script | 3.5 KB |
| scripts/gcc_context.shexecutable | script | 4.2 KB |
| scripts/gcc_init.shexecutable | script | 2.5 KB |
scripts/gcc_cleanup.sh
View on GitHub#!/bin/bash
# GCC v2 Cleanup — TTL-based worktree cleanup + index pruning
#
# Usage:
# gcc_cleanup.sh # interactive: list expired, ask before removing
# gcc_cleanup.sh --dry-run # show what would be cleaned
# gcc_cleanup.sh --force # clean without asking
# gcc_cleanup.sh --prune-index N # keep only last N timeline entries in index
set -e
GCC_DIR=".GCC"
INDEX="$GCC_DIR/index.yaml"
if [ ! -f "$INDEX" ]; then
echo "Error: GCC not initialized."
exit 1
fi
MODE=$(grep '^mode:' "$INDEX" | awk '{print $2}')
TTL_RAW=$(grep 'worktree_ttl:' "$INDEX" | awk '{print $2}' | tr -d '"')
# Parse TTL to seconds
ttl_to_seconds() {
local val="$1"
local num="${val%[hHdDwW]*}"
local unit="${val##*[0-9]}"
case "$unit" in
h|H) echo $((num * 3600)) ;;
d|D) echo $((num * 86400)) ;;
w|W) echo $((num * 604800)) ;;
*) echo $((num * 3600)) ;; # default hours
esac
}
TTL_SECS=$(ttl_to_seconds "${TTL_RAW:-24h}")
NOW_EPOCH=$(date +%s)
DRY_RUN=false
FORCE=false
case "${1:-}" in
--dry-run) DRY_RUN=true ;;
--force) FORCE=true ;;
--prune-index)
KEEP="${2:-50}"
echo "Pruning index to last $KEEP entries..."
# Count timeline entries
TOTAL=$(grep -c '^\s*- id:' "$INDEX" 2>/dev/null || echo "0")
if [ "$TOTAL" -le "$KEEP" ]; then
echo "Only $TOTAL entries, nothing to prune."
exit 0
fi
REMOVE=$((TOTAL - KEEP))
echo "Removing $REMOVE oldest entries (keeping $KEEP)."
# Create temp file with pruned timeline
# Keep everything before timeline:, then skip first $REMOVE entries
awk -v skip="$REMOVE" '
/^timeline:/ { in_timeline=1; print; skipped=0; next }
in_timeline && /^ - id:/ {
skipped++
if (skipped <= skip) { skipping=1; next }
skipping=0
}
in_timeline && skipping { next }
/^[a-z]/ && !/^ / { in_timeline=0 }
{ print }
' "$INDEX" > "$INDEX.tmp" && mv "$INDEX.tmp" "$INDEX"
echo "Done. Pruned $REMOVE entries."
exit 0
;;
"") ;;
*)
echo "Usage: gcc_cleanup.sh [--dry-run|--force|--prune-index N]"
exit 1
;;
esac
if [ "$MODE" != "git" ]; then
echo "Worktree cleanup only available in git mode."
echo "Use --prune-index to clean standalone index."
exit 0
fi
# List worktrees from index.yaml
echo "# GCC Worktree Cleanup"
echo "TTL: ${TTL_RAW:-24h} ($TTL_SECS seconds)"
echo "---"
EXPIRED=0
ACTIVE=0
# Parse worktrees section
awk '
/^worktrees:/ { in_wt=1; next }
/^[a-z]/ && !/^ / { in_wt=0 }
in_wt && /name:/ { name=$2 }
in_wt && /path:/ { path=$2 }
in_wt && /branch:/ { branch=$2 }
in_wt && /created:/ { created=$2; gsub(/"/, "", created) }
in_wt && /status:/ {
status=$2
if (status == "active") {
printf "%s|%s|%s|%s\n", name, path, branch, created
}
}
' "$INDEX" | while IFS='|' read -r name path branch created; do
[ -z "$name" ] && continue
# Calculate age
if [ "$(uname)" = "Darwin" ]; then
CREATED_EPOCH=$(date -j -f "%Y-%m-%dT%H:%M:%SZ" "$created" +%s 2>/dev/null || echo "0")
else
CREATED_EPOCH=$(date -d "$created" +%s 2>/dev/null || echo "0")
fi
AGE=$((NOW_EPOCH - CREATED_EPOCH))
AGE_HOURS=$((AGE / 3600))
if [ "$AGE" -gt "$TTL_SECS" ]; then
EXPIRED=$((EXPIRED + 1))
# Check for uncommitted changes in worktree
HAS_CHANGES=false
if [ -d "$path" ]; then
CHANGES=$(cd "$path" && git status --porcelain 2>/dev/null | head -5)
[ -n "$CHANGES" ] && HAS_CHANGES=true
fi
echo ""
echo "EXPIRED: $name (${AGE_HOURS}h old, TTL: ${TTL_RAW:-24h})"
echo " Path: $path"
echo " Branch: $branch"
if [ "$HAS_CHANGES" = true ]; then
echo " WARNING: Has uncommitted changes!"
echo "$CHANGES" | sed 's/^/ /'
if [ "$DRY_RUN" = true ]; then
echo " [dry-run] Would SKIP (has changes)"
continue
fi
if [ "$FORCE" = false ]; then
echo -n " Remove anyway? (y/N): "
read -r confirm
[ "$confirm" != "y" ] && echo " Skipped." && continue
else
echo " Force removing despite changes."
fi
else
if [ "$DRY_RUN" = true ]; then
echo " [dry-run] Would remove"
continue
fi
fi
# Remove worktree
if [ -d "$path" ]; then
git worktree remove "$path" --force 2>/dev/null || rm -rf "$path"
fi
# Update index: mark as expired (awk for cross-platform compat)
awk -v wt="$name" '
/name:/ && $2 == wt { found=1 }
found && /status: active/ { sub(/active/, "expired"); found=0 }
{ print }
' "$INDEX" > "$INDEX.tmp" && mv "$INDEX.tmp" "$INDEX"
echo " Removed."
else
ACTIVE=$((ACTIVE + 1))
echo "ACTIVE: $name (${AGE_HOURS}h old, TTL in $((($TTL_SECS - $AGE) / 3600))h)"
fi
done
# Also prune orphan git worktrees
echo ""
echo "---"
echo "Pruning orphan git worktrees..."
git worktree prune 2>/dev/null && echo "Done." || echo "No orphans found."
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 464k | Updated | Claude CodeCodex | Verified | Install |
| 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: 464k | Updated | Claude CodeCodex | Verified | Install |
| 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: 318k | Updated | Claude CodeCodex | Unverified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |