Skip to content
Back to search

vestige

The memory + security kernel for AI agents. Strata: a signed append-only log, receipts on every write, exact-handle recall, memory agents can't rewrite. Operator Lite: a GuardFall-proof gate on 16 hosts.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 17 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/samvallad33/vestige with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/samvallad33/vestige'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/samvallad33--vestige/badge.svg)](/listings/samvallad33--vestige)

HTML

<a href="/listings/samvallad33--vestige"><img src="/api/listings/samvallad33--vestige/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npx @vestige/init --guard

That sets up local binaries and an MCP connection for any AI agent. `--guard` adds the Operator gate. The MCP command is `vestige-mcp`:

{
  "mcpServers": {
    "vestige": { "command": "vestige-mcp" }
  }
}

From source:

git clone https://github.com/samvallad33/vestige.git
cd vestige
cargo build --release --package vestige-mcp

More in [Getting started](docs/GETTING-STARTED.md).

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 28 lines
  1. {
  2. "name": "vestige",
  3. "description": "Vestige marketplace. One plugin installs the Causal Proof Engine MCP server, the Reflex hook fragments, and the Operator Lite gate.",
  4. "version": "6.2.2",
  5. "owner": {
  6. "name": "Sam Valladares",
  7. "email": "samvalladares21@gmail.com",
  8. "url": "https://github.com/samvallad33"
  9. },
  10. "plugins": [
  11. {
  12. "name": "vestige",
  13. "source": "./plugins/vestige",
  14. "description": "Vestige for Claude Code: Strata MCP server, Reflex hooks, and the Operator Lite gate.",
  15. "author": {
  16. "name": "Sam Valladares",
  17. "email": "samvalladares21@gmail.com",
  18. "url": "https://github.com/samvallad33"
  19. },
  20. "homepage": "https://github.com/samvallad33/vestige",
  21. "repository": "https://github.com/samvallad33/vestige",
  22. "license": "AGPL-3.0-only",
  23. "keywords": ["vestige", "mcp", "memory", "strata", "reflex"],
  24. "category": "development",
  25. "strict": true
  26. }
  27. ]
  28. }
README.md · README · 99 lines
  1. <div align="center">
  2. # VESTIGE
  3. **/ˈvɛs.tɪdʒ/ · VESS-tij**
  4. *From the Latin **vestīgium**, a physical footprint pressed into the earth, and the direct root of **investigate** (**in-vestīgāre**: to follow the track backward).*
  5. ### Deterministic, local-first memory and safety kernel for AI agents
  6. [![Rust](https://img.shields.io/badge/Rust-000000?logo=rust&logoColor=white)](https://github.com/samvallad33/vestige)
  7. [![License: AGPL-3.0](https://img.shields.io/github/license/samvallad33/vestige)](LICENSE)
  8. [![Release](https://img.shields.io/github/v/release/samvallad33/vestige)](https://github.com/samvallad33/vestige/releases)
  9. No embeddings, no LLMs, no GPU, and no API keys. It runs locally on CPU.
  10. </div>
  11. ---
  12. ## Why Vestige?
  13. Roman trackers read *vestigia* in soil to reconstruct what passed through, how heavy it was, which way it moved, and how recently. Vestige does the same for agent memory. It records immutable footprints in an append-only log and walks the trail, instead of guessing meaning from a vector space.
  14. Human memory systems solved truth, order, and provenance under hard limits for 5,000 years: Pāṇini's *anuvṛtti* carry-forward registers, *isnād* witness chains, Andean *khipu* top-cord rollups, Torrens title curtains, and the archaeological Harris matrix. Vestige takes those structural ideas onto a local Rust kernel.
  15. ---
  16. ## Architecture
  17. - **Strata.** An append-only, hash-chained, signed log. Frames carry BLAKE3 payload digests and bi-temporal validity bounds (`valid_from_ms`, `valid_until_ms`). Admitted writes return receipts. Later claims supersede earlier ones; old facts stay on the log.
  18. - **FSRS-6.** Spaced-repetition scheduling that lets unused noise fade.
  19. - **RSB (Retroactive Salience Backfill).** The moat. *Cause never looks like the symptom.* A later turn can raise an earlier memory even when they share no words. Salience is set at write time, and new learning can raise or lower it later, a pattern described in Sheena Josselyn's engram research. In the birthday-dinner demo, a buried "felt off after Bangkok Garden" memory is raised once Maya's peanut allergy is recorded, so a later question about her birthday dinner can retrieve it.
  20. - **Backfill.** Upstream causal walks from a failure or a later fact back to the earlier turn that caused it.
  21. - **Rank-1 seating.** Deterministic slot-1 rules on the retrieved set, such as yielding an assistant reply to a covering user turn, with no vector index.
  22. - **GhostLink.** Pairs recorded memories, each with a proof.
  23. - **Operator hooks, one-use permits, and receipts.** `npx @vestige/init --guard` installs the Operator gate. A one-time owner permit lasts 15 minutes, is consumed once, and stops or allows write receipts.
  24. ---
  25. ## Benchmarks
  26. These numbers measure retrieval: whether the right memory landed in the top k. They do not measure answer accuracy. They are the latest scores merged to `main`, from [PR 709](https://github.com/samvallad33/vestige/pull/709) (RSB v4, commit `5fb269b0`). Runs used the local `retrieval_bench` binary on an Intel Core i5-2520M with 8 GB RAM, CPU only, with no embeddings, no LLM, no GPU, and no API keys.
  27. | Benchmark | Level | Metric | Score |
  28. | :--- | :--- | :--- | :--- |
  29. | **LoCoMo-10** CORE (1,536 questions) | Turn | Exact R@1 / R@5 | **736/1536 (47.92%)** / **1030/1536 (67.06%)** |
  30. | **LongMemEval-S** official (470 non-abstention) | Session | Any@1 / Any@5 / All@5 / NDCG@10 | **423/470 (90.00%)** / **458/470 (97.45%)** / **407/470 (86.60%)** / **0.9229** |
  31. | **LongMemEval-S** official (470 non-abstention) | Turn | Any@1 / Any@5 | **255/470 (54.26%)** / **364/470 (77.45%)** |
  32. | **BEAM 100K** (355 scored questions) | Turn | Any@5 / MRR | **203/355 (57.18%)** / **0.4563** |
  33. | **MemoryAgentBench** QA2 421K (100 questions) | Document | All@5 | **85/100 (85.00%)** |
  34. Reproduce:
  35. ```bash
  36. bash benchmarks/run_all.sh
  37. ```
  38. Full tables and method notes are in [benchmarks/README.md](benchmarks/README.md).
  39. ---
  40. ## Quick start
  41. ```bash
  42. npx @vestige/init --guard
  43. ```
  44. That sets up local binaries and an MCP connection for any AI agent. `--guard` adds the Operator gate. The MCP command is `vestige-mcp`:
  45. ```json
  46. {
  47. "mcpServers": {
  48. "vestige": { "command": "vestige-mcp" }
  49. }
  50. }
  51. ```
  52. From source:
  53. ```bash
  54. git clone https://github.com/samvallad33/vestige.git
  55. cd vestige
  56. cargo build --release --package vestige-mcp
  57. ```
  58. More in [Getting started](docs/GETTING-STARTED.md).
  59. ---
  60. ## License
  61. Built by [Sam Valladares](https://github.com/samvallad33) ([@samvallad33](https://github.com/samvallad33)). Licensed under [AGPL-3.0](LICENSE).
  62. <div align="center">
  63. *Follow the footprints.*
  64. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.