stacklit-navigator

Category: Development & Coding | Uploader: glincker | Downloads: 0 | Version: v1.0（Latest）

Use stacklit.json to navigate codebases without burning tokens on file exploration

Changelog: Source: GitHub https://github.com/glincker/stacklit

Directory Structure

Current level: tree/master/

📁 .github/
- 📁 workflows/
  - 📄 ci.yml 348 B
  - 📄 release.yml 1.2 KB
  - 📄 stacklit-index.yml 277 B
📁 action/
- 📄 action.yml 819 B
📁 assets/
- 📄 embed.go 132 B
- 📄 lang-icons.js 20.6 KB
- 📄 template.html 73.3 KB
📁 cmd/
- 📁 stacklit/
  - 📄 main.go 201 B
📁 docs/
- 📁 superpowers/
  - 📁 plans/
    
    📄 2026-04-12-growth-package.md 22.0 KB
  - 📁 specs/
    
    📄 2026-04-12-growth-package-design.md 7.1 KB
📁 examples/
- 📁 axum/
  - 📄 DEPENDENCIES.md 6.8 KB
  - 📄 stacklit.json 48.9 KB
- 📁 express/
  - 📄 DEPENDENCIES.md 3.0 KB
  - 📄 stacklit.json 13.1 KB
- 📁 fastapi/
  - 📄 DEPENDENCIES.md 1.6 KB
  - 📄 stacklit.json 15.2 KB
- 📁 gin/
  - 📄 DEPENDENCIES.md 762 B
  - 📄 stacklit.json 12.6 KB
- 📄 README.md 1.1 KB
📁 internal/
- 📁 cli/
  - 📄 derive.go 2.0 KB
  - 📄 diff.go 1.9 KB
  - 📄 generate.go 494 B
  - 📄 init.go 1.8 KB
  - 📄 root.go 593 B
  - 📄 serve.go 891 B
  - 📄 setup.go 3.9 KB
  - 📄 view.go 845 B
- 📁 config/
  - 📄 config.go 2.7 KB
  - 📄 config_test.go 2.2 KB
- 📁 derive/
  - 📄 derive.go 5.3 KB
- 📁 detect/
  - 📄 envvars.go 3.5 KB
  - 📄 framework_patterns.go 5.6 KB
  - 📄 framework_patterns_test.go 2.7 KB
  - 📄 frameworks.go 4.1 KB
  - 📄 frameworks_test.go 2.9 KB
- 📁 engine/
  - 📄 engine.go 15.5 KB
- 📁 git/
  - 📄 activity.go 3.1 KB
  - 📄 activity_test.go 4.1 KB
  - 📄 hooks.go 1.3 KB
  - 📄 merkle.go 1.4 KB
- 📁 graph/
  - 📄 graph.go 10.4 KB
  - 📄 graph_test.go 9.0 KB
- 📁 mcp/
  - 📄 server.go 6.9 KB
- 📁 monorepo/
  - 📄 detect.go 12.6 KB
  - 📄 detect_test.go 3.5 KB
- 📁 parser/
  - 📄 generic.go 2.4 KB
  - 📄 generic_test.go 2.5 KB
  - 📄 golang.go 4.8 KB
  - 📄 golang_test.go 4.0 KB
  - 📄 java_test.go 2.2 KB
  - 📄 parser.go 2.4 KB
  - 📄 python_test.go 3.3 KB
  - 📄 rust_test.go 2.4 KB
  - 📄 treesitter.go 3.5 KB
  - 📄 ts_c.go 6.0 KB
  - 📄 ts_csharp.go 4.0 KB
  - 📄 ts_java.go 4.1 KB
  - 📄 ts_kotlin.go 4.5 KB
  - 📄 ts_php.go 3.6 KB
  - 📄 ts_python.go 5.9 KB
  - 📄 ts_ruby.go 4.4 KB
  - 📄 ts_rust.go 5.6 KB
  - 📄 ts_swift.go 5.4 KB
  - 📄 ts_typescript.go 9.9 KB
  - 📄 typescript_test.go 3.3 KB
- 📁 renderer/
  - 📄 html.go 743 B
  - 📄 json.go 718 B
  - 📄 json_test.go 1.8 KB
  - 📄 mermaid.go 3.9 KB
  - 📄 mermaid_test.go 2.9 KB
  - 📄 stable.go 1002 B
- 📁 schema/
  - 📄 schema.go 4.4 KB
- 📁 setup/
  - 📄 setup.go 3.8 KB
- 📁 summary/
  - 📄 ai.go 3.6 KB
