What is Memento?

Memento is a persistent memory system for AI coding agents. It gives AI assistants like Claude Code, Cursor, and OpenCode a memory that survives across sessions, projects, and collaborators.

Instead of starting every conversation from scratch, your AI agent can:

  • Save decisions, bug fixes, and discoveries as observations
  • Search through past knowledge using full-text search (FTS5)
  • Share memory with your team via cloud sync

Installation

Install the CLI globally with your preferred package manager:

# Using bun
bun add -g @slorenzot/memento-cli

# Using npm
npm install -g @slorenzot/memento-cli

First Steps

1. Start a session

memento session start --project my-app

This creates a new memory session. All observations you save will be grouped under this session.

2. Save your first observation

memento save "Chose PostgreSQL over MongoDB" \
  --type decision \
  --project my-app

3. Search your memory

memento search "database choice"

4. View your timeline

memento timeline --limit 10

MCP Server Setup

For AI agent integration, Memento provides an MCP server:

# Start the MCP server
memento-mcp

Add it to your AI tool config:

{
  "mcpServers": {
    "memento": {
      "command": "memento-mcp"
    }
  }
}

What's Next?