Not in the top 1,000 by GitHub stars

faugustdev/git-context-controller

Structured context management framework for LLM agents. Implements Git-like operations (COMMIT, BRANCH, MERGE) to manage long-horizon agent memory.

History

Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.

View weekly changes

SKILL.md

Week of Nov 2, 2026 · +0 / −0 lines

Before Network or broad shell → After Network or broad shell

80b7fa5627a2 → 80b7fa5627a2

Compare on GitHub

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Network or broad shell

First observation → 80b7fa5627a2

No earlier version was observed for comparison.

Compare on GitHub

View on GitHubAdd to my skills

Verified commit 80b7fa5627a200bea2487a95b3d3387a618d5083

66GitHub stars
2stars in 7 days
1skill in this repository
0commits in 30 days

Heat

2.4
  • Star growth, last 7 daysNot available
  • Star growth, last 24 hoursNot available
  • Rank movement, last 7 daysNot available
  • Commits, last 30 daysNot available
  • Accounts asking about it through MCP, last 7 daysNot available
  • Hot votes this weekNot available

Heat never changes the order by stars, and sponsorship never touches it. How heat works

Stars over time

Oct 25, 2026Nov 2, 202666

30-day change not yet available: not enough history.

Individual skills in this repository

How it works

gcc

When your agent uses it

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'.

What it loads into context

Frontmatter

99 tokens

Always available to the agent

SKILL.md

2,082 tokens

When the skill is activated

Reference documents

4,760 tokens

Loaded on request

Token counts are estimates. Scripts run separately; they are not counted as reference context.

The playbook

  1. Overview
  2. Initialization
  3. index.yaml Format
  4. Scripts
  5. Commands
  6. Cross-Session Recovery
  7. aiyoucli Integration
  8. Natural Language Mapping

Scripts executed separately

  • scripts/gcc_bridge.sh
  • scripts/gcc_cleanup.sh
  • scripts/gcc_commit.sh
  • scripts/gcc_context.sh
  • scripts/gcc_init.sh

Files

  • .gitignoreasset212 bytes
  • CONTRIBUTING.mddoc2,274 bytes
  • LICENSEasset1,092 bytes
  • README.mddoc7,186 bytes
  • SKILL.mdcore8,031 bytes
  • SKILL.mdcore8,031 bytes
  • SKILL.mdcore8,031 bytes
  • SKILL.mdcore8,031 bytes
  • SKILL.mdcore8,031 bytes
  • SKILL.mdcore8,031 bytes
  • SKILL.mdcore8,031 bytes
  • SKILL.mdcore8,031 bytes
  • SKILL.mdcore8,031 bytes
  • SKILL.mdcore8,031 bytes
  • SKILL.mdcore8,031 bytes
  • examples/sample_session.mddoc4,416 bytes
  • references/file_formats.mddoc3,695 bytes
  • scripts/gcc_bridge.shruns3,966 bytes
  • scripts/gcc_cleanup.shruns4,963 bytes
  • scripts/gcc_commit.shruns3,584 bytes
  • scripts/gcc_context.shruns4,259 bytes
  • scripts/gcc_init.shruns2,580 bytes
Read SKILL.md

# Git Context Controller (GCC) v2

## Overview

GCC transforms agent memory from verbose markdown into a lean, git-backed index. Instead of duplicating what git already knows, GCC stores only **hash + intent + optional decision notes** (~50 tokens vs ~500 per entry). Full context is reconstructed on demand via `git show`.

Two modes:
- **git mode**: Real commits, lean `index.yaml`, worktree isolation, aiyoucli bridge
- **standalone mode**: Markdown fallback for projects without git (v1 compatible)

## Initialization

On first use, check if `.GCC/` exists. If not, run the init script:
View the complete source on GitHub

Skills included

  • gcc

Repository facts

License
MIT
Created
Feb 25, 2026
Last pushed
Jul 25, 2026
Forks
2
Open issues
0
Project activity
Slowing

Before you install

Network or broad shell

Automated signals, not a guarantee

Checked Nov 5, 2026

Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.

Show 10 notes
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
Show all 18 signals by file

CONTRIBUTING.md

  • Network accessline 16
    # Fork and clone the repository git clone https://github.com/<your-username>/git-context-controller.git
  • Network accessline 17
    git clone https://github.com/<your-username>/git-context-controller.git

README.md

  • Network accessline 3
    [![Release](https://img.shields.io/github/v/release/faugustdev/git-context-controller)](https://github.com/faugustdev/git-context-controller/releases)
  • Network accessline 4
    [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
  • Network accessline 5
    [![Skills.sh](https://img.shields.io/badge/skills.sh-compatible-blue)](https://skills.sh)
  • Network accessline 6
    [![Available on CodeGuilds](https://img.shields.io/badge/Available_on-CodeGuilds-6366f1)](https://codeguilds.dev/packages/git-context-controller)
  • Network accessline 7
    [![DOI](https://img.shields.io/badge/DOI-10.5281/zenodo.19475089-blue)](https://doi.org/10.5281/zenodo.19475089)
  • Network accessline 14
    > Based on the research paper: [Git Context Controller](https://arxiv.org/abs/2508.00031)
  • Network accessline 87
    git clone https://github.com/faugustdev/git-context-controller.git
  • Network accessline 235
    - **Paper**: [Git Context Controller: Structured Context Management for LLM Agents](https://arxiv.org/abs/2508.00031)
  • Network accessline 236
    - **Concept**: [Emergent Mind - GCC Topic](https://www.emergentmind.com/topics/git-context-controller-gcc)

scripts/gcc_bridge.sh

  • Executable scriptline 1
    #!/bin/bash

scripts/gcc_cleanup.sh

  • Executable scriptline 1
    #!/bin/bash
  • Dangerous shell operationline 163
    git worktree remove "$path" --force 2>/dev/null || rm -rf "$path"

scripts/gcc_commit.sh

  • Executable scriptline 1
    #!/bin/bash
  • Dangerous shell operationline 103
    rm -f "$ENTRY_FILE"

scripts/gcc_context.sh

  • Executable scriptline 1
    #!/bin/bash

scripts/gcc_init.sh

  • Executable scriptline 1
    #!/bin/bash

How the signals fit together

Facts from a static read of the files at the pinned commit. They describe what the code does, not why.

Signal confidence: 18 facts

Works with

Agent compatibility, from the files in this repository
AgentStatusEvidenceInstall to
Claude CodeCompatibleStandard SKILL.md SKILL.md.claude/skills/<skill-name>/
CodexCompatibleStandard SKILL.md SKILL.md.agents/skills/<skill-name>/
CursorCompatibleStandard SKILL.md SKILL.md.cursor/skills/<skill-name>/
Gemini CLICompatibleStandard SKILL.md SKILL.md.gemini/skills/<skill-name>/
GitHub CopilotCompatibleStandard SKILL.md SKILL.md.github/skills/<skill-name>/
OpenCodeCompatibleStandard SKILL.md SKILL.md.opencode/skills/<skill-name>/
  • Native The repository ships a manifest, folder or frontmatter field for this agent.
  • Compatible A standard SKILL.md that this agent can read.
  • Unknown No evidence either way.

Derived automatically from paths, manifests and frontmatter. Not tested on each agent.