Troubleshooting

This page helps when Memo does not do what you expected. Find what the screen says or what you noticed, then follow the steps. To ask your agent for help, give it the full message Memo printed.

memo: command not foundCopy Anchor Link

Memo is not installed, or the terminal was opened before you installed it. Close the terminal, open a new one and run memo --help. If it still fails, install Memo again: npm install -g @wirecat/cli-memo (installation).

A note or file does not appear in searchCopy Anchor Link

1. Run memo notes import and read the report. It lists files it could not read and why.
2. Check that the file's folder is in memo folders list, and that the file is not skipped by notes.ignore in the config file.
3. Search for one word you know is in the file. A search finds results that contain every word, so a long sentence often finds nothing; use two or three key words.
4. PDF and Word files need the optional readers: npm install -g unpdf mammoth, then import again. Scanned PDFs have no text to read.

"Searched by words only"Copy Anchor Link

The search model for search by meaning is not on your computer. Memo still finds every note that contains your words. To also search by meaning, download the model with tg or max, then import:

tg models text download e5-small    # or: max models text download e5-small
memo import

"nobody by that name yet"Copy Anchor Link

A note links to a name, such as [[Kai Sample]], but nobody with that name is in the local store yet. The link starts working once the person's chats are downloaded with tg or max. If two people share the name, link the right one with a reference such as [Kai](person:7).

A folder is refused by importCopy Anchor Link

Every folder needs an ID from the local store. Add it with memo folders add /path/to/folder. If the folder was added on another computer, connect it instead: memo folders list shows its ID, and memo folders attach ID /path/to/folder connects it (details).

An import deleted nothing and printed a warningCopy Anchor Link

The import found that most of a folder or mailbox was missing at once and stopped, to protect your data. Check that the folder or disk is there and that the mail account works, then import again.

"no mail account" or mail import asks for an accountCopy Anchor Link

no mail account means the config file has no mail accounts yet. Add one under mail.accounts (mail).

memo mail import needs the account's name: memo mail work import. The name is the name in mail.accounts of the config file. Memo lists the names it knows when the name is missing or wrong.

A note edit is refusedCopy Anchor Link

The revision you gave is not the current one: the note changed after you read it. Run memo notes show note:ID --json, take the current revision and edit again.

A person's context is empty or missing somethingCopy Anchor Link

• The person's chats are not downloaded yet. Download them with tg or max.
• The accounts are not linked. Link them with tg contacts link (details).
• With several accounts in one messenger, add --account.
• A note that only mentions the name in its text is not included; link it instead.

"select --provider and, when several accounts exist, --account"Copy Anchor Link

The command works in one account and Memo does not choose one for you. Add --provider, such as telegram, and --account with the account's ID.

Data from an older version is missingCopy Anchor Link

Older Memo versions kept data in a file called messages.db. The current version uses the shared local store, wirecat.db, and does not read the old file. Add each folder again with memo folders add, then run memo notes import and memo mail <account> import.

Still stuckCopy Anchor Link

Run the failing command again with --json and give your agent the full answer, or open an issue with the command and the message. Do not include private notes, email addresses or messages.