Show HN: AI-docs (Git-based workflow to manage AI-generated memory files)

3 trknhr 1 7/7/2025, 1:54:18 PM github.com ↗

Comments (1)

trknhr · 16m ago
This is a CLI tool I’ve been building to manage AI-generated memory files like CLAUDE.md, GEMINI.md, .cursor/rules/, and others, without polluting your main Git branch.

Over time I found myself relying on various “memory” files to track prompts, embeddings, scratch notes, context rules, and other AI agent state. These were important, but messy. I wanted a way to isolate them into a separate Git branch and still keep them versioned, shareable, and editable.

So I wrote ai-docs, a Go-based CLI that creates a dedicated orphan branch (e.g., @ai-docs/your-name) and uses git worktree to mount it locally at .ai-docs/. You can push, pull, and sync AI memory files independently of your main codebase. It supports multiple agents like Claude, Gemini, Cursor, and Cline, and is configurable via YAML/JSON/TOML.

It's not a Git plugin or shell script wrapper—just a standalone binary with minimal dependencies that tries to stay out of your way. The whole point is to give you a clean, reversible way to manage machine-generated AI context as first-class citizens in your project, without turning your repo into a junk drawer.