Promemo

Git-Native project memory for AI assisted development.

Promemo saves decisions, architecture notes, TODOs, and handoff context as durable Markdown inside your repository.

npm install -g promemo@latest

Read the quick start

Workflow preview

From command to committed memory.

Load memory

promemo load authentication --related --token-budget 1200
# Example output:
# authentication
# Current state, decisions, and nearby feature hints.

Save handoff

promemo save product-direction --stdin
# Example output:
# Saved feature memory: product-direction
# Updated summary, decisions, and TODOs.

Search retrieval

promemo search "why did we choose passkeys" --hybrid --limit 5
# Example output:
# authentication/decisions.md
# Related feature: identity

Writes to: .promemo/features/<feature>/memory.md
Format: Markdown
Storage: Local repo
Review: Git diffable

Problem

AI forgets the project. Your repo shouldn't.

Every assistant session starts colder than it should. You re-explain architecture, data models, edge cases, and what not to change. Promemo keeps that reasoning beside the code, so future sessions can load durable context instead of guessing from chat history.

Repeated context

Architecture, edge cases, and decisions get re-explained across assistant sessions.

Hidden reasoning

Important project knowledge stays trapped in chat history instead of living with code.

Local memory

Local project memory that stays with your repository.

Promemo is project memory for developers who want AI assistants to remember architecture, decisions, TODOs, APIs, and handoff context without moving that memory into another hosted workspace.

Local memory for codebases

Promemo writes durable Markdown under .promemo/ so local memory can be reviewed, diffed, merged, and committed with the code it explains.

Project memory for AI assistants

Use Promemo to load project memory into Claude, Codex, Cursor, and other MCP-capable tools before the next AI-assisted development session starts.

Repo-owned context

If your search starts with Supermemory or Minimi, Promemo is the Git-native option for teams that want memory owned by the repository.

Searchable development memory

Promemo keeps local project memory searchable through CLI commands, MCP tools, and a generated retrieval index.

Product

Memory that lives with your code.

Promemo stores project, shared, and feature memory under .promemo/. Generated summaries, decisions, APIs, data model notes, TODOs, and prompts stay human-readable, reviewable in pull requests, and committed like any other project artifact.

Repository memory

.promemo/
  project.md
  config.toml
  index.json
  features/
    authentication/
      memory.md
      notes.md
  shared/
    architecture.md
    coding-guidelines.md
    notes.md

Features

What .promemo can do.

Save handoff context

Turn assistant or human handoffs into durable feature memory.

Load prompt-ready context

Give the next AI session current state, decisions, TODOs, and prompts.

Keep memory Git-native

Review, diff, merge, and commit human-readable .promemo/ Markdown.

Preserve human edits

Generated regions can be rewritten while notes outside them stay intact.

Inspect repo state

Snapshot branch, changed files, commits, TODO/FIXME comments, and memory.

Search local retrieval

Build a local index for keyword, semantic, and hybrid memory search.

Automate through one core

Use CLI, JSON contracts, and expanded MCP tools without changing the memory format.

Download / Install

Install Promemo

Install Promemo globally with npm, run it with npx, install it through Homebrew, use the direct release installer, install a tagged Cargo release, or build from the source repository.

Install with npm

npm install -g promemo@latest
promemo --version

Run with npx

npx -y promemo@latest --version

Install with Homebrew

brew tap seguelabs/tap
brew install promemo
promemo --version

Direct binary install

curl -fsSL https://raw.githubusercontent.com/seguelabs/promemo/main/scripts/install.sh | sh

Install tagged release

cargo install --git https://github.com/seguelabs/promemo.git --tag v0.4.0 --force

Install from source

git clone https://github.com/seguelabs/promemo.git
cd promemo
cargo install --path .

Quick Start

Quick start

Get started with Promemo and begin building durable project memory.

Initialize Promemo from the root of a Git repository.

Save a short handoff into feature memory.

Inspect, load, search, and open memory as you resume work.

1. Initialize Promemo

promemo init

2. Save your first memory

cat <<'EOF' | promemo save authentication --stdin
# Authentication
- Refresh tokens rotate on every use.
EOF

3. Inspect the memory tree

promemo tree
promemo tree --json

4. Load context for an assistant

promemo load authentication

5. Search memory

promemo search "refresh token"

6. Open a feature folder

promemo open authentication

Workflow

Built for local-first AI development.

Promemo does not require a hosted backend, does not store raw transcripts, and does not lock memory inside one AI provider. The durable source of truth is Markdown in your repo; the CLI and MCP integrations read and write through the same core engine.

Local-first

No hosted backend is required. The durable source of truth is Markdown in the repository.

Provider-portable

CLI commands, JSON contracts, and MCP integrations read and write through the same core engine.

If Promemo disappeared tomorrow, your project memory would still be readable, reviewable, and portable.