Installation

bun add -g @slorenzot/memento-cli

Commands

memento save

Save an observation to persistent memory.

memento save "Fixed N+1 query in UserList" \
  --type bug \
  --project my-app \
  --topic-key "bugfix/n1-query"

Options:

Flag	Description	Required
--type	Observation type (decision, bug, discovery, note, summary, learning, pattern, architecture, config, preference)	Yes
--project	Project identifier	No
--topic-key	Stable key for grouping	No
--scope	project or personal	No

memento search

Search observations using full-text search.

memento search "database configuration"
memento search "auth" --type decision
memento search "bugfix" --project my-app --limit 20

Options:

Flag	Description	Default
--type	Filter by observation type	all
--project	Filter by project	all
--limit	Max results	10
--sort	relevance or chronological	relevance

memento timeline

View observations in chronological order.

memento timeline --limit 20
memento timeline --project my-app --limit 50

memento session

Manage memory sessions.

# Start a new session
memento session start --project my-app

# End current session
memento session end

# View session status
memento session status

memento stats

View memory statistics.

memento stats
memento stats --project my-app

Output:

Total observations: 342
By type:
  decision:   89
  bug:        67
  discovery:  54
  note:       48
  learning:   42
  pattern:    22
  ...
Sessions: 28
Projects: 3

memento update

Update an existing observation.

memento update 42 --title "Updated title" --content "New content"

memento delete

Soft-delete an observation.

memento delete 42
memento delete 42 --permanent  # irreversible

MCP Server

Start the MCP server for AI agent integration:

memento-mcp

See MCP Setup for configuration details.