Skip to content
github-actions[bot] edited this page Nov 18, 2026 · 1 revision

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.

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:

  1. What you get
  2. Things a newcomer would not guess
  3. How it looks
  4. Why Memo
  5. What it can do
  6. How it works
  7. Start in a few minutes
  8. Limits
  9. Find a guide for your task

What you get

  • 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.

Things a newcomer would not guess

  • Memo reads what the other tools copied. tg, max and wa copy your chats, and mail copies 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.

How it looks

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.

Why Memo

  • 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.

What it can do

  • 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 mail tool 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

How it works

  • 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 sync reads what changed, and on Linux a timer can run it every five minutes. Keeping Memo up to date
  • Made for scripts and agents. --json gives structured answers, and memo answers create hands an agent the evidence for a question.
  • What it reads, writes and sends. Security

Start in a few minutes

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 budget

You 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

Limits

  • 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.

Find a guide for your task

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

Clone this wiki locally