remindb Memory Writer

What it does

When your agent uses it

• Saving a structured note with headings or lists into remindb memory
• Replacing the content of one existing memory node in place
• Rolling back, pinning or forgetting stored memory
• Linking related memory entries together

Example prompts

• “Save these deployment notes to memory, with a section for each environment.”
• “Update the stored note about the staging database host to the new address.”
• “Roll back the last memory write, it recorded the wrong decision.”

Requirements

• A remindb MCP server attached to the agent
• The `$REMINDB_SOURCE` directory set up for file-based writes

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

1. 1First line is the label. Auto-derived, ≤80 chars. A generic first line ("Notes:", "TODO") gives a useless label.
2. 2Heading hierarchy splits a long note into addressable subtrees. H1 = topic, H2 = aspect, H3 = fact. Below H4 rarely earns its keep.
3. 3Lists for fact-sets, not paragraphs. - key: value per line keeps each fact independently rankable.
4. 4Code blocks for snippets you want verbatim — clean leaves, language tag preserved.
5. 5Tables for matrices — one leaf, but cells are searchable.
6. 6No horizontal rules to separate sections — the parser drops them. Use a heading.
7. 7Don't merge unrelated facts into one paragraph — split into list items or H3s under a shared H2.

What it can do on your machine

Read from SKILL.md and the folder at commit 977b31c. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  No scripts in the folder and no shell commands in SKILL.md.

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

remindb Memory Writer loads about 2k tokens when it runs, and up to ~7.4k if it reads all its reference files. Until then it costs about 128 tokens; SKILL.md has 849 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~128

When it runs · the whole SKILL.md, loaded when a task matches

~2k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~7.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from radimsem/remindb at commit 977b31c, republished under its MIT licence (© radimsem). 849 words, ~1,995 tokens.

name

memorize

description

Mechanism-level write path for a remindb MCP server. Two ways to persist memory by content shape — structural/multi-part content as a source file under $REMINDB_SOURCE (compile plane → parsed node tree), a single text update via MemoryWrite (flat node, no parsing) — plus MemorySummarize/MemoryForget/MemoryRollback/MemoryPin/MemoryRelate. Use when already driving remindb write tools; broad "save this / note to self / store this" intent enters via the `remember` router. Pair with `remind` for reads.

# Postgres production setup

## Region
- Primary: us-east-1
- Replicas: us-west-2

## Credentials
1Password vault entry: `prod-db`.

## Schema
Migrations in `db/migrate/`.

remindb__MemoryWrite(payload="<one short fact>")            # create: one text node, raw
remindb__MemoryWrite(anchor="<node_id>", payload="<text>")  # update one node in place

© radimsem, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (references) in skills/memorize of radimsem/remindb.

• SKILL.md
• references/lifecycle.md
• references/parser-mapping.md
• references/wiki-links.md
• references/write-paths.md

Open the folder on GitHubat commit 977b31c