mem · agent memory store

Three operators, one tool. Remember, recall, forget — with full-text search backed by SQLite.

Setup

As an agent skill (recommended)

npx skills add runablehq/memory --all --global

This installs the mem skill for all your agents via skills.sh. Your agent will automatically know how to store and recall information across sessions.

Manual install

# requires bun
bun build --compile src/cli.ts --outfile dist/mem
cp dist/mem ~/.local/bin/mem

Usage

mem [query] recall (search, list, or get by ID)
mem + "content" [--tag a,b] remember
mem - <id> forget

Remember

mem + "chose SQLite for simplicity" --tag architecture
mem + "user prefers dark mode" --tag prefs
mem + "deploy: bun build --compile" --tag deploy
mem + --image ./screenshot.png --title "Current UI" --tag ui
echo"long content"| mem + --tag notes

Recall

mem # list recent
mem "deploy"# search
mem 7sjtNVyZrNIa # get by ID
mem --tag prefs # filter by tag
mem "api" --limit 5 --json # limit + JSON output

Forget

mem - 7sjtNVyZrNIa # forget one
mem - id1 id2 id3 # forget many

Piping

mem "old" --json | jq .# pipe to jq
mem "old" --json | jq -r '.[].id'| xargs -I{} mem - {}
echo"long content"| mem + --tag notes

Flags

--tag a,b filter (read) or apply (write)
--json structured JSON output
--full full content inline
--limit n max results (default 20)
--image path attach image
--title text set title
--export dir export image

Storage

~/.mem/mem.db — SQLite with FTS5 full-text search.