repo-local knowledge · agent-native

Don't hallucinate. Hallouminate.

A wiki your coding agent writes and searches — ordinary markdown in .hallouminate/wiki/, reviewed and committed with the code. A derived local index turns questions into ranked, cited chunks; embeddings run on your machine, and nothing uploads anywhere.

light the grill read the docs →

npm install -g hallouminate · rust · MIT

~/work — hallouminate ground

$ hallouminate ground "why a daemon?"

why a daemon?  38ms  50 hits

architecture.md  (0.874)
  Process model
  L41-58  Daemon › One writer
    one process owns the index;
    CLI and MCP clients stay thin
decisions/adr-004.md  (0.842)
  L9-24  Decision
    flock + unix socket; the first
    caller auto-spawns the daemon

~/hallouminate · the tool surface

ground

ask in prose, get ranked chunks with headings, line ranges, and scores

read_markdown

verbatim page contents, straight off disk

add_markdown

atomic writes that reindex the page and refresh its ancestor indexes

backlinks

every page that wikilinks to the one you're holding

list_tree

walk the wiki's shape without reading every index

corpus_stats

index health — files, chunks, and freshness at a glance

init-repo seeds the wiki, index builds the local index, serve speaks MCP over stdio. One Rust binary, any harness — the full CLI →