graphify map folder

The problem

Large codebases are difficult to navigate mentally, and manual documentation for folder structures or architectural dependencies goes stale the moment you commit code.

What it does

• Scans a folder using tree-sitter to build a structural knowledge graph without using AI tokens.
• Generates a graph.json, a visual graph.html map, and a GRAPH_REPORT.md summary of "god nodes" and communities.
• Automatically handles visualization limits for large projects by adjusting node-count thresholds.
• Sets up Git hooks or file watchers to ensure the graph stays synchronized with code changes.
• Identifies performance bottlenecks like network drives and suggests local caching strategies.

Frameworks & tools

Requires Python 3.10+, Graphify (graphifyy), and works on macOS/Linux environments.

Why this beats prompting it yourself

Writing a prompt to "summarize this folder" usually results in a generic list that hits context limits. This skill uses a specialized local binary to extract deterministic relationships, ensuring you get a complete map of every function, class, and import without token costs or privacy leaks.

Use cases

• Onboarding to a legacy monolith by visualizing the most heavily coupled modules.
• Automating architectural documentation that updates itself on every git commit.
• Identifying "god objects" and high-complexity clusters before starting a refactor.
• Building a local index for other agents to use as a navigation RAG source.

Known limitations

Interactive HTML visualization may fail on extremely large graphs; Safari has known rendering issues with the output. Requires Graphify to be pre-installed on the system PATH.