Skip to content

Releases: faugustdev/git-context-controller

v2.0.0 — Lean Git-Backed Memory

31 Mar 02:18
69192ac

Choose a tag to compare

What's New

GCC v2 replaces verbose markdown storage (~500 tokens/entry) with a lean index.yaml format (~50 tokens/entry) backed by real git commits. Context is reconstructed on demand via git show.

New Scripts

Script Purpose
gcc_commit.sh Real git commit + lean index entry
gcc_context.sh Reconstruct context from hashes
gcc_bridge.sh Feed commit data to aiyoucli vector memory
gcc_cleanup.sh TTL-based worktree cleanup + index pruning

Key Features

  • Dual mode: auto-detects git repo (lean index) or standalone (v1-compatible markdown)
  • ~10x token savings: 50 tokens/entry vs 500 in v1
  • Context reconstruction: --summary, --last N, --hash, --decisions, --full
  • aiyoucli bridge: auto-feeds commit data to vector memory when available
  • Worktree TTL: automatic cleanup of expired worktrees

Breaking Changes

  • index.yaml replaces commit.md, log.md, metadata.yaml as primary storage
  • gcc_init.sh creates v2 structure by default
  • Use gcc_init.sh --upgrade to migrate from v1 (backs up old files)

Migration from v1

cd your-project
scripts/gcc_init.sh --upgrade

This backs up v1 files to .GCC/.v1-backup/ and creates the new index.yaml.

v1.0.0 — Initial Release

25 Feb 21:31

Choose a tag to compare

Git Context Controller (GCC) v1.0.0

Structured context management framework for LLM agents. Implements Git-like operations to manage long-horizon agent memory as a persistent, versioned file system.

Features

  • COMMIT — Persist milestones with full technical reasoning context
  • BRANCH — Create isolated workspaces for exploring alternative approaches
  • MERGE — Synthesize completed branches back into the main flow
  • CONTEXT — Retrieve historical memory at summary, trace, metadata, or full resolution

Includes

  • Claude Code skill (SKILL.md) ready for installation
  • Initialization script (scripts/gcc_init.sh)
  • Complete file format specifications (references/file_formats.md)
  • Example session walkthrough (examples/sample_session.md)

Installation

# Via skills.sh
npx skills add faugustdev/git-context-controller

# Manual
cp -r gcc/ your-project/.claude/skills/gcc/

Links