Skip to content

Releases: shamim0902/locus

v0.2.0

09 Apr 07:11

Choose a tag to compare

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

09 Apr 03:47

Choose a tag to compare

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