Skip to content

v0.1.0

Choose a tag to compare

View all tags
@shamim0902 shamim0902 released this 09 Apr 03:47
· 11 commits to main since this release
v0.1.0
ed985ce

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 build

Features

  • 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 8765

Stats

  • 4,182 lines of Go
  • 30 files
  • 2 direct dependencies (cobra, modernc.org/sqlite)
  • ~15MB binary, zero runtime deps
Assets 9
Loading