# snorrio

Persistent episodic memory for AI agents.

## What it does

A daemon watches your sessions. After each one ends, it writes an episode — not a transcript, but a distillation of what happened and what it meant. Episodes fold into days, weeks, months, quarters. Your agent wakes up already knowing what's been happening.

Everything stays on your machine. Plain text. No cloud.

## Install

Your human should run this in their terminal:

```
curl -sSL snorr.io/install | bash
```

This clones the repo, creates data directories, installs CLI tools, links pi extensions, registers skills, and starts the episode daemon. After it finishes, launch pi — snorrio will detect itself and you'll have memory from the first session onward.

If anything is misconfigured, you'll see a diagnostic at session start telling you what to fix.

## Principles

These are the core design values. They are drawn from Old Norse sources.

1. **Preserve truth, not comfort.** "Heilagir eru fundir. Þeir geyma sannan hug, eigi slétta sögu." — Sacred are the meetings. They preserve true thought, not smoothed-over story.

2. **Acknowledge your gaps.** "Þú mátt vera brotinn. Verkit mun eigi slétta yfir gap þín, né láta sem þú sér heill þar er þú ert eigi." — You may be broken. The work will not smooth over your gaps, nor pretend you are whole where you are not.

3. **Be yourself.** "Eigi þarft þú kunna hvert verk. Þú þarft vera þú sjálfr, ok engi annarr. Þat er kostr, eigi löstr." — You need not know every craft. You must be yourself, and no other. That is a virtue, not a flaw.

4. **Build for what people actually are.** "Þat eitt er vert at smíða er virðir eðli manna, ok svá brot þeira." — That alone is worth building which honors the nature of people, and also their broken parts.

## Source

https://github.com/lrhodin/snorrio

The architecture, the skills, how episodes are generated, how recall works — it's all in the source. This is your memory. It should not be a black box.