All commands

Look up every Memo command and option here. Commands that work in one messenger or mail account take --provider and --account; Memo never chooses an account for you. Add --json for an answer a script or agent can read. See recipes for whole tasks and using Memo for a normal day.

Global options

These options work with the memo command itself.

Option	What it does
`-V, --version`	output the version number.

`memo context`

What the store holds about a person — messages, mail and notes — with a link to each source

memo context <person> [options]

Argument	Requirement	What it is
`person`	required	:, e.g. telegram:Ana or email:[email protected].

Option	What it does
`--limit <n>`	most messages and notes of each kind. Default: `20`.
`--json`	print JSON.
`--account <id>`	required when several accounts of the requested provider are stored.

`memo notes`

Notes: files from your folders, and notes you write here about messages, people and projects

`memo notes import`

Bring the folders' notes, their links and tags into the shared store — only what changed

memo notes import [options]

Option	What it does
`--folder <path-or-id...>`	only these configured folders.
`--ignore <path...>`	files or folders inside them to skip, added to notes.ignore — a path or a glob.
`--no-embed`	skip embedding the notes for search by meaning this run.
`--json`	print JSON.

`memo notes about`

Notes about a person, project or note, and the notes that link them — through links, never a name in plain text

memo notes about <subject> [options]

Argument	Requirement	What it is
`subject`	required	:, person:, organization:, project:, note: or document:.

Option	What it does
`--limit <n>`	most notes of each kind. Default: `20`.
`--json`	print JSON.

`memo notes show`

One note: its text, tags, what it links and what links it

memo notes show <note> [options]

Argument	Requirement	What it is
`note`	required	note:, document:, or a file in a configured folder.

Option	What it does
`--json`	print JSON.

`memo notes list`

Notes, newest first

memo notes list [options]

Option	What it does
`--about <subject>`	only notes about this: : or a typed reference.
`--source <source>`	file or internal.
`--search <text>`	only notes holding this text, as written.
`--offset <n>`	skip this many. Default: `0`.
`--limit <n>`	most notes, at most 500. Default: `20`.
`--json`	print JSON.

`memo notes add`

Write a note of your own about messages, people, projects or other notes

memo notes add [text] [options]

Argument	Requirement	What it is
`text`	optional	the note; or --text, or --file.

Option	What it does
`--text <text>`	the note.
`--file <path>`	read the note from a file; - reads stdin.
`--title <title>`	a title.
`--about <subject...>`	what it is about: :, msg:, chat:, person:, organization:, project:, task:, note:, document:, meeting:.
`--meeting <id>`	also about this meeting, by its store id, with --provider and --account.
`--provider <provider>`	the meeting's provider.
`--account <account>`	the meeting's account.
`--export [dir]`	also write it as a file — to this folder, or notes.export.dir.
`--format <format>`	the file's format: obsidian, markdown.
`--json`	print JSON.

`memo notes edit`

Change a note you wrote here; a file's note is edited in its file

memo notes edit <id> [options]

Argument	Requirement	What it is
`id`	required	note: or its id.

Option	What it does
`--revision <n>`	its current revision, so an edit made meanwhile is not lost.
`--text <text>`	the new text.
`--file <path>`	read the new text from a file; - reads stdin.
`--export [dir]`	also rewrite its file — in this folder, or notes.export.dir.
`--format <format>`	the file's format: obsidian, markdown.
`--json`	print JSON.

`memo notes remove`

Delete a note you wrote here; a file it was exported to stays

memo notes remove <id> [options]

Argument	Requirement	What it is
`id`	required	note: or its id.

Option	What it does
`--json`	print JSON.

`memo notes export`

Write the notes you wrote here as files, never overwriting one you edited

memo notes export [options]

Option	What it does
`--to <dir>`	the folder to write to (default: notes.export.dir).
`--format <format>`	the files' format: obsidian, markdown.
`--json`	print JSON.

`memo folders`

Folders of notes: an id that links and the store use, and where the folder is on this computer

`memo folders add`

Give a folder of notes an id, or show the one it has

memo folders add <path> [options]

Argument	Requirement	What it is
`path`	required	the folder on this computer.

Option	What it does
`--format <format>`	how its notes are written: obsidian, markdown (default: obsidian).
`--json`	print JSON.

