https://github.com/zakj/stacks
Semantic search for project documentation
https://github.com/zakj/stacks
Last synced: 2 months ago
JSON representation
Semantic search for project documentation
- Host: GitHub
- URL: https://github.com/zakj/stacks
- Owner: zakj
- Created: 2026-04-08T03:58:02.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-08T05:21:12.000Z (2 months ago)
- Last Synced: 2026-04-08T07:15:11.409Z (2 months ago)
- Language: Rust
- Size: 44.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Stacks
Semantic search for project documentation. Index your markdown docs,
search by intent, get the chunks that matter.
## Build
Requires Rust (stable). SQLite and the embedding model are bundled —
no external dependencies.
```
cargo build --release
```
The binary is at `target/release/stacks`. On first run, the embedding
model (~30MB) is downloaded and cached locally.
## Contributing
Run `mise run check` before committing. This runs formatting, linting,
and tests in parallel.
## Usage
Run any command from anywhere in your project. Stacks finds the repo
root, indexes all `**/*.md` files (respecting `.gitignore`), and
keeps the index fresh automatically.
```
stacks search how do list views work # semantic search
stacks search "filter pipeline" -d # with full content
stacks show a3f2 # read a section by slug
stacks index # browse the heading tree
```
### Agent integration
```
stacks prime --install claude
```
Adds a SessionStart hook so Claude Code agents get usage instructions
on every session. See [DESIGN.md](DESIGN.md) for architecture and
[PATTERNS.md](PATTERNS.md) for code conventions.