memo — local knowledge for your AI agents

These wiki pages copy the docs/ folder on every change to main, so an edit made here is overwritten. To fix a page, open a pull request against docs/. Start with the README.

Questions and ideas: Discussions. What changed in each version: releases. memo is part of WireCat.

Memo keeps what you know about people and projects in one place on your computer: your notes, your email and your Telegram and MAX messages. Your AI agent (for example Claude Code, Codex, Cursor or Gemini CLI) uses it to find what was said, gather the context for a reply and remember what matters.

This page tells you what Memo can do, how it works in short, and how to get a first result in a few minutes.

Three words appear on every page:

• Terminal (command line): the window where you type commands, such as Terminal on macOS or PowerShell on Windows. memo is a command you type there, or that your agent types for you.
• AI agent: a program that does tasks for you and can run commands. It runs memo for you.
• Local store: one file on your computer that holds your messages, mail and notes. Memo, tg and max all read and write the same file.

What it can do

You want to	Where
Search a folder of notes or documents, or an Obsidian vault	Notes and folders
Write your own notes about a person, a message or a project	Notes and folders
Put labels such as work or follow-up on notes, messages and people	Tags
Find something when you do not remember where it was written	Search
See everything about one person: messages, mail and notes	People and projects
Bring your email in beside your notes and messages	Mail
Keep track of what you owe people, and get reminded	Tasks and reminders
Let your agent remember what it learned, with you deciding what stays	Memories and facts
Use Memo from an app with no terminal, such as Claude Desktop	The MCP server

How it works

1. You choose your sources. You add a folder of notes, connect a mail account, or use tg and max to save your chats. Nothing is read until you choose it.
2. Memo copies the text into the local store. It reads your files and mail and never changes them. On Linux, a timer can run it again on its own.
3. You or your agent ask. Memo answers with the matching text and a reference to each source, so you can open the original and check it.
4. Your agent can suggest, but you decide. What an app adds through MCP, and every proposed action, waits for your review. Memo never sends a message or an email.

Everything stays on your computer. Memo sends your text to an AI provider only when you set one up and allow it for that request. How Memo works explains this in more detail.

Get started

The easiest way is to ask your agent. Copy this request into it:

Install Memo with npm install -g @wirecat/cli-memo and check that memo --help works.
Then help me add a folder of notes I choose and import it.
Search it for a word I give you and show me the source of each result.

Or type the commands yourself. Replace /path/to/notes with a folder on your computer:

npm install -g @wirecat/cli-memo
memo folders add /path/to/notes --format markdown
memo sync --only notes --no-embed
memo search notes budget

Memo needs Node.js 22.16 or newer (what to install first). Your files stay where they are; Memo only reads them.

Where to go next

Page	Answers
Installation	What does it need, where do its files go, how do I update or remove it?
Using Memo	What does a normal day with Memo look like?
How Memo works	Where is my data, what is imported, and what does a reference mean?
Notes and folders	How do I import Markdown or Obsidian notes, and write my own?
Tags	How do I label notes, messages and people, and find them again?
Search	How do I find something, and give my agent the sources?
People and projects	How do I see everything about a person, a company or a project?
Mail	How do I bring my email in?
Tasks and reminders	How do I track what I owe people?
Memories and facts	How does my agent remember things, and how do I check them?
The MCP server	How do I connect Claude Desktop, Cursor or another app?
Keeping Memo up to date	How do I import changes, by hand or on a timer?
Recipes	What can my agent do for me with Memo?
All commands	Every command and option
Configuration	Every setting in the config file
Troubleshooting	Something does not work: what the screen says, and what to do
Security	What does Memo read, write and send?