- 📁 walker/
  - 📄 walker.go 3.6 KB
  - 📄 walker_test.go 3.5 KB
📁 npm/
- 📁 bin/
  - 📄 stacklit.js 467 B
- 📄 .gitignore 56 B
- 📄 install.js 3.0 KB
- 📄 package.json 1.0 KB
- 📄 README.md 2.9 KB
📁 testdata/
- 📁 go-project/
  - 📁 internal/
    
    📄 handler.go 176 B
    
    📄 handler_test.go 17 B
  - 📄 .gitignore 22 B
  - 📄 image.png 8 B
  - 📄 main.go 152 B
  - 📄 README.md 7 B
- 📁 java-project/
  - 📁 src/
    
    📄 Main.java 314 B
- 📁 monorepo/
  - 📁 apps/
    
    📁 web/
    
    📁 src/
    
    📄 index.ts 39 B
    
    📄 package.json 22 B
  - 📁 packages/
    
    📁 api/
    
    📁 src/
    
    📄 index.ts 25 B
    
    📄 package.json 22 B
    
    📁 shared/
    
    📁 src/
    
    📄 index.ts 28 B
    
    📄 package.json 25 B
  - 📄 package.json 26 B
  - 📄 pnpm-workspace.yaml 40 B
  - 📄 turbo.json 17 B
- 📁 python-project/
  - 📄 app.py 308 B
- 📁 rust-project/
  - 📁 src/
    
    📄 main.rs 313 B
- 📁 ts-project/
  - 📁 src/
    
    📄 index.ts 245 B
    
    📄 router.ts 229 B
  - 📄 package.json 70 B
📄 .gitignore 269 B
📄 .goreleaser.yml 718 B
📄 COMPARISON.md 6.3 KB
📄 demo.gif 112.8 KB
📄 demo.tape 743 B
📄 DEPENDENCIES.md 2.6 KB
📄 go.mod 657 B
📄 go.sum 3.8 KB
📄 LICENSE 1.0 KB
📄 Makefile 388 B
📄 README.md 10.9 KB
📄 SKILL.md 2.6 KB
📄 stacklit-og.png 582.0 KB
📄 stacklit.json 18.5 KB
📄 USAGE.md 7.4 KB

SKILL.md

---
name: stacklit-navigator
description: Use stacklit.json to navigate codebases without burning tokens on file exploration
---

## When to use

At the start of any session on a repo that has `stacklit.json` at the root. Read it before you read any source files.

## Reading the index

```bash
# Check if index exists
cat stacklit.json | head -5
```

The file has these sections:

- `project` -- repo name, type (single/monorepo), workspaces
- `tech` -- primary language, language breakdown, frameworks
- `modules` -- the map: each module's purpose, files, exports, dependencies, activity level
- `dependencies.edges` -- import relationships between modules
- `dependencies.most_depended` -- the modules everything depends on (touch carefully)
- `hints` -- where to add features, how to run tests, env vars to set

## How to use each section

**Finding code:** Look up the module in `modules` by name. The `purpose` field tells you what it does. The `file_list` tells you exactly which files to read. Skip everything else.

**Understanding structure:** Check `depends_on` and `depended_by` to see how a module connects to the rest. If you need to change something in `src/auth`, check `depended_by` to know what might break.

**Knowing what changed recently:** The `activity` field (high/medium/low) tells you how actively a module is being worked on. `git.hot_files` lists the most-changed files in the last 90 days.

**Adding a feature:** Read `hints.add_feature` first. It tells you which directory to create files in and which files to update.

**Running tests:** Check `hints.test_command`.

## What not to do

- Do not `grep` across all files when `modules` tells you which module to look in
- Do not read entire directories to understand the codebase
- Do not re-explore the same repo every session. The index persists across sessions.
- Do not ignore `most_depended` when planning changes. Those modules have the widest blast radius.

## Using the MCP server

If `stacklit serve` is running as an MCP server, use these tools instead of reading the file:

- `get_overview` -- full project summary (call this first)
- `get_module("src/auth")` -- detailed info on one module
- `find_module("auth")` -- search modules by name
- `get_dependencies("src/auth")` -- what it imports and what imports it
- `get_hot_files` -- most-changed files (90 days)
- `get_hints` -- conventions, test commands, env vars

One `get_overview` call replaces reading 5-10 files to build context.

## Keeping the index fresh

If you have made significant structural changes (new modules, moved files, changed dependencies):

```bash
stacklit generate
```

Use `stacklit diff` to check if the index is stale before regenerating.

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

stacklit-navigator

Directory Structure

SKILL.md

Report

Notice