# recoil

> Local-first memory for coding agents. One SQLite store holds verbatim memories with provenance — who wrote each one, from where, in which scope, and whether it still holds — and hands an agent a bounded block of the ones that matter at the start of every session.

For people, it is the decision log that never goes stale. For agents, it replaces re-reading the history with three calls: wake to start, check before acting against a decision, handoff to close.

Install: curl -fsSL https://recoil.sh/install | sh
The full manual, as Markdown: https://recoil.sh/llms-full.txt

## Sections

- [Overview](https://recoil.sh/#overview): recoil stores memories, not summaries.
- [Install](https://recoil.sh/#install): One line on macOS and Linux.
- [Quickstart](https://recoil.sh/#quickstart): Run it inside a repository.
- [Choosing a command](https://recoil.sh/#choosing-a-command)
- [Commands](https://recoil.sh/#commands): Every command takes -d <path> (or RECOIL_DB) to aim at another store and --json for a structured envelope.
- [Memory model](https://recoil.sh/#memory-model): All scopes live in one store.
- [For agents](https://recoil.sh/#for-agents): recoil was built to be called by something that isn't a person.
- [Notes](https://recoil.sh/#notes): Published binaries have it compiled in.

## Links

- Install: https://recoil.sh/#install
- Source: https://github.com/1broseidon/recoil
- Site as data: https://recoil.sh/manifest.json
- Sitemap: https://recoil.sh/sitemap.xml