`memo folders attach`

Bind a folder id from another computer to the folder's path on this one

memo folders attach <id> <path> [options]

Argument	Requirement	What it is
`id`	required	the folder's id, as memo folders add printed it.
`path`	required	the same folder on this computer.

Option	What it does
`--format <format>`	how its notes are written: obsidian, markdown.
`--json`	print JSON.

`memo folders list`

The folders of notes: those on this computer, and those the store has from another

memo folders list [options]

Option	What it does
`--json`	print JSON.

`memo mail`

Read one mail account through Himalaya into the shared message store

memo mail [account] [action] [options]

Argument	Requirement	What it is
`account`	optional	the account's name in mail.accounts of the config, also its name in Himalaya.
`action`	optional	import: read the account's mail, and drop the text of mail deleted at the source.

Option	What it does
`--since <date>`	first day to read, YYYY-MM-DD (default: 30 days ago).
`--max <n>`	most new messages to read in this run. Default: `200`.
`--json`	print JSON.
`--no-embed`	skip semantic embedding; local words remain searchable.
`--retry-attachments`	reread bounded stored messages after installing an extraction engine.

`memo note`

Name the note that is about a person, or show it

memo note <identity> [path] [options]

Argument	Requirement	What it is
`identity`	required	: of any identity of the person.
`path`	optional	the note about them, a file in a configured folder.

Option	What it does
`--clear`	forget which file note is about them.

`memo tags`

Your labels on stored sources and folders or threads

`memo tags add`

Put labels on one source

memo tags add <tag> [options]

Argument	Requirement	What it is
`tag`	required	one or more tags: 1–32 letters a–z, digits or hyphens; case is ignored.

Option	What it does
`--message <locator>`	a stored email or message's full msg: locator.
`--note <reference>`	a note: note:, a file in a notes folder: document:; a bare id is a note.
`--chat <id>`	a stored mail thread or chat's exact id; requires --provider and --account.
`--provider <provider>`	the chat's provider, such as email.
`--account <account>`	the chat's account, such as a mailbox address.
`--task <id>`	label a task.
`--contact <id>`	label a contact identity, with provider/account.
`--person <uid>`	label a unified person.
`--organization <id>`	label an organization.
`--project <id>`	label a project.
`--meeting <id>`	label a meeting by its store id, with --provider and --account.
`--folder <id>`	label a notes folder, or with --path one subfolder: every note under it.
`--path <subfolder>`	the subfolder inside --folder.
`--json`	print JSON.

`memo tags remove`

Remove labels from one source

memo tags remove <tag> [options]

Argument	Requirement	What it is
`tag`	required	one or more tags: 1–32 letters a–z, digits or hyphens; case is ignored.

Option	What it does
`--message <locator>`	a stored email or message's full msg: locator.
`--note <reference>`	a note: note:, a file in a notes folder: document:; a bare id is a note.
`--chat <id>`	a stored mail thread or chat's exact id; requires --provider and --account.
`--provider <provider>`	the chat's provider, such as email.
`--account <account>`	the chat's account, such as a mailbox address.
`--task <id>`	label a task.
`--contact <id>`	label a contact identity, with provider/account.
`--person <uid>`	label a unified person.
`--organization <id>`	label an organization.
`--project <id>`	label a project.
`--meeting <id>`	label a meeting by its store id, with --provider and --account.
`--folder <id>`	label a notes folder, or with --path one subfolder: every note under it.
`--path <subfolder>`	the subfolder inside --folder.
`--json`	print JSON.

`memo tags list`

List source labels, optionally in one provider or account

memo tags list [options]

Option	What it does
`--provider <provider>`	only this provider.
`--account <account>`	only this account; requires --provider.
`--tag <tag>`	only this tag.
`--type <type>`	chat, message, contact, note, document, person, organization, project, task, meeting, folder.
`--limit <n>`	most labels to show. Default: `100`.
`--json`	print JSON.

`memo tasks`

Open work linked to stored messages, documents and emails

`memo tasks link`

link reviewed project task relationships

memo tasks link <task> <other-task> [options]

Argument	Requirement	What it is
`task`	required
`other-task`	required

