TrigramCodeAtlas (tca) is a command-line tool written in Go that indexes codebases using trigrams, making them AI-ready for tools like LLMs (e.g., Grok, Claude). It's built for developers who want to automate workflows across multi-language projects, inspired by Yacine's vision of AI-driven productivity.
- Indexes source files (
.go,.js,.ts, etc.) into a JSON atlas (atlas.json) with trigrams. - Ignores binary files, hidden dirs (
.git), and dependency dirs (node_modules). - Supports custom exclusions via
.tcaignore(like.gitignore). - Fast, concurrent file scanning with Go goroutines.
- Prerequisites: Go 1.23+ (e.g.,
brew install goon macOS). - Clone & Build:
git clone https://github.com/willworth/trigram-code-atlas.git cd trigram-code-atlas go build - Run: Use
./tcaorgo run main.go.
tca build <dir>: Indexes the directory into atlas.json.--verbose: Show detailed logs.--force: Overwrite existing atlas.json.- Example:
tca build ./myrepo --verbose --force
tca search <query>: (Planned) Search the atlas for trigrams matching<query>.tca update <dir>: (Planned) Update an existing atlas with changes.
# Index a repo
tca build ./testrepo --force
# Output: atlas.json with trigram-indexed filesAdd patterns to .tcaignore in your repo root to exclude files:
*.txt
dist/
- MVP Completion: Fix flag parsing for build, implement search and update.
- Enhancements: Live progress bar during indexing, regex search, MCP server integration.
- Download the binary for your OS from Releases.
- Move to a PATH dir:
- macOS/Linux:
sudo mv tca-darwin-arm64 /usr/local/bin/tca - Windows: Move
tca-windows-amd64.exetoC:\Program Files\tcaand add to PATH.
- macOS/Linux:
- Run:
tca build ./myrepo
- Install Go: golang.org
- Run:
go install github.com/willworth/trigram-code-atlas@v0.1.0 Ensure ~/go/bin is in your PATH: bash echo 'export PATH="$HOME/go/bin:$PATH"' >> ~/.zshrc source ~/.zshrc Run: tca build ./myrepo
Fork, tweak, PR—let's make it better! See DEVREADME.md for dev details.
MIT.