Releases: shamim0902/locus
Releases · shamim0902/locus
v0.2.0
Changelog
- 1e0c39f feat: Ollama semantic embeddings, IDF-weighted search, embedding cache
- ff475b7 feat: add locus init, make mine default to current directory
- 017b445 feat: web dashboard with analytics, reports, and project management
- dd68fb4 refactor: polished CLI with spinners, colors, and guided MCP onboarding
- 07c1957 sync formula SHA256 with tap
v0.1.0
Locus v0.1.0 — Initial Release
AI memory engine. Store everything, find anything. Single binary, single SQLite file, zero runtime dependencies.
Install
# Homebrew (macOS / Linux)
brew tap shamim0902/tap
brew install locus
# Go install
go install github.com/shamim0902/locus/cmd/locus@latest
# Build from source
git clone https://github.com/shamim0902/locus.git && cd locus && make buildFeatures
- Hybrid search — BM25 (FTS5) + TF-IDF cosine + Reciprocal Rank Fusion
- Incremental mining — SHA-256 hash ledger, goroutine pool, skips unchanged files
- Sentence-boundary chunking — no mid-sentence cuts, 1-sentence overlap
- 3-level summaries — keywords, one-sentence, two-sentence (rule-based, no LLM)
- Budget-aware context packing — set token limit, get optimal context with time-decay
- Temporal knowledge graph — entities, triples, validity windows, invalidation, timeline
- 19 MCP tools — search, memory CRUD, KG, navigation, agent diary, status
- REST API — 11 endpoints on stdlib net/http
- CLI — 9 commands via cobra
- Single SQLite file — 10 tables, 12 indexes, 3 FTS triggers, WAL mode
- Cross-platform — macOS, Linux, Windows (ARM64 + x86)
Quick Start
locus mine ~/projects/myapp --wing myapp
locus search "database migration strategy"
locus kg add "Team" "decided" "PostgreSQL"
locus wake-up --budget 300
locus serve --port 8765Stats
- 4,182 lines of Go
- 30 files
- 2 direct dependencies (cobra, modernc.org/sqlite)
- ~15MB binary, zero runtime deps