v0.3.2

Changelog

• 7eb4382 fix: make generated outputs deterministic and normalize paths
• 96d3e43 fix: normalize ignore patterns cross-platform and use config for diff index path

v0.3.1

Changelog

• 6d0ecf9 feat: automate npm publish on tag push, bump to v0.3.1
• eaaaa20 fix: align npm OIDC publish with glin-profanity pattern
• 8eaa1c0 fix: guard dot-slash conversion for Go imports, prefer longest module match
• dd9c6bf fix: parse python relative import shorthand (#10)
• 5708dd5 fix: resolve Python dot-notation imports in dependency graph (#8)
• 6296032 fix: use npm OIDC trusted publisher instead of token

v0.3.0 — setup command, compact map, AI tool comparison

What's new

stacklit setup — one command to configure all AI tools

stacklit setup

Auto-detects Claude Code, Cursor, and Aider. Injects a ~250-token codebase map into each tool's config file, configures MCP server, installs git hook for auto-refresh.

stacklit derive — compact navigation map

Generates a ~250-token navigation map that replaces 3,000-8,000 tokens of agent exploration per session.

myapp | go | 14 modules | 8,420 lines
entry: cmd/api/main.go | test: go test ./...

modules:
  cmd/api/          entrypoint, routes, middleware
  internal/auth/    jwt, session | depends: store, config
  internal/store/   postgres | depended-by: auth, handler

COMPARISON.md

Published head-to-head comparison of every codebase context tool: Repomix, code2prompt, Aider repo-map, Codebase-Memory, Axon, and Stacklit with real token counts.

Install

npm i -g stacklit
cd your-project
stacklit setup

Full changelog

• feat: stacklit derive command — compact ~250-token navigation map
• feat: stacklit derive --inject claude|cursor|aider — inject into config files
• feat: stacklit setup — auto-detect and configure AI tools
• feat: stacklit setup claude|cursor|aider — configure specific tool
• docs: COMPARISON.md with real token measurements
• chore: npm bumped to v0.3.0

v0.2.0 — Tree-sitter parsers, 11 languages

What's new

Tree-sitter AST parsing replaces all regex parsers. Stacklit now uses a pure Go tree-sitter runtime for accurate extraction across 11 languages.

Language support

Language	Parser	Extracts
Go	stdlib AST	imports, exports, types, struct fields
TypeScript/JS	tree-sitter	imports, exports, classes, interfaces, types
Python	tree-sitter	imports, classes, methods, type hints, entrypoints
Rust	tree-sitter	use/mod/crate, pub items, traits, generics
Java	tree-sitter	imports, public classes, method signatures
C#	tree-sitter	using directives, public types, methods
Ruby	tree-sitter	require, classes, modules, methods
PHP	tree-sitter	namespace use, classes, traits, methods
Kotlin	tree-sitter	imports, classes, objects, functions
Swift	tree-sitter	imports, structs, classes, protocols
C/C++	tree-sitter	includes, functions, structs, typedefs

Other improvements

• list_modules MCP tool -- agents can now discover all modules
• MCP cache invalidation -- index reloads when stacklit.json changes on disk
• Table view search/filter input
• DEPENDENCIES.md replaces stacklit.mmd -- renders on GitHub
• Real-world examples: Express.js, FastAPI, Gin, Axum (see examples/)
• Demo GIF in README
• Node richness tiers in graph visualization
• HiDPI canvas rendering

Token efficiency (measured)

Project	Lines of code	Index tokens
Express.js	21,346	3,765
FastAPI	108,075	4,142
Gin	23,829	3,361
Axum	43,997	14,371

Install

npx stacklit init
go install github.com/glincker/stacklit/cmd/stacklit@v0.2.0

Or download a binary below.

v0.1.0 — Your codebase, in 1,500 tokens

First release of Stacklit — a zero-config Go CLI that generates a token-efficient codebase index for AI agents.

What it does

Run stacklit init on any repo. Get three files:

• stacklit.json — machine-readable codebase index (~1,500 tokens for a 500-file repo)
• stacklit.mmd — Mermaid dependency diagram (renders on GitHub)
• stacklit.html — interactive visual map with Graph, Tree, Table, and Flow views

Install

npx stacklit init                # npm
go install github.com/glincker/stacklit/cmd/stacklit@latest  # go

Or download a binary below for your platform.

Highlights

• Zero config, single binary, no runtime dependencies
• Go AST parser + regex parsers for TypeScript, Python, Rust, Java
• Monorepo detection (pnpm, npm, yarn, Go workspaces, Turborepo, Nx, Cargo)
• MCP server (stacklit serve) with 7 tools for AI agent integration
• Git activity heatmap + Merkle hash for incremental updates
• Polyrepo multi-repo scanning (--multi)
• 23ms to index itself, under 7s for 20k+ file repos

Links

• npm package
• Full documentation