llms.txt Content
# SAME — Stateless Agent Memory Engine
> Agentic storage and persistent memory for AI coding agents. Local-first, privacy-respecting, source-available (BSL 1.1).
> For full context including MCP tool schemas and CLI reference, see https://statelessagent.com/llms-full.txt
## Overview
SAME gives AI coding agents persistent memory across sessions. It indexes your markdown notes locally, captures decisions as you work, and orients your agent with relevant context automatically. A 6-gate chain evaluates every prompt and only injects context when it adds value.
Single Go binary (~14MB). SQLite + vector search. Nothing leaves your machine.
## Version
Current: 0.12.5
License: BSL 1.1 (converts Apache 2.0 on 2030-02-02)
## Install
curl -fsSL statelessagent.com/install.sh | bash
## Key Concepts
- **Per-project vault isolation**: Each project gets its own `.same/` directory with its own SQLite database, auto-detected by directory. Zero cross-pollination between projects.
- **Vault**: A directory of markdown files (Obsidian, Logseq, or plain folders). SAME indexes them locally.
- **Knowledge Graph**: Relationship tracing across notes. `same graph stats`, `same graph query`, `same graph path`, `same graph rebuild`. Visible in CLI and dashboard.
- **Seed Vaults**: Pre-built knowledge vaults you install in one command. 17 seeds, 870+ curated notes. `same seed install <name>`.
- **MCP**: Model Context Protocol — an open standard letting AI tools call external tools. SAME registers as an MCP server via stdio transport (no HTTP ports).
- **.sameignore**: Gitignore-style file for excluding files from indexing. Auto-created on `same init` with smart defaults (node_modules, .git, binaries, lock files).
- **Search filters**: `--trust stale`, `--type decision`, `--tag auth` to filter search results by metadata. `same stale` is a shortcut for listing all stale notes.
- **Trust-aware retrieval**: Stale notes rank 25% lower, contradicted notes 60% lower. Cont