Repository navigation
GoneBy v1.0.0
GoneBy v1.0.0 — first stable release
Retroactive project memory for LLM agents: capture everything cheaply now,
learn what actually mattered at project close, remember it forever.
What's in this release
Core pipeline (all four phases)
- Encrypted per-project write-ahead log — ChaCha20-Poly1305, per-entry nonce,
append-only, corruption-tolerant reads - Backward walk: retrospective filtering judged against the shipped product —
verification, not prediction. Fails open; an unparseable judge never
destroys evidence - Embed + vector store with content-hash IDs: idempotent re-indexing,
Matryoshka truncation (1024→512 default) with unit-normalized storage - Semantic retrieval, project-scoped by default, cross-project opt-in
Integration surfaces
- Hermes plugin: automatic per-turn capture via
pre_llm_call, per-project
WAL naming resolved from session context (git repo root), recall injection
(opt-in),/gonebyslash command, 7 agent tools, coexists with any memory
provider - MCP server (
goneby serve) — any MCP client, no Hermes required; dual
support for mcp SDK 1.x and 2.x - CLI:
generate-key,append,read,status,serve,project,
mode,platform,gate
Capture policy — full user control
- Default: capture on everywhere
- Master gate, per-gateway platform kills (e.g. a Telegram gateway),
per-project.goneby.jsonmarkers, personal user overrides, and a global
opt-inmode for disable-by-default operation - Everything persisted in
~/.goneby/config.json; status surfaces the
effective verdict and why
Verified
- 158 tests pass (WAL crypto, store, scoping, walk, policy decision table,
plugin surface against a fake Hermes ctx, CLI, state.db resolution) scripts/smoke_test.pyproves a live stack end-to-end: embedder reach,
real-model ranking (related/unrelated cosine 0.67/0.25 with
Qwen3-Embedding-0.6B Q8_0 on llama.cpp), store round trip, project
isolation, WAL ciphertext-at-rest — with full cleanup- ruff clean; secret scan across all tracked files: zero hits
Docs
docs/SETUP.md— full stack from zero: library, key, llama.cpp acquisition- model URL, serve/verify commands, valkey or Qdrant, MCP client config,
Hermes plugin install, troubleshooting table
- model URL, serve/verify commands, valkey or Qdrant, MCP client config,
docs/OVERVIEW.md— mechanism, benefits, every option, honest limitsdocs/architecture.png/.html— the four-phase diagram
Install
git clone https://github.com/rahlquist/goneby && cd goneby
uv venv .venv && uv pip install --python .venv/bin/python -e ".[mcp,valkey]"Or pip the attached wheel: pip install goneby-1.0.0-py3-none-any.whl[mcp,valkey]
(sdist also attached). Full instructions: docs/SETUP.md.