elstongun/leviathan

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/elstongun/leviathan.svg?style=card)](https://bestofgithub.dev/repo/elstongun/leviathan)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/elstongun/leviathan.svg)](https://bestofgithub.dev/repo/elstongun/leviathan)

Loading README…

Field	Enables
`id`	`get`, `upsert`, `delete`, citations
`title` / `text`	Card headline (weighted 2×) / searched text (default: all strings)
`group` / `group_name`	`-g` scoped search, name resolution, labeled fallback
`date`	`--since`, `--until`, `recent`
`filters` / `display`	`--where` facets / fields shown on cards
`empty_values` / `rank.boost`	Placeholders treated as missing / favor complete records

After 300 sessions	Leviathan memory	MEMORY.md, whole file	MEMORY.md, first 200 lines
Tokens at session start	736	33,313	2,588
Answer in context	100%	100%	18%
Stale value in context	0%	73.8%	36.4%

Command	Does
`init` / `index` / `upsert` / `delete`	Propose a mapping / build / update / remove records
`search [-g G] [words]`	Ranked records (`--scope`, `--where`, `--since`, `--until`, `-n`, `--offset`)
`aggregate [--by B] [--metric M --field F]`	Exact counts or sum/avg/min/max over every matching record, in total or per group, `year`/`month`/`day` or filter value (`-g`, `--group-contains`, `--where`, `--since`, `--until`, `-n`)
`recent [-g G]` · `resolve <g>` · `get <id…>` · `describe`	Newest · group candidates · full records · index summary
`memory remember` / `recall` / `forget` / `briefing`	Write / ranked read / retire / session-start briefing (`--memory=PATH`)
`memory list` / `history` / `stats` / `import` / `export` / `prune`	Browse / slot versions / counts / markdown or JSONL in / backup / clean up
`mcp [--memory] [--remote URL]` · `serve --http ADDR`	stdio MCP server or bridge · HTTP MCP + REST server
`wrap [agent]`	Agent config (`--memory`, `--hooks`, `--rules`, `--apply`); no agent lists targets

Quickstart