1 added, 1 removed. Audit A to A.
# Memento OS
> Persistent AI memory using reasoning artifacts. Works with Claude Code, Codex, Cursor, Windsurf, Cline, Gemini, Aider, and Continue.
## What This Is
Memento OS gives AI coding agents persistent, validated memory. It stores pre-computed reasoning outputs (decisions, insights, errors, seeds) with invalidation triggers — so the agent knows what was decided, why, and when to re-evaluate.
## Core Concept: Reasoning Artifacts
Four types of artifacts, each with an expiration condition:
- [D] Decision — a choice between alternatives. Format: `[D] conclusion — invalidates if trigger [priority] [date]`
- [I] Insight — a reusable conclusion from research/experience
- - [E] Error — a mistake with root cause analysis
+ - [E] Error — a mistake with root cause + fix
- [S] Seed — a forward-looking idea with activation trigger (surfaces when conditions are met)
Priority matrix: confidence (high/medium/low) x impact (high/low) → critical/volatile/settled/noise
## Plugin Components
Skills (5): memento:decide, memento:grill-me, memento:session-start, memento:session-complete, memento:vault-audit
Commands (2): memento:init, memento:stats
Hooks (2): Stop (auto-capture), PreCompact (save before compression)
## Install
```
/plugin install memento-os
/memento:init
```
## Multi-Tool Support
- Claude Code: Full plugin (skills, hooks, commands)
- Codex (OpenAI): Full skills via adapters/codex/
- Cursor, Windsurf, Cline, Gemini: Rules-based adapters
- Aider, Continue: Manual integration via config
## Key Files
- README.md — full documentation
- skills/*/SKILL.md — skill implementations (Claude Code)
- commands/memento/*.md — command implementations
- hooks/hooks.json — hook definitions
- adapters/*/README.md — per-tool install guides
- evolution/*.md — case studies of problems solved
## Links
- Repository: https://github.com/ayalnogovitsyn/memento-os
- License: MIT