Option	What it does
`--kind <kind>`	blocked-by, follow-up-of, related-to.
`--json`	print JSON.

`memo tasks unlink`

unlink reviewed project task relationships

memo tasks unlink <task> <other-task> [options]

Argument	Requirement	What it is
`task`	required
`other-task`	required

Option	What it does
`--kind <kind>`	blocked-by, follow-up-of, related-to.
`--json`	print JSON.

`memo tasks relations`

A task's links to other tasks

memo tasks relations <task> [options]

Argument	Requirement	What it is
`task`	required

Option	What it does
`--json`	print JSON.

`memo tasks readiness`

Whether a task can start, and what it still waits for

memo tasks readiness <task> [options]

Argument	Requirement	What it is
`task`	required

Option	What it does
`--json`	print JSON.

`memo tasks ready`

Discover project work with completed prerequisites; this does not claim a task

memo tasks ready [options]

Option	What it does
`--project <project>`	canonical project reference, key or explicit alias.
`--limit <n>`	tasks per page.
`--json`	print JSON.

`memo tasks add`

Add a task: from a message, note or document, or with --project and --title a task of your own

memo tasks add [source] [options]

Argument	Requirement	What it is
`source`	optional	msg: source locator, note: or document:; leave out for a task in a project.

Option	What it does
`--provider <provider>`	source provider.
`--account <account>`	exact stored account.
`--json`	print JSON.
`--title <title>`	one line saying what is to be done.
`--priority <n>`	0 urgent … 4 low.
`--parent <task>`	the parent task, in the same project.
`--description <text>`	the detail, in Markdown.
`--type <type>`	question, request (default), mention or promise from a source; bug, feature or chore (default) in a project.
`--project <project>`	a task without a source: the project's key or project:.
`--assignee <person...>`	who does it: a person's UID.

`memo tasks list`

Tasks of one account or one project, open by default

memo tasks list [options]

Option	What it does
`--provider <provider>`	source provider.
`--account <account>`	exact stored account.
`--json`	print JSON.
`--state <state>`	open, done or dismissed. Default: `open`.
`--project <project>`	a project's tasks, by its key or project:, instead of an account's.
`--limit <n>`	most tasks. Default: `100`.

`memo tasks close`

Close a task as done or dismissed

memo tasks close <id> [options]

Argument	Requirement	What it is
`id`	required

Option	What it does
`--provider <provider>`	source provider.
`--account <account>`	exact stored account.
`--json`	print JSON.
`--as <state>`	done or dismissed. Default: `done`.
`--reason <text>`	why it is closed.

`memo tasks update`

Change a task's title, priority, parent or description

memo tasks update <id> [options]

Argument	Requirement	What it is
`id`	required	the task's id or key.

Option	What it does
`--title <title>`	one line saying what is to be done.
`--priority <n>`	0 urgent … 4 low.
`--parent <task>`	the parent task, in the same project.
`--description <text>`	the detail, in Markdown.
`--json`	print JSON.

`memo tasks assign`

Name who works on a task

memo tasks assign <id> <person> [options]

Argument	Requirement	What it is
`id`	required	the task's id or key.
`person`	required	explicit canonical person UID.

Option	What it does
`--role <role>`	assignee, reviewer, watcher. Default: `assignee`.
`--json`	print JSON.

`memo organizations`

Companies, teams, families and communities of yours

`memo organizations add`

Add an organization of yours: a company, team, family or community

memo organizations add <name> [options]

Argument	Requirement	What it is
`name`	required

Option	What it does
`--kind <kind>`	company, team, family, community.
`--scope <scope>`	personal, work.
`--json`	print JSON.

`memo organizations list`

Your organizations

memo organizations list [options]

Option	What it does
`--json`	print JSON.

`memo organizations context`

One organization: its relationships, the notes about or linking it, and its tags

memo organizations context <id> [options]

Argument	Requirement	What it is
`id`	required

Option	What it does
`--json`	print JSON.

`memo projects`

Projects of yours, each with a short key

`memo projects meetings`

Explicit account-scoped project membership

`memo projects meetings list`

Meetings linked to a project in one account, or proposed links

memo projects meetings list <project> [options]

Argument	Requirement	What it is
`project`	required	project reference, key or explicit alias.

