# Autoloop Memory

> Persist and recall Autoloop loop memory — add learnings and preferences, list and find entries, and render memory into prompts. Use when the user asks to remember something across loop runs, inspect loop memory, or configure a memory plugin.

- Skill: `mikeyobrien/autoloop-memory` (Agent Skill)
- Install (CLI): `npx skillmds@latest add mikeyobrien/autoloop-memory`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mikeyobrien/autoloop-memory/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: mikeyobrien (https://skillmd.com/u/mikeyobrien)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mikeyobrien/autoloop-memory

---


# Autoloop Memory

Loop memory is the durable store a loop reads into each iteration prompt. The default plugin is `jsonl` (`.autoloop/memory.jsonl`). A loop uses memory without forking core: pick a plugin with `memory.kind` in `autoloops.toml`.

Parse `$ARGUMENTS` to choose a verb. If none, list memory.

## Verbs

```bash
# Persist
autoloop memory add learning "insight the next iteration should keep"
autoloop memory add preference Workflow "Always run tests before review.ready"
autoloop memory add meta smoke_iteration "2"

# Recall
autoloop memory list
autoloop memory find "pattern"
autoloop memory status

# Prompt-shaped render (same text the harness injects, no budget)
autoloop memory list

# Remove (tombstone; append-only)
autoloop memory remove <id>
```

`autoloop inspect memory` shows the same rendered block (`--format md`) or raw store (`--format json`).

## Default jsonl store

Unless `memory.kind` is set, Autoloop uses the built-in `jsonl` plugin:

- Path: `AUTOLOOP_MEMORY_FILE` or `core.memory_file` (default `.autoloop/memory.jsonl`)
- Entries: learning, preference, meta, tombstone
- Prompt injection is truncated to `memory.prompt_budget_chars` (default 8000)

`file` is a second built-in plugin with the same jsonl file store.

To **replace** jsonl with Honcho, SuperMemory, Mnemosyne, or another store, install that product's Autoloop adapter and set `memory.module`. Autoloop does not ship those products.

```toml
[memory]
kind = "honcho"
module = "@example/autoloop-memory-honcho"   # or "./memory/honcho.cjs"
prompt_budget_chars = 8000
```

The module exports `createMemoryPlugin({ projectDir, kind })` (or `default` / `plugin`) implementing add / list / find / render. API keys stay in the adapter env. `registerMemoryPlugin` still works in-process.

## When to write memory

- **learning** — a durable lesson discovered during a run
- **preference** — a categorized behavioral rule (always project-scoped)
- **meta** — a small key/value the next iteration should see

Do not invent a second memory product. Use these verbs against the configured plugin.