Repository navigation
Home
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.
Before a call, get everything you know about the person in one answer: the last messages each way, the mail, your notes and what you promised. Memo keeps your notes, documents, mail and Telegram, MAX and WhatsApp messages in one place on your computer, so the AI agent you already use, such as Claude Code or Codex, can search all of it at once.
Ask "What do I need to know about Alice before the call?", "Where did we discuss the Harbour budget?" or "What did I promise people this week?". Every answer points back to its source: a note, a page of a file, an email or a message.
On this page:
- What you get
- Things a newcomer would not guess
- How it looks
- Why Memo
- What it can do
- How it works
- Start in a few minutes
- Limits
- Find a guide for your task
- One person, one answer. Every account linked to them, the last message each way, chats in common, mail, your notes and open tasks, each with a link to its source.
- Search that does not care where it was said. Messages, mail and notes ranked together, by words or by meaning.
- Your Obsidian vault in the same search. Notes keep their links, aliases and tags, and the PDF, Word and other documents in the folder are searched too, down to the PDF page a passage came from.
- Promises you can track. Tasks and reminders for what you owe people and what they owe you.
- A memory you control. What your agent wants to remember waits for your confirmation, with the evidence behind it.
- Answers with evidence. Your agent gets the matching sources with their references and what could not be searched, so it cites instead of guessing.
-
Memo reads what the other tools copied.
tg,maxandwacopy your chats, andmailcopies your mail, into the WireCat local store, one file on your computer. Memo imports your folders into the same file and searches it. A chat no tool has copied is not there, so an empty search does not prove a message was never sent. - Nothing is sent, and your sources stay as they are. Memo has no command that sends a message or an email. Importing leaves your files and your mailbox unchanged.
- An agent proposes, you decide. Memories and facts an agent records wait for your review before they count.
- Over MCP, "ask" goes ahead. MCP is the way apps such as Claude Desktop call a tool, and nobody sits there to answer a question. Set what an agent must not do to read only or refuse before you connect it.
- Search by meaning needs a model you download once. Until then Memo searches by words and says so.
You: What do I need to know about Alice before the call?
Agent: (runs memo context telegram:"Alice Example" --json)
Alice wrote yesterday in "Harbour": she needs the revised budget by Friday.
Your note "people/Alice Example.md" says she prefers a short call.
Open task: send her the contract draft.
Sources: msg:telegram/1/77/42, people/Alice Example.md, task 7.
You: Add a task to send her the budget.
Agent: Draft task: "Send Alice the revised budget", linked to her message in "Harbour". Save it?
You: Yes.
- It reads your real conversations. Of the memory tools on the comparison, such as Hindsight, mem0 and Graphiti, none documents reading your Telegram, MAX and WhatsApp chats or your meeting transcripts.
- Every answer has a source. A result carries a reference you or your agent can open.
- Identities are never merged because a name matches. Accounts join only on an email address or phone number nobody else has, or when you link them yourself.
- No AI key needed. Import and search run on your computer, and search by meaning uses a local model. Memo sends text to an AI provider only when you set one up and allow it.
- Every agent call is logged, and you set for each command what an agent may do: allow, ask, read only or refuse.
- Free and open source. Apache 2.0.
Another tool fits better when you want memory that builds itself from conversations with a model (Hindsight, mem0, Graphiti, Cognee), or a hosted memory service for a product you build.
- Notes and folders: import Markdown or an Obsidian vault, and write your own notes about a person or a message. Notes and folders
- Search: everything at once, or only notes, mail or messages. Search
- People and projects: everything about a person or a company. People and projects
-
Mail: search the mail the
mailtool keeps, beside your chats and notes. Mail - Tasks and reminders: what you owe and what you are owed. Tasks and reminders
- Memories and facts: what your agent learned, waiting for your review. Memories and facts
- Business data: contracts, invoices, payments and bank lines, with money waiting for your review. Business data
- Agents everywhere: a skill for terminal agents, an MCP server for Claude Desktop and Cursor, and a signed-in link for apps on the web or phone through your own HTTPS tunnel. The MCP server, Remote connection
- One store on your computer. Memo copies the text of your notes and documents into the local store, beside the messages and mail the other WireCat tools keep there. How Memo works
-
Stays current.
memo syncreads what changed, and on Linux a timer can run it every five minutes. Keeping Memo up to date -
Made for scripts and agents.
--jsongives structured answers, andmemo answers createhands an agent the evidence for a question. - What it reads, writes and sends. Security
Paste this into your agent:
Install Memo with npm install -g @wirecat/cli-memo and memo skill install --for all. Then help me add a folder of notes I choose, import it, and search it for a word I give you with the source of each result.
Or in a terminal. Replace /path/to/notes with a folder on your computer:
npm install -g @wirecat/cli-memo
memo skill install --for all # puts memo's skill where your agents read it
memo folders add /path/to/notes # Obsidian format when it is a vault
memo sync --only notes # reads the notes, their links and tags
memo search notes budgetYou need Node.js 22.16 or a later 22.x, or Node.js 24 or later. Messages come in through tg, max or wa, and mail through
mail. Installation
- Memo is tested on Linux. macOS and Windows are not tested yet.
- Search by meaning needs a local model of about 220 MB, downloaded once.
- Repeating the import on a timer works on Linux with systemd.
- One store per computer. There is no hosted copy to reach from another device, and no window of its own.
| Task | Guide |
|---|---|
| Install and update | Installation |
| A normal day with Memo | Using Memo |
| Where data lives and what a reference means | How Memo works |
| A ready request for your agent | Recipes |
| Connect Claude Desktop or Cursor | The MCP server |
| Every command | All commands |
| Something does not work | Troubleshooting |
| What Memo reads, writes and sends | Security |
| How Memo compares with other memory tools | Compared with other tools |