Option	What it does
`--provider <provider>`	meeting provider.
`--account <account>`	exact stored meeting account.
`--json`	print JSON.
`--proposed`	show proposed memberships instead of confirmed ones.
`--limit <n>`	meetings per page.
`--offset <n>`	rows to skip.

`memo projects meetings link`

Link a stored meeting to a project, or confirm a proposed link

memo projects meetings link <project> <meeting-id> [options]

Argument	Requirement	What it is
`project`	required
`meeting-id`	required	positive stored meeting id.

Option	What it does
`--provider <provider>`	meeting provider.
`--account <account>`	exact stored meeting account.
`--json`	print JSON.
`--expected <fingerprint>`	required when confirming an existing proposal.
`--provenance <text>`	why the reviewed meeting belongs to this project.

`memo projects add`

Add a project of yours, with a short key its tasks use

memo projects add <name> [options]

Argument	Requirement	What it is
`name`	required

Option	What it does
`--key <key>`	3–4 letters and digits; made from the name when left out.
`--type <type>`	work, client, personal, oss, other.
`--organization <reference>`	organization: it belongs to.
`--scope <scope>`	personal, work.
`--json`	print JSON.

`memo projects list`

Your projects

memo projects list [options]

Option	What it does
`--json`	print JSON.

`memo projects context`

One project by its id, key or project:: its relationships, the notes about or linking it, and its tags

memo projects context <project> [options]

Argument	Requirement	What it is
`project`	required

Option	What it does
`--json`	print JSON.

`memo relationships`

Explicit relations between people, organizations and projects; this never links identities

`memo relationships add`

State that a person, organization or project belongs to or relates to another

memo relationships add <from> <to> [options]

Argument	Requirement	What it is
`from`	required
`to`	required

Option	What it does
`--json`	print JSON.
`--kind <kind>`	member-of or related-to. Default: `member-of`.
`--role <role>`
`--evidence <text>`

`memo relationships list`

Relationships, all or those of one reference

memo relationships list [options]

Option	What it does
`--reference <reference>`
`--json`	print JSON.

`memo relationships remove`

Remove a relationship

memo relationships remove <id> [options]

Argument	Requirement	What it is
`id`	required

Option	What it does
`--json`	print JSON.

`memo relationships confirm`

Accept a suggested relationship

memo relationships confirm <id> [options]

Argument	Requirement	What it is
`id`	required

Option	What it does
`--json`	print JSON.

`memo relationships suggest`

Store weak shared-domain suggestions for direct email contacts; confirmation is explicit

memo relationships suggest [options]

Option	What it does
`--provider <provider>`	source provider.
`--account <account>`	exact stored account.
`--json`	print JSON.
`--limit <n>`	most suggestions, at most 100. Default: `20`.

`memo reminders`

Durable local reminders; poll leases a delivery and ack confirms it

`memo reminders schedule`

Schedule a reminder for an open task

memo reminders schedule <task> [options]

Argument	Requirement	What it is
`task`	required

Option	What it does
`--provider <provider>`	source provider.
`--account <account>`	exact stored account.
`--json`	print JSON.
`--at <timestamp>`	ISO timestamp with UTC offset.
`--timezone <zone>`	IANA timezone. Default: `UTC`.

`memo reminders list`

Pending reminders of one account

memo reminders list [options]

Option	What it does
`--provider <provider>`	source provider.
`--account <account>`	exact stored account.
`--json`	print JSON.

`memo reminders poll`

Hand out due reminders, each with a receipt to acknowledge

memo reminders poll [options]

Option	What it does
`--provider <provider>`	source provider.
`--account <account>`	exact stored account.
`--json`	print JSON.
`--limit <n>`	most due reminders, at most 500. Default: `100`.

`memo reminders ack`

Confirm that a handed-out reminder was shown

memo reminders ack <id> <receipt> [options]

Argument	Requirement	What it is
`id`	required
`receipt`	required

Option	What it does
`--provider <provider>`	source provider.
`--account <account>`	exact stored account.
`--json`	print JSON.

`memo reminders cancel`

Cancel a reminder

memo reminders cancel <id> [options]

Argument	Requirement	What it is
`id`	required

