Save assistant handoffs
Import structured Markdown from Codex, Claude Code, Cursor, or any assistant.
Promemo turns AI coding sessions into durable, Git-native memory. Save the decisions, tradeoffs, TODOs, APIs, and handoff prompts your future assistant needs without storing raw transcripts.
Workflow preview
From command to committed memory.
Install Promemo, save handoffs, load feature memory, and inspect repo state through simple CLI commands that produce durable Markdown.
> cargo install --path .
# install from source
git clone <repo-url>
cd promemo
cargo install --path .
# then initialize project memory
promemo init> promemo load authentication
# authentication
## Current state
- Refresh tokens rotate on every use.
- Session lookup stays local to the repo.
## Decisions
- Keep memory in .promemo/ so reviews happen in Git.
- Store why, not raw assistant transcripts.> promemo save product-direction --from examples/handoff.md
Saved feature memory:
feature: product-direction
source: examples/handoff.md
updated: summary, decisions, TODOs
preserved: human notes outside generated regions> promemo snapshot authentication --dry-run
Repository snapshot:
branch: main
changed files: 4
recent commits: 8
TODO/FIXME comments: 3
existing memory: authentication- Writes to
- local source checkout
- 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, decisions, edge cases, and what not to change. Promemo keeps that context inside the repository as Markdown, so future sessions can load the reasoning behind the code.
Product
Memory that lives with your code.
Promemo writes feature memory under .promemo/, including summaries, current state, decisions, APIs, data model notes, TODOs, and reusable prompts. The files are human-editable, reviewable in pull requests, and committed like any other project artifact.
Features
What V1 can do today.
Load prompt-ready context
Give the next AI session the feature memory it needs.
Keep memory Git-native
Review, diff, merge, and commit .promemo/ files.
Preserve human edits
Promemo updates generated regions while leaving notes intact.
Inspect repo state
Snapshot branch, changed files, commits, TODO/FIXME comments, and existing memory.
Automate with JSON
Use stable stdin/stdout contracts for scripts and future integrations.
Download / Install
Install Promemo
Promemo is currently installable from a local source checkout. Published package downloads are planned for a later packaging milestone.
Note: replace <repo-url> with the public repository URL when the landing page goes live.
> git clone <repo-url>> cd promemo> cargo install --path .Quick Start
Quick start
Get started with Promemo and begin building durable project memory.
For assistant handoffs, save Markdown into a named memory.
For piped handoff Markdown, stream content directly from stdin.
Inspect saved memory when you need to resume or audit context.
> promemo init> promemo save-json authentication < examples/memory.json> promemo load authentication> promemo save product-direction --from examples/handoff.md> cat handoff.md | promemo save product-direction --stdin> promemo list> promemo tree> promemo search "refresh token"> promemo snapshot authentication --dry-runWorkflow
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. If Promemo disappeared tomorrow, your project memory would still be readable.
Promemo is early, local-first, and built for developers who want AI assistants to remember the project, not the chat.