Skip to content
statefulmemory

Getting started

This tour walks the main surfaces once. Each step links to a detailed guide.

1. Install the CLI

Section titled “1. Install the CLI”
Terminal window
git clone https://github.com/sanudatta11/statefulmemory && cd statefulmemory
make prereqs && make install
export PATH="$HOME/.local/bin:$PATH"
statefulmemory --version

Full notes: Install. Deployment modes (self-host vs StatefulMemory Cloud): Self-hosting and Cloud.

2. Wire your agent (and optional git hooks)

Section titled “2. Wire your agent (and optional git hooks)”
Terminal window
statefulmemory install                 # MCP + skills; verify hooks if cwd is a repo
statefulmemory install --no-git-hooks  # skip hooks

Details: Wire into your agent.

3. Save an observation

Section titled “3. Save an observation”
Terminal window
statefulmemory obs save \
  --type decision \
  --title "use pgx not GORM" \
  --content "Team prefers raw SQL via pgx" \
  --session "$(uuidgen)"

Guide: Observations.

4. Search and pull context

Section titled “4. Search and pull context”
Terminal window
statefulmemory obs search "pgx"
statefulmemory obs context --query "deploy" --limit 20
statefulmemory obs context --query "deploy" --max-tokens 500

Guide: Search and context.

5. Anchor important claims

Section titled “5. Anchor important claims”
Terminal window
statefulmemory obs save \
  --type decision \
  --title "login uses JWT" \
  --content "Accept only HS256 in production" \
  --anchor src/auth.rs::login \
  --session "$(uuidgen)"


statefulmemory verify

Guide: Anchors and verify.

6. Decide when notes conflict

Section titled “6. Decide when notes conflict”
Terminal window
statefulmemory decide "Should we keep SQLite or move to Postgres?"

Needs an agent CLI (STATEFULMEMORY_LLM_*). Guide: Decide.

7. Back up

Section titled “7. Back up”
Terminal window
statefulmemory mem export --out backup.mem

Guide: Mem archives.

Data lives under ~/.statefulmemory/. The daemon auto-starts on first use.

Next

Section titled “Next”