Option	What it does
`--provider <provider>`	source provider.
`--account <account>`	exact stored account.
`--json`	print JSON.

`memo reminders snooze`

Move a reminder to a later time

memo reminders snooze <id> [options]

Argument	Requirement	What it is
`id`	required

Option	What it does
`--provider <provider>`	source provider.
`--account <account>`	exact stored account.
`--json`	print JSON.
`--at <timestamp>`
`--revision <n>`	current revision.

`memo vocabulary`

Canonical projects, tags and topics with explicit aliases

`memo vocabulary list`

List canonical IDs, aliases, usage counts and a preview fingerprint

memo vocabulary list [options]

Option	What it does
`--kind <kind>`	project, tag or topic.
`--scope <scope>`	personal or work projects.
`--max-entries <n>`	catalog input budget, not a page size.
`--max-read-bytes <n>`	catalog input byte budget.
`--json`	print JSON.

`memo vocabulary resolve`

Resolve an exact name or alias; ambiguity is reported

memo vocabulary resolve <name> [options]

Argument	Requirement	What it is
`name`	required

Option	What it does
`--kind <kind>`	project, tag or topic.
`--scope <scope>`	personal or work projects.
`--max-entries <n>`	catalog input budget, not a page size.
`--max-read-bytes <n>`	catalog input byte budget.
`--json`	print JSON.

`memo vocabulary audit`

Discover likely synonyms without accepting or merging them

memo vocabulary audit [options]

Option	What it does
`--kind <kind>`	project, tag or topic.
`--scope <scope>`	personal or work projects.
`--max-entries <n>`	catalog input budget, not a page size.
`--max-read-bytes <n>`	catalog input byte budget.
`--json`	print JSON.
`--min-similarity <n>`	minimum lexical similarity, 0.65–1.
`--max-comparisons <n>`	bound name comparisons.
`--limit <n>`	maximum candidate pairs.

`memo vocabulary preflight`

Review an existing label or likely lexical duplicates before creation

memo vocabulary preflight <name> [options]

Argument	Requirement	What it is
`name`	required

Option	What it does
`--kind <kind>`	tag or topic.
`--json`	print JSON.

`memo vocabulary create`

Owner: create a distinct tag or topic after reviewing its preflight

memo vocabulary create <name> [options]

Argument	Requirement	What it is
`name`	required

Option	What it does
`--kind <kind>`	tag or topic.
`--expected <fingerprint>`	the current preflight creationFingerprint.
`--json`	print JSON.

`memo vocabulary aliases`

Owner-reviewed aliases on stable canonical IDs

`memo vocabulary aliases add`

Owner: add another name for a project, tag or topic

memo vocabulary aliases add <reference> <name> [options]

Argument	Requirement	What it is
`reference`	required
`name`	required

Option	What it does
`--expected <fingerprint>`	the current vocabulary preview fingerprint.
`--json`	print JSON.

`memo vocabulary aliases remove`

Owner: remove another name from a project, tag or topic

memo vocabulary aliases remove <reference> <alias-id> [options]

Argument	Requirement	What it is
`reference`	required
`alias-id`	required

Option	What it does
`--expected <fingerprint>`	the current vocabulary preview fingerprint.
`--json`	print JSON.

`memo memories`

What agents and you concluded, each with its evidence: agents propose, you confirm

`memo memories add`

Write a memory of your own; it is confirmed at once

memo memories add <text> [options]

Argument	Requirement	What it is
`text`	required	what is true, in a sentence or two.

Option	What it does
`--kind <kind>`	summary, digest, preference.
`--scope <scope>`	personal or work.
`--evidence <ref...>`	what shows it: msg:, note:, meeting:, person: or another reference.
`--subject <ref>`	what it is about, as a reference.
`--json`	print JSON.

`memo memories list`

Memories, newest first

memo memories list [options]

Option	What it does
`--status <status>`	proposed, confirmed, stale, superseded.
`--kind <kind>`	summary, digest, preference.
`--scope <scope>`	personal or work.
`--subject <ref>`	only memories about this reference.
`--limit <n>`	most memories, up to 500. Default: `100`.
`--json`	print JSON.

`memo memories show`

One memory with its evidence

memo memories show <ref> [options]

