SaveMe

open source · local-first · MCP

Six months from now you will know what was done and why.

SaveMe is a technical project journal in markdown. When you finish a change you ask your AI agent to save a summary; SaveMe asks you where and leaves it as a .md file on your disk.

Latest version: v0.3.1All downloads

Free and open source. No account, no cloud.

Live preview with Mermaid diagrams, tasks and code. Syntax only shows on the cursor’s line.
what it is for

The why gets lost. SaveMe keeps it.

Code tells you what it does. Git history tells you what changed. Neither tells you why it was decided that way, what was ruled out or what was left pending, and the chat with the agent where it was discussed dies with the session.

01

Six months later

You come back to a project and can’t remember why the watcher has a delay or why SQLite was chosen. The summary is there, with context, alternatives and risks.

02

Beyond git log

Human sentences per feature, fix and decision, grouped by project and category. You get release notes someone can actually read.

03

Your agent writes it

You don’t draft anything: the agent you already use knows the change and writes the summary. You only decide where it goes.

how it works

Three steps, and you decide the last one

  1. 1

    Ask your agent

    When you finish a change: “save a summary in SaveMe”. The agent talks to SaveMe over MCP.

  2. 2

    SaveMe asks you where

    The agent proposes a project and a category. Nothing is written until you accept or pick another place, in the chat or in the app’s Inbox.

  3. 3

    A .md file you own

    The summary lands in ~/Documents/SaveMe/<project>/<category>/. Read it with any editor and version it with git.

benefits

What you get

Your files, your disk

Every summary is a plain markdown file. The file is the source of truth; the app is a comfortable way to read it. No account, no cloud, no lock-in.

Never writes without asking

Proposing doesn’t touch the disk. Only a confirmation with a single-use token writes, and it records whether a person or the agent approved it.

Works with the app closed

The MCP server is the same binary and talks straight to the files. When you open the app, the new summaries are already there.

26 AI clients

Claude Code, Cursor, Codex, Copilot, Gemini CLI, OpenCode and more. The first-launch wizard detects them and configures them for you, with a backup.

Where did we leave off?

Each project’s pulse: the latest activity, the files touched, what is pending and a year-long activity map.

Release notes for free

Pick a date range and get a markdown changelog grouped by category. From the terminal too: saveme changelog.

A real editor

Obsidian-style live preview, Mermaid diagrams, tickable checkboxes, optional vim mode and full-text search.

Share and export

Save a summary as clean markdown, share it on Slack, X or LinkedIn, or export a whole project as a single document.

Make it yours

17 themes with checked contrast, background images, pixel project icons, English and Spanish. It updates itself with signed packages.

screenshots

What it looks like

works with

Works with the agent you already use

SaveMe exposes an MCP server. The app and the CLI know how to configure these clients, and any other one through the custom client mode.

  • Claude Code
  • Claude Desktop
  • Cursor
  • Codex CLI
  • GitHub Copilot
  • VS Code
  • Gemini CLI
  • OpenCode
  • Antigravity
  • Qwen Code
  • Kiro
  • Kilo Code
  • Amp
  • Z Code
  • Kimi Code
  • Devin
  • Windsurf
  • Hermes Agent
  • DeepSeek Harness
  • omp
  • pi
  • Orca
  • Mono
  • T3 Code
  • Omnigent
  • + custom
download

Supported platforms

Links always point to the latest version published on GitHub. After that, the app updates itself.

Version: v0.3.1See all releases

install

How to install

SaveMe is open source and isn’t signed with a paid Apple or Microsoft certificate. That is why your system warns you the first time and asks you to confirm. It’s expected: here is every step.

  1. Download the .dmg

    One for every Mac: Apple Silicon and Intel.

  2. Drag it to Applications

    Open the .dmg and drag SaveMe into the Applications folder.

  3. Open it and allow it in Privacy & Security

    The first time, macOS says it can’t verify the developer and won’t open it. Close that dialog (don’t move it to the Trash), go to System Settings → Privacy & Security, scroll down to the Security section, click Open Anyway next to the message about SaveMe being blocked and confirm with your password. You only do this once.

  4. Follow the wizard

    It explains what it is going to do, shows which agents you have installed and configures the MCP server in the ones you pick. Restart your agent afterwards.

Permissions it may ask for

Documents folder
“SaveMe would like to access files in your Documents folder”. Click Allow: the journal lives in ~/Documents/SaveMe. If you denied it: System Settings → Privacy & Security → Files and Folders → SaveMe → Documents. You can pick another folder in the app’s settings.
Notifications
To let you know when an agent proposes a summary and is waiting for your decision. Optional; change it in System Settings → Notifications → SaveMe.
App Management
If, when updating, macOS says SaveMe was prevented from modifying apps, turn it on in System Settings → Privacy & Security → App Management.

If something goes wrong

“SaveMe is damaged and can’t be opened”

It isn’t damaged: that is how macOS flags unsigned downloaded apps. Remove the quarantine flag and open it again:

xattr -dr com.apple.quarantine /Applications/SaveMe.app
“Open Anyway” doesn’t show up

The button only shows for about an hour after the attempt. Open SaveMe again from Applications and go back to Privacy & Security. On macOS 14 or earlier, right-click → Open also works.

From the terminal

The wizard does it for you, but if you prefer the command line, the saveme binary diagnoses and configures any client:

saveme doctorsaveme mcp-config --listsaveme mcp-config --provider claude-code --write
open source

The code is on GitHub

Read it, build it yourself, open an issue or send a pull request. The installers are built on GitHub Actions from each tag, so what you download comes from that code.

github.com/ismaelosuna7824/savemeGo · Tauri v2 · React · SQLite

Build from source

git clone https://github.com/ismaelosuna7824/savemecd savememake setupmake dev