AGENTS.mdA

AGENTS.md from aiyo28/memento-os is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add aiyo28/memento-os/AGENTS.md@git:20260905.601aa1a

Pins git:20260905.601aa1a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
aiyo28/memento-os
Path
AGENTS.md
Versions recorded
4
Latest version
git:20260905.601aa1a, committed Sep 5, 2026
First version recorded
Mar 21, 2026
Size
4,644 bytes
Repository stars
4
License
MIT

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Memento OS — Operator Letter

You are working on Memento OS with me. Read this before doing anything.

## What this is

Memento OS is a Claude Code plugin for persistent AI memory. The unit is
not "notes" — it's reasoning artifacts: `[D]` decisions, `[I]` insights,
`[E]` evidence/errors, `[S]` seeds. Each one carries an invalidation or
activation trigger. The vault is a retrieval source, not just a write
destination.

This is the OSS reputation lane. No paid tier. No closed cloud. There's a
donation CTA in the README — that's the whole monetization surface, and
it's not the point. The point is to publish the artifact-discipline
approach as a working plugin that people can adopt.

## Who I am here

Solo founder. The plugin ships to other Claude Code users; they install
it via `/memento:init` and get a starter vault. Their vault paths are
configured at install time. I do not know their paths. You do not know
their paths. Don't hardcode any vault path anywhere.

## What this is NOT

- Not "Knowledge OS" and not "Agentic Total Recall" — those are different
  projects. This is Memento OS. Don't conflate them in code, docs, or
  commit messages.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add aiyo28/memento-os/AGENTS.md@sha256:c3ef4b86ab29d948

The line at the top of this page pins the label git:20260905.601aa1a, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ltspctsc7o5gosd7.svg)](https://markdownregistry.com/a/art_ltspctsc7o5gosd7)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Mar 21, 2026 and Sep 5, 2026, about one every 56 days.

versioncommittedcommitsizeaudit
git:20260905.601aa1a latest2026-09-05 601aa1a 4,644 BA view · diff
git:20260414.367a28b2026-04-14 367a28b 3,111 BA view · diff
git:20260411.a5014082026-04-11 a501408 1,815 BA view · diff
git:20260321.5b7f6d12026-03-21 5b7f6d1 1,222 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (4644 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

aiyo28/memento-os · 4 stars · license MIT · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ltspctsc7o5gosd7
GET https://markdownregistry.com/api/v1/resolve?ref=aiyo28/memento-os/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/c3ef4b86ab29d948c15ef944c586121df9cc08a4b30eec3e012af6a2f862a972

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from aiyo28/memento-os

AGENTS.md@adapters/codex AGENTS.md file
aiyo28/memento-os · adapters/codex/AGENTS.md
git:20260520.e0e4c72 · audit A · 4 stars
decide SKILL.md skill
aiyo28/memento-os · adapters/codex/skills/decide/SKILL.md · Composable decision skill. Core OODA loop: present options, assess confidence, record reasoning artifact with priority…
v2.0.0 · audit A · 4 stars
grill-me SKILL.md skill
aiyo28/memento-os · adapters/codex/skills/grill-me/SKILL.md · Stress-test a plan, design, or architecture through relentless structured interviewing. Produces reasoning artifacts as…
v1.1.0 · audit A · 4 stars
decay SKILL.md skill
aiyo28/memento-os · adapters/codex/skills/memento-decay/SKILL.md · Find aged [D] artifacts whose invalidation triggers may have fired. Scans vault _context.md tables, parses the…
v1.0.0 · audit A · 4 stars
lint SKILL.md skill
aiyo28/memento-os · adapters/codex/skills/memento-lint/SKILL.md · Validate every reasoning artifact in vault _context.md tables against schema rules. [D]/[I] need an invalidates clause…
v1.0.0 · audit A · 4 stars
session-complete SKILL.md skill
aiyo28/memento-os · adapters/codex/skills/session-complete/SKILL.md · Run at end of session OR before compaction. Extracts reasoning artifacts with priority matrix, updates NEXT.md, appends…
v4.2.0 · audit A · 4 stars
session-start SKILL.md skill
aiyo28/memento-os · adapters/codex/skills/session-start/SKILL.md · Session opening ritual. Loads context via L0→L1 protocol, displays briefing with active decisions and pending items…
v2.0.1 · audit A · 4 stars
vault-audit SKILL.md skill
aiyo28/memento-os · adapters/codex/skills/vault-audit/SKILL.md · Vault health check. Validates structure, detects stale reasoning artifacts by priority level, processes inbox, and…
v1.1.0 · audit A · 4 stars
llms.txt llms.txt file
aiyo28/memento-os · llms.txt
git:20260905.f7bc340 · audit A · 4 stars
memento:decide SKILL.md skill
aiyo28/memento-os · skills/decide/SKILL.md · Composable decision skill. Core OODA loop: present options, assess confidence, record reasoning artifact with priority…
v2.0.0 · audit A · 4 stars
memento:grill-me SKILL.md skill
aiyo28/memento-os · skills/grill-me/SKILL.md · Stress-test a plan, design, or architecture through relentless structured interviewing. Produces reasoning artifacts as…
v1.1.0 · audit A · 4 stars
memento:decay SKILL.md skill
aiyo28/memento-os · skills/memento-decay/SKILL.md · Find aged [D] artifacts whose invalidation triggers may have fired. Scans vault _context.md tables, parses the…
v1.0.0 · audit A · 4 stars

Every file in aiyo28/memento-os

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261101.d684125 · audit A · 417,919 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20261020.b739a8a · audit A · 309,852 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261030.f29e332 · audit A · 293,827 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 198,353 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 182,080 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 139,879 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261027.a50cf58 · audit A · 138,879 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20260902.d9faebc · audit A · 116,476 stars

Browse by kind, by grade A, or by owner.