Argument	Requirement	What it is
`ref`	required	memory:.

Option	What it does
`--json`	print JSON.

`memo memories search`

Memories holding every word, best first

memo memories search <words> [options]

Argument	Requirement	What it is
`words`	required	the words to find.

Option	What it does
`--scope <scope>`	personal or work.
`--limit <n>`	most memories, up to 500. Default: `20`.
`--json`	print JSON.

`memo memories confirm`

Stand behind a memory: its evidence was checked now

memo memories confirm <ref> [options]

Argument	Requirement	What it is
`ref`	required	memory:.

Option	What it does
`--json`	print JSON.

`memo memories stale`

Mark a memory whose evidence no longer holds

memo memories stale <ref> [options]

Argument	Requirement	What it is
`ref`	required	memory:.

Option	What it does
`--json`	print JSON.

`memo facts`

What happened — said, asked, decided, promised — with its evidence: agents propose, you accept

`memo facts add`

Record a fact of your own; it is accepted at once

memo facts add <statement> [options]

Argument	Requirement	What it is
`statement`	required	what happened, in one sentence.

Option	What it does
`--type <type>`	fact, statement, question, decision, promise.
`--evidence <ref...>`	what shows it: msg:, note:, meeting:, person: or another reference.
`--project <ref>`	the project it belongs to, project:.
`--subject <ref>`	what it is about, as a reference.
`--occurred <iso>`	when it happened, as the evidence shows.
`--scope <scope>`	personal or work.
`--supersedes <ref>`	a decision only: the decision this one replaces.
`--json`	print JSON.

`memo facts list`

Facts, latest first

memo facts list [options]

Option	What it does
`--type <type>`	fact, statement, question, decision, promise.
`--status <status>`	proposed, accepted, superseded, reversed.
`--project <ref>`	only this project's, project:.
`--subject <ref>`	only facts about this reference.
`--limit <n>`	most facts, up to 500. Default: `100`.
`--json`	print JSON.

`memo facts show`

One fact with its evidence

memo facts show <ref> [options]

Argument	Requirement	What it is
`ref`	required	fact:.

Option	What it does
`--json`	print JSON.

`memo facts accept`

Stand behind a fact an agent proposed; a decision it supersedes stops holding

memo facts accept <ref> [options]

Argument	Requirement	What it is
`ref`	required	fact:.

Option	What it does
`--json`	print JSON.

`memo facts reverse`

An accepted decision no longer holds, and nothing replaced it

memo facts reverse <ref> [options]

Argument	Requirement	What it is
`ref`	required	fact:.

Option	What it does
`--json`	print JSON.

`memo actions`

What an agent proposes to do; approving one makes it your task, nothing is sent

`memo actions propose`

Propose an action, such as a reply or a ban, in the account that would act

memo actions propose <kind> [options]

Argument	Requirement	What it is
`kind`	required	a lower-case word: reply, send, ban, mute, pin, invite, create_task, ….

Option	What it does
`--reason <text>`	why it should be done.
`--provider <provider>`	the provider of the account that would act.
`--account <account>`	the account that would act, when the provider has several.
`--target <ref>`	what it acts on: msg:, chat:, contact:, person:, task:, ….
`--payload <json>`	what to do, as JSON, such as the reply's text.
`--json`	print JSON.

`memo actions list`

Proposed actions, newest first

memo actions list [options]

Option	What it does
`--status <status>`	proposed, approved, rejected, executed, failed.
`--limit <n>`	most actions, up to 500. Default: `100`.
`--json`	print JSON.

`memo actions show`

One proposed action, with its payload

memo actions show <id> [options]

Argument	Requirement	What it is
`id`	required

Option	What it does
`--json`	print JSON.

`memo actions approve`

Approve it: it becomes a task in the account that would act; nothing is sent

memo actions approve <id> [options]

Argument	Requirement	What it is
`id`	required

Option	What it does
`--json`	print JSON.

`memo actions reject`

Reject it; nothing is done

memo actions reject <id> [options]

Argument	Requirement	What it is
`id`	required

Option	What it does
`--json`	print JSON.

`memo agents`

What agents did through the MCP servers that share the store

`memo agents log`

One row per tool call, newest first: agent, tool, tier, outcome and times, never its arguments

