Browse the source · v0.5.4

Read every line before you run it.

This is exactly what git clone gives you: 42 files and 12,318 lines (not counting Cargo.lock). The default build downloads nothing but its Rust crates; only the optional local-embeddings feature also fetches ONNX Runtime and a model. Start with the map below, or press / to jump to any file or function.

11,267lines of Rust
17modules
94unit tests
42files

Rust 11,267
Markdown 962
TOML 49
Text 25
Shell 15

How it fits together

One binary, a folder of markdown, an index you can delete.

The modules

17 modules of Rust, each with one job.

main.rs
Entry point: parses the command line, runs agent hooks, hands off to commands.

5 lines · 1 fns
cli.rs
Every command and flag, declared with clap.

283 lines · 2 fns

usesindex setup store upgrade
commands/
What each command does: find (search, get, list), write (record, update, ack), upkeep, projects, proposals.

1,627 lines · 6 files · 40 fns

usescli index librarian links maintain report setup store ui upgrade
store/
Entries on disk: format, kinds, config, folders, the secret scan, refs and staleness, git commits.

2,107 lines · 8 files · 104 fns
index.rs
SQLite search index: FTS5 keywords + section embeddings, fused by reciprocal rank.

821 lines · 30 fns

usesai store
ai.rs
OpenAI-compatible / Azure client: embeddings and chat, keyless Azure sign-in, safe destinations.

560 lines · 30 fns

usesprivacy store
librarian.rs
Optional model that reviews stale entries against git diffs and widens --deep searches.

337 lines · 17 fns

usesai store
hooks.rs
Agent hooks: session start, every message, end of turn. Milliseconds, no model calls.

362 lines · 17 fns

usesindex librarian links store
setup.rs
The five-step setup wizard: identity, providers, agent tools, projects.

1,250 lines · 39 fns

usesai index store ui
report.rs
doctor, stats and digest: the human-facing reports.

507 lines · 12 fns

usesai index links maintain setup store ui
ui.rs
Terminal styling: colours only on a TTY, wrapping, the shared listing pieces.

455 lines · 43 fns
tests.rs
Unit tests, each in a throwaway mind.

1,672 lines · 99 fns

usesai cli commands hooks index librarian links privacy report setup store ui upgrade
lib.rs
Mega Mind: shared, searchable memory for AI coding agents.

58 lines · 1 fns

usescli commands hooks report store ui
links.rs
Links between entries: `related` (both directions, shown as backlinks), `supersedes` / `replaced_by` (a newer entry takes over), and `status: retired`.

152 lines · 6 fns

usesstore
maintain.rs
`mind maintain`: the nightly upkeep, safe to run unattended.

314 lines · 13 fns

usesindex librarian links store ui
privacy.rs
Masking before text leaves the machine.

173 lines · 3 fns

usesstore
upgrade.rs
mind upgrade: fetch the source clone, show what's new, fast-forward, rebuild.

596 lines · 20 fns

usessetup store ui

What's new

0.5.4 (2026-11-04)

mind search --brief: one line per result (match, kind, project, id, title), the same in a terminal and piped. Agents were cutting the full output with head and missing the result that mattered most (in one case, a cross-project decision their task reversed, in fifth place).
The skill and the always-on rule say to scan with --brief, read every result, never cut search output with head, and tell the user when a task changes something an entry records. They also say to read entries with mind get, not --raw (editing only): agents reading the raw markdown missed whether its code changed, "may contradict" warnings and the related entries.

Full changelog →