# Stacklit

> Stacklit parses a repository with tree-sitter and writes stacklit.json (modules, exports, dependencies, hints), an interactive HTML map and an MCP server. MIT licensed, free, local only, no telemetry, one Go binary, deterministic output.

## Docs

- [Quickstart](https://stacklit.glinr.com/docs/quickstart/): Install Stacklit and generate a codebase index in one command.
- [How it works](https://stacklit.glinr.com/docs/how-it-works/): The Stacklit pipeline: scan, parse with tree-sitter, build modules and a dependency graph, render outputs.
- [Commands reference](https://stacklit.glinr.com/docs/commands/): Every stacklit command and flag: init, generate, view, diff, derive, export, setup, serve, query, check and more.
- [MCP tools](https://stacklit.glinr.com/docs/mcp/): The read-only tools the Stacklit MCP server exposes over the index and the symbol graph.
- [Assistants and setup](https://stacklit.glinr.com/docs/assistants/): Wire Claude Code, Cursor, Aider and other AI tools to a Stacklit index with one command.
- [Configuration](https://stacklit.glinr.com/docs/configuration/): The .stacklitrc.json keys and STACKLIT_ environment variables that control a Stacklit scan.
- [Sessions and hooks](https://stacklit.glinr.com/docs/sessions/): Session persistence and hooks for Stacklit. Coming with 0.5.0.
- [Languages](https://stacklit.glinr.com/docs/languages/): Which languages and formats Stacklit indexes and what it extracts from each.
- [Privacy](https://stacklit.glinr.com/docs/privacy/): Stacklit runs locally, has no telemetry and no account. What it reads, writes and sends.
- [FAQ](https://stacklit.glinr.com/docs/faq/): Answers on small repos, grep, dependency accuracy, unsupported languages and git hooks.
- [Index format](https://stacklit.glinr.com/docs/format/): How to read stacklit.json, and how Stacklit handles monorepos and several repos at once.
- [CI and troubleshooting](https://stacklit.glinr.com/docs/ci/): Keep the index fresh in CI with the GitHub Action or a hook, and fix common problems.
- [Benchmarks](https://stacklit.glinr.com/docs/benchmarks/): A deterministic token-cost proxy on six pinned repos and 58 tasks, with intervals, the methodology, the misses and the limitations.
- [Changelog](https://stacklit.glinr.com/docs/changelog/): Release history for Stacklit.

## More

- [Demos](https://stacklit.glinr.com/demos/): generated maps for gin, flask, hono, ripgrep, gson and rack
- [Source code](https://github.com/glincker/stacklit): MIT license
- [Security policy](https://github.com/glincker/stacklit/blob/master/.github/SECURITY.md)