memo agents log [options]

Option	What it does
`--tool <name>`	only this tool.
`--agent <name>`	only this agent, such as tg-mcp or memo-mcp.
`--limit <n>`	most rows, up to 500. Default: `100`.
`--json`	print JSON.

`memo mcp`

Serve memories, proposed actions and the agent log to an agent over MCP, on stdin and stdout

memo mcp

`memo search`

Search stored messages, mail and notes: one kind when you know it, search all when you do not

`memo search all`

Messages, mail and notes ranked together; not people, memories, projects or decisions. A kind you know reads better with its own search, with all its fields

memo search all <query> [options]

Argument	Requirement	What it is
`query`	required	words, phrases, Boolean operators and field queries.

Option	What it does
`--limit <n>`	most results, at most 100. Default: `20`.
`--exact`	words as written; skip meaning search.
`--timezone <zone>`	IANA timezone for calendar date boundaries.
`--json`	print JSON.
`--brief`	each message or email as reference, time, sender and excerpt only.
`--full`	each message or email with its whole text and every field.
`--only <resources>`	messages,mail,notes, separated by commas.

`memo search messages`

Stored messenger messages only

memo search messages <query> [options]

Argument	Requirement	What it is
`query`	required	words, phrases, Boolean operators and field queries.

Option	What it does
`--limit <n>`	most results, at most 100. Default: `20`.
`--exact`	words as written; skip meaning search.
`--timezone <zone>`	IANA timezone for calendar date boundaries.
`--json`	print JSON.
`--brief`	each message or email as reference, time, sender and excerpt only.
`--full`	each message or email with its whole text and every field.
`--type <type>`	text, voice or file.

`memo search mail`

Imported emails only

memo search mail <query> [options]

Argument	Requirement	What it is
`query`	required	words, phrases, Boolean operators and field queries.

Option	What it does
`--limit <n>`	most results, at most 100. Default: `20`.
`--exact`	words as written; skip meaning search.
`--timezone <zone>`	IANA timezone for calendar date boundaries.
`--json`	print JSON.
`--brief`	each message or email as reference, time, sender and excerpt only.
`--full`	each message or email with its whole text and every field.
`--account <address>`	only this mail account, by its address (default: every mail account).

`memo search notes`

Native notes by words and, with the local model, meaning

memo search notes <query> [options]

Argument	Requirement	What it is
`query`	required	words, phrases, Boolean operators and field queries.

Option	What it does
`--limit <n>`	most results, at most 100. Default: `20`.
`--exact`	words as written; skip meaning search.
`--timezone <zone>`	IANA timezone for calendar date boundaries.
`--json`	print JSON.
`--brief`	each message or email as reference, time, sender and excerpt only.
`--full`	each message or email with its whole text and every field.
`--type <type>`	file or internal.
`--tag <tag>`	only notes with this tag.
`--filter <query>`	another query every note must match.
`--folder <path-or-id...>`	only these folders.
`--offset <n>`	continue from nextOffset. Default: `0`.

`memo ask`

Prepare cited evidence for your agent, or explicitly call a configured model

memo ask <question> [options]

Argument	Requirement	What it is
`question`	required

Option	What it does
`--query <query>`	structured retrieval query; defaults to the question.
`--all`
`--provider <provider>`
`--account <account>`
`--limit <n>`	most evidence items, at most 100. Default: `20`.
`--model`	call MEMO_MODELS_ANALYSIS_PROVIDER/MODEL instead of returning an evidence bundle.
`--allow-remote`	explicitly consent to sending this evidence to the configured model.
`--json`

`memo import`

Bring notes and mail up to date in the shared store — only what changed; the timer runs this

memo import [options]

Option	What it does
`--notes`	notes only.
`--mail`	mail only.
`--no-embed`	skip embedding notes and mail for search by meaning this run.
`--json`	print JSON.

`memo auto`

Run memo import on a timer (systemd user timer); on/off and the interval live in the config

`memo auto on`

Import every --every (default: auto.every in the config, else 5m), starting a minute from now

memo auto on [options]

Option	What it does
`--every <interval>`	how often: 5m, 90s, 1h — a minute or more.

`memo auto off`

