WireCat Memo

memo

Local knowledge for your AI agents.

Your notes, documents, mail and messages in one local store — linked to people, tagged, and searchable with a reference to every source.

Docs · Examples · WireCat

memo is a command-line tool. It imports a folder of notes such as an Obsidian vault, the documents in it, and your mail; it reads the messages that tg-cli and max-cli keep. Then you, or your AI agent, ask: what do I know about this person, where did we discuss this, what did I promise. Every answer points back to its source.

Example — search two invented notes in a notes folder:

$ memo search notes budget Friday

Searched by words only: e5-small is not downloaded — install it with a WireCat CLI that has models download (tg, max or wa); they share the model folder

Projects/Harbour budget.md Review the Harbour budget by Friday. people/Alice Example.md Asked for the revised budget by Friday.

Each hit names its file and shows a matching excerpt. The diagnostic line goes to stderr: the local model is missing, so this search used words only. --json returns structured results for an agent or script.

Quick start

You need Node.js 22.16+ or 24+ (not 23). memo is tested on Linux; macOS and Windows are not tested yet.

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 # your notes folder; Obsidian format by default memo sync --only notes # reads the notes, their links and tags; run again after edits memo search notes "budget"

A global install does not install the agent skill; run memo skill install --for all above. npm 11.17 and later warn about install scripts not covered by allowScripts; with npm 11 the scripts still run. npm 12 blocks them instead. Run the npm install -g --allow-scripts=… command npm prints under the warning; it allows only the packages it names, once. On Windows, open a new terminal if memo is not found.

That is all notes need. Then add more context:

• Messages: install tg-cli or max-cli; memo reads the same local store.
• Search by meaning: needs a local model of about 135 MB, downloaded once with: memo models download e5-small. Without it, memo searches by words.
• Mail: install mail, run mail session start --address and mail sync; memo then searches that mail (memo search mail 'invoice').
• Stay current: memo jobs start runs memo sync every five minutes (Linux, systemd).
• Your agent: memo skill install --for all puts memo's skill where Claude Code, Codex and Gemini CLI read it; memo skill show prints it.

Or ask your agent: "Help me install memo with npm install -g @wirecat/cli-memo and memo skill install --for all, read memo --help, then help me connect a notes folder I choose."

More: installation · install memo on wirecat.dev

What can you do?

"What do I need to know about Alice before the call?"

memo context telegram:"Alice Example" --json

Every identity linked to her, the last message each way, chats in common, linked mail, the notes about her and the open tasks — each with a link to its source.

"Where did we discuss the Harbour budget?"

memo search all 'harbour budget' --json

Messages, imported mail and notes, ranked together. When you know the kind, search notes, search mail and search messages read every field.

"What did I promise people this week?"

memo answers create 'What did I promise this week?' 'promised OR "by Friday"' --all --json

An evidence bundle for your agent: the matching sources with their references, what was searched, and the instruction to cite them. Your agent writes the answer; memo calls a model only when you ask it to.

More: search · ask for the context you need

Built for AI agents

• Any agent with a terminal — Claude Code, Codex, Gemini CLI and others run memo commands; --json gives them structured output.
• Evidence, not guesses — memo answers create hands over sources with references, and says what it could not search.
• MCP — memo mcp serve lets MCP apps such as Claude Desktop or Cursor read your messages, mail and notes, and propose memories, directly recorded facts and outbound actions. Project proposals can also be decided by the agent when allowed; you can require owner decisions instead. Apps on the web or phone use authenticated HTTP MCP through your HTTPS tunnel, with the same saved permissions.

More: connect your AI agent · memories and facts · the MCP server

Why memo?

1. Local first. Everything lives in a local store; search by meaning uses a local model.
2. Every answer has a source. Hits carry a reference you or your agent can open: a note, a file page, an email, a message.
3. Links, not guesses. Notes link to people and records; identities are never merged because a name matches.
4. Imports leave your sources untouched. Memo never changes a mailbox; Gmail cleanup is a command of the separate mail program. Tags and your own notes live in the store.
5. Review and delegation are recorded. Memories and outbound actions an agent suggests wait for your confirmation. Project decisions can be delegated or left to the owner. Memo never sends anything.

Status: early. Context, notes and their links, document import, Gmail and IMAP imports, tasks, manual relationships, evidence bundles and local reminders work. A task in a project cannot have a reminder yet.

More: security · security on wirecat.dev

What it reads

• Folders of notes: Obsidian or plain Markdown, with links, aliases and tags.
• Documents in them: TXT, CSV/TSV, text-layer PDF, DOCX, XLSX, ODT/ODS, PPTX and EPUB, with the page, row or cell each passage came from.
• Mail: Gmail or another IMAP account, synced by the mail CLI, text and headers only.
• Messages: the tg, max and wa store, with the people linked across messengers and mail.

You add your own notes about messages, people and projects, tags, tasks and reminders, organizations and projects.

More: notes · files memo can read

Commands by task

Every command takes --help; most take --json. memo guide lists scenarios — the commands for a common task, in order — and memo guide person-brief gathers one person across every WireCat tool.

More: technical docs · memo on wirecat.dev

Notes from files, and notes you write

From a folder. memo folders add gives a folder an id that the store uses; its path is only where it is on this computer, so the same folder on another computer is attached with memo folders update . memo sync --only notes stores each file as a note named by its path. An edited file keeps its old text as a revision; a moved file keeps its id, links and tags; a deleted file loses its text on the next import. The obsidian format (the default) reads [[Note|label]] links, aliases, tags: and #tags; markdown reads [label](path.md) links and tags:. A [[Kai Sample]] link becomes a link to a person once someone by that name is in the store. Hidden folders such as .obsidian are skipped.

Written in memo. A note you write is the store's, not a file's, and is about whatever --subject names: a person, a message, a chat, a project, a task, another note.

memo notes add 'Prefers mornings' --subject telegram:'Alice Example'

memo notes edit NOTE_ID --revision 1 --text 'Prefers early mornings' memo notes export --output-dir /path/to/vault/memo --format obsidian

An edit names the revision it changes, so an edit made meanwhile is never lost. export writes your notes as files that import then skips, and never overwrites a file you edited.

More: notes · add your notes · create your own notes

Search and evidence

Notes are searched by words and word stems in the query language messages use — phrases, AND/OR/NOT, tag:, date: — and by meaning once the local model is downloaded (memo models download e5-small); both are ranked together. search all reads messages, imported mail, notes and the calendar events gcal stored toget