MacroMan5/macromanatlas

4 stars · Last commit 2026-02-14

Claude Code plugin: automatic codebase index + per-module READMEs, auto-synced via hooks (repo map + context injection).

README preview

# MacroManAtlas

**Automatic codebase indexer for Claude Code** -- keep your AI pair-programmer oriented in any project, across every session.

## What It Does

- **Scans your repository** and discovers modules, packages, and top-level directories automatically based on project type (CMake, Cargo, Go modules, Node workspaces, and more).
- **Generates per-module READMEs** with file listings, tags, descriptions, dependencies, and public API summaries so Claude always knows what lives where.
- **Injects a compact summary** (`index.summary.md`, <4 KB) into Claude's context at session start -- no manual copy-paste required.
- **Auto-syncs the index** in the background whenever you create or edit files, using a debounced `claude -p` daemon with module-level locking.
- **Survives context compaction** by re-injecting the summary before the context window is compressed, so Claude never loses the map.

## Supported Project Types

| Priority | Type | Detection Signal |
|----------|------|-----------------|
| 1 | C/C++ CMake | `CMakeLists.txt` |
| 2 | Rust Cargo | `Cargo.toml` |
| 3 | Go | `go.mod` |
| 4 | Node.js / TypeScript | `package.json` (workspaces) |

View full repository on GitHub →