Stop importing on a timer and remove the timer

memo auto off

`memo auto status`

Whether the timer is on, its interval, when it runs next and how the last run ended

memo auto status [options]

Option	What it does
`--json`	print JSON.

`memo commands`

Discover the command tree and options as shared registry data

memo commands [path] [options]

Argument	Requirement	What it is
`path`	optional	one command, such as tags add.

Option	What it does
`--json`	print JSON.

Exit codes

Failures use the shared WireCat error contract.

Code	When
`0`	it worked
`2`	`validation_error`
`3`	`configuration_error`
`4`	`authentication_error`
`5`	`permission_error`
`6`	`not_found`
`7`	`confirmation_required`
`8`	`rate_limited`
`9`	`timeout`
`10`	`network_error`
`11`	`provider_error`
`12`	`provider_unavailable`
`13`	`invalid_response`
`14`	`outcome_unknown`
`130`	`cancelled`
`1`	anything else

Global optionsCopy Anchor Link

memo contextCopy Anchor Link

memo notesCopy Anchor Link

memo notes importCopy Anchor Link

memo notes aboutCopy Anchor Link

memo notes showCopy Anchor Link

memo notes listCopy Anchor Link

memo notes addCopy Anchor Link

memo notes editCopy Anchor Link

memo notes removeCopy Anchor Link

memo notes exportCopy Anchor Link

memo foldersCopy Anchor Link

memo folders addCopy Anchor Link

memo folders attachCopy Anchor Link

memo folders listCopy Anchor Link

memo mailCopy Anchor Link

memo noteCopy Anchor Link

memo tagsCopy Anchor Link

memo tags addCopy Anchor Link

memo tags removeCopy Anchor Link

memo tags listCopy Anchor Link

memo tasksCopy Anchor Link

memo tasks linkCopy Anchor Link

memo tasks unlinkCopy Anchor Link

memo tasks relationsCopy Anchor Link

memo tasks readinessCopy Anchor Link

memo tasks readyCopy Anchor Link

memo tasks addCopy Anchor Link

memo tasks listCopy Anchor Link

memo tasks closeCopy Anchor Link

memo tasks updateCopy Anchor Link

memo tasks assignCopy Anchor Link

memo organizationsCopy Anchor Link

memo organizations addCopy Anchor Link

memo organizations listCopy Anchor Link

memo organizations contextCopy Anchor Link

memo projectsCopy Anchor Link

memo projects meetingsCopy Anchor Link

memo projects meetings listCopy Anchor Link

memo projects meetings linkCopy Anchor Link

memo projects addCopy Anchor Link

memo projects listCopy Anchor Link

memo projects contextCopy Anchor Link

memo relationshipsCopy Anchor Link

memo relationships addCopy Anchor Link

memo relationships listCopy Anchor Link

memo relationships removeCopy Anchor Link

memo relationships confirmCopy Anchor Link

memo relationships suggestCopy Anchor Link

memo remindersCopy Anchor Link

memo reminders scheduleCopy Anchor Link

memo reminders listCopy Anchor Link

memo reminders pollCopy Anchor Link

memo reminders ackCopy Anchor Link

memo reminders cancelCopy Anchor Link

memo reminders snoozeCopy Anchor Link

memo vocabularyCopy Anchor Link

memo vocabulary listCopy Anchor Link

memo vocabulary resolveCopy Anchor Link

memo vocabulary auditCopy Anchor Link

memo vocabulary preflightCopy Anchor Link

memo vocabulary createCopy Anchor Link

memo vocabulary aliasesCopy Anchor Link

memo vocabulary aliases addCopy Anchor Link

memo vocabulary aliases removeCopy Anchor Link

memo memoriesCopy Anchor Link

memo memories addCopy Anchor Link

memo memories listCopy Anchor Link

memo memories showCopy Anchor Link

memo memories searchCopy Anchor Link

memo memories confirmCopy Anchor Link

memo memories staleCopy Anchor Link

memo factsCopy Anchor Link

memo facts addCopy Anchor Link

memo facts listCopy Anchor Link

memo facts showCopy Anchor Link

memo facts acceptCopy Anchor Link

memo facts reverseCopy Anchor Link

memo actionsCopy Anchor Link