CLI reference

Generated from a live server’s command catalog (checkout c6630d1): 40 built-in commands and 179 commands generated from contracts. Your own install may show more or fewer, depending on its contracts; me help and me help <command…> are always the source of truth for the server you are connected to.

Regenerate this page with pwsh docs/guide/reference/Update-CliReference.ps1 [-Me <path to me.exe>], with me logged in to a running server whose contracts match the checkout (the script refuses an older server and an empty catalog). Do not edit it by hand.

How to read it:

• Kind. An Operation changes something and returns an operation state; a Query only reads; Resource commands (list, get) read stored records.
• Risk. The tier the authorization gate uses: Read, LocalWrite and ExternalReversible run; ExternalCommunication and High need your approval (unless an agent’s delegation reaches that tier); Critical needs a passkey step-up and is refused to agents. See Concepts → Approvals.
• Common options are listed under each command, as me help <command> --json reports them. --input-json '<json>' (or --input, - for stdin, @file) gives the whole input at once. When a command’s own input has a field called input, --input sets that field and only --input-json takes the whole input; those commands say so under their table. list takes --limit (default 20); get takes a ref.
• Array flags repeat (--tags a --tags b), split on commas (--tags a,b) or take JSON (--tags '["a","b"]', needed when a value has a comma). Arrays of objects take one JSON object per flag. Object flags take JSON.
• One of several sets. When a command needs one of several sets of flags, they are listed under its table.

Contents

• Built-in commands
• me ask
• me attention
• me calendar
• me call
• me chat
• me claude
• me comms
• me connection
• me context
• me conversation
• me device
• me directory
• me mail
• me memory
• me model
• me money
• me note
• me notify
• me person
• me presence
• me schedule
• me search
• me session
• me sms
• me task
• me teams
• me transcribe
• me trigger
• me user
• me work
• me workflow

Built-in commands

These are part of the CLI itself (sign-in, tokens, approvals, plugins, integrations, policy), not of a contract.

Command	What it does
me login --server <url> --token-stdin	Log in with a personal access token read from standard input (from Me.Server setup or me token create).
me logout	Forget this server’s stored token.
me use <tn_…>	Switch tenant.
me status	Show server, tenant and config path.
me get <ref>	Show any resource by ref.
me relations <ref>	Show a resource’s relations.
me op show <op_…>	Show an operation’s state, result or error.
me op approve <op_…> --digest <sha256:…>	Approve an operation waiting for you (the digest pins exactly what you approve).
me op approve-passkey <op_…>	Approve a step-up operation with your passkey.
me op reject <op_…> [--reason <text>]	Reject an operation waiting for you.
me passkey add [--label <name>] | list	Register a passkey for step-up approvals, or list yours.
me whoami	Who you are logged in as, and in which tenant.
me token create --name <name> [--days <n>] [--principal <pr_…>] | list | revoke <tok_…>	Personal access tokens (for another device, CI or an agent).
me when "<event> [field:value …]" do <operation> [--flag value …]	A trigger: run an operation whenever a matching event happens.
me standing list [--all] | revoke <so_…>	Standing orders: what may act for you without asking each time.
me artifact show <art_…>	Show a stored file (a transcript, an attachment).
me contract list	Browse contracts.
me contract show <name>	Show a contract and its schema.
me plugin list	Installed plugins.
me device enroll --name <name> [--days <n>]	Enrol one of your computers as a device (ADR 0024): it may only run device.* work, with a token for its connector.
me plugin enable <plugin id>… | --all	Turn plugins on for this tenant.
me integration list	Providers you can set up (mail, SMS, voice, calendars …) and your instances of each.
me integration add <provider> --name <name> [--<field> <value>…] [--secrets-stdin]	Add an instance (a mailbox, a number, an account): settings from flags or prompts, secrets only at a hidden prompt or as JSON on stdin.
me integration test <conn_…>	Check that an instance works.
me integration remove <conn_…>	Remove an instance.
me agent register <name> [--allow <pattern>…] [--deny <pattern>…] [--max-risk <tier>] [--max-sensitivity <level>] [--days <n>]	Create an agent principal with a delegation from you (default: everything but payments, up to ExternalReversible/Confidential, 90 days).
me agent list	Agents in this tenant and their active delegations.
me agent revoke <pr_…>	Remove an agent from the tenant and revoke its delegations.
me delegation list [--grantee <pr_…>] [--all]	Delegations in this tenant (active only unless –all).
me delegation grant <pr_…> [--allow <pattern>…] [--deny <pattern>…] [--max-risk <tier>] [--max-sensitivity <level>] [--days <n>]	Grant a principal authority to act for you.
me delegation revoke <dlg_…>	Revoke a delegation.
me policy explain <op_…>	Why an operation was allowed, denied or is waiting: the recorded decision and today’s.
me policy check <operation>	What the gate would decide if you ran an operation now (nothing is submitted).
me find "<text>"	Find anything by text (tasks, notes, messages, people); results carry refs.
me help [<command…>] [--json]	This help; with a command, its flags.
me version	CLI version.
me mcp	Run as an MCP server over stdio (for Claude Code and other LLM hosts).
me session import claude-code [--dir <path>] [--since <yyyy-mm-dd>]	Import local Claude Code transcripts so me find can find those sessions (what you typed, not tool output).
me attention hook	Claude Code UserPromptSubmit hook: adds urgent attention items to the next prompt (prints nothing when there are none).
me skill print | install [--dir <path>]	The me Agent Skill with this server’s commands (install writes ~/.claude/skills/me).

A built-in takes the place of the contract command with the same name: me device enroll. Its usage is the one in the table above.

me ask

me ask decline

Decline a question the system asked you; whoever asked is told it was declined.

Operation · risk LocalWrite · contract ask.decline

Flag	Type	Required	Notes
--ask	string	yes
--reason	string (or null)		At most 500 characters.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me ask item get

Show one ask.item by ref.

Resource · risk Read · contract ask.item

Usage: me ask item get <ref>

me ask item list

List ask.item resources.

Resource · risk Read · contract ask.item

Flags: --limit <n> (default 20).

me ask request

Ask a person something; the conversation layer phrases it and interprets the free-form reply into response_schema. local_write covers recipients with a principal in this tenant only: a recipient outside the tenant is reached through comms.send (external_communication, evidence binds the composed words, spec 05 §5.12).

Operation · risk LocalWrite · contract ask.request

Flag	Type	Required	Notes
--recipient	string	yes
--purpose	string	yes
--facts	object
--need	string	yes
--response-schema	object	yes
--deadline	string (or null)		Format: date-time.
--urgency	low | normal | high | critical	yes
--sensitivity	Public | Internal | Confidential | Restricted	yes

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me attention

me attention acknowledge

Mark an attention item as seen and handled.

Operation · risk LocalWrite · contract attention.acknowledge

Flag	Type	Required	Notes
--item	string	yes

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me attention defer

Put an attention item off until later (default 4 hours).

Operation · risk LocalWrite · contract attention.defer

Flag	Type	Required	Notes
--item	string	yes
--until	string (or null)		Format: date-time.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me attention disable

Stop urgent items from interrupting you by notification. Work and follow-ups addressed to you still wait in your attention list.

Operation · risk LocalWrite · contract attention.disable

No flags.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me attention dismiss

Dismiss an attention item.

Operation · risk LocalWrite · contract attention.dismiss

Flag	Type	Required	Notes
--item	string	yes

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me attention enable

Let the system interrupt you by notification for urgent items: unusual charges, overdue bills, escalated work. Without it they wait in your attention list.

Operation · risk LocalWrite · contract attention.enable

No flags.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me attention item get

Show one attention.item by ref.

Resource · risk Read · contract attention.item

Usage: me attention item get <ref>

me attention item list

List attention.item resources.

Resource · risk Read · contract attention.item

Flags: --limit <n> (default 20).

me attention open

Look into an attention item: returns it, marks it seen, and gives an overlay scope to pass (–scope) on the calls that look into it, kept apart from what you were doing. Start here whenever you look into an item.

Operation · risk LocalWrite · contract attention.open

Flag	Type	Required	Notes
--item	string	yes

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me attention pending

What needs your attention now (boundary level and above unless min_level says otherwise), most urgent first, with why and what you can do.

Query · risk Read · contract attention.pending

Flag	Type	Required	Notes
--min-level	silent | ambient | boundary | interrupt | critical (or null)

Common options: --json, --input | --input-json '<json>' | - | @file.

me calendar

me calendar agenda

Events on your calendar between two times (recurring ones expanded), earliest first: title, start and end, location, organizer, online-meeting link.

Query · risk Read · contract calendar.agenda

Flag	Type	Required	Notes
--from	string	yes	Start of the window (ISO 8601 with offset). Format: date-time.
--to	string	yes	End of the window (at most 31 days after from). Format: date-time.
--connection	string		Which calendar account (default: the first connected).
--limit	integer		Range: 1–200.

Common options: --json, --input | --input-json '<json>' | - | @file.

me calendar event create

Put an event on your own calendar (no invitations are sent): title, start, end, optional location and notes. Retrying the same request never makes a second event.

Operation · risk ExternalReversible · contract calendar.event.create

Flag	Type	Required	Notes
--title	string	yes	At most 255 characters.
--start	string	yes	Format: date-time.
--end	string	yes	Format: date-time.
--location	string		At most 255 characters.
--notes	string		At most 4000 characters.
--connection	string	yes	Which calendar account (conn_… from me integration list).

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me calendar freebusy

When you are busy between two times: intervals only (no titles), for finding a free slot.

Query · risk Read · contract calendar.freebusy

Flag	Type	Required	Notes
--from	string	yes	Format: date-time.
--to	string	yes	Format: date-time.
--connection	string

Common options: --json, --input | --input-json '<json>' | - | @file.

me call

me call get

Show one call.call by ref.

Resource · risk Read · contract call.call

Usage: me call get <ref>

me call list

List call.call resources.

Resource · risk Read · contract call.call

Flags: --limit <n> (default 20).

me call place

Place an outbound call (never without approval for agents in v1).

Operation · risk ExternalCommunication · contract call.place

Flag	Type	Required	Notes
--to	object	yes
--from-channel	string (or null)
--purpose	string	yes
--intent	string (or null)

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me call transcript get

Show one call.transcript by ref.

Resource · risk Read · contract call.transcript

Usage: me call transcript get <ref>

me call transcript list

List call.transcript resources.

Resource · risk Read · contract call.transcript

Flags: --limit <n> (default 20).

me call voicemail get

Show one call.voicemail by ref.

Resource · risk Read · contract call.voicemail

Usage: me call voicemail get <ref>

me call voicemail list

List call.voicemail resources.

Resource · risk Read · contract call.voicemail

Flags: --limit <n> (default 20).

me chat

me chat message get

Show one chat.message by ref.

Resource · risk Read · contract chat.message

Usage: me chat message get <ref>

me chat message list

List chat.message resources.

Resource · risk Read · contract chat.message

Flags: --limit <n> (default 20).

me chat react

React to a chat message. Visible to other people (a reaction can read as assent), so it is external communication.

Operation · risk ExternalCommunication · contract chat.react

Flag	Type	Required	Notes
--message	string	yes
--reaction	string	yes

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me claude

me claude session get

Show one claude.session by ref.

Resource · risk Read · contract claude.session

Usage: me claude session get <ref>

me claude session list

List claude.session resources.

Resource · risk Read · contract claude.session

Flags: --limit <n> (default 20).

me claude session respond

Answer a Claude Code session that is waiting for you (a question, a permission it lacked) or give a finished one its next instruction; it resumes and runs code again.

Operation · risk High · contract claude.session.respond

Flag	Type	Required	Notes
--session	string	yes
--text	string	yes	At most 20000 characters.
--permission-mode	plan | acceptEdits | default

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me claude session start

Start a Claude Code session on a repository in the workspace (headless, in its own git worktree and branch) to carry out a development task. It runs code on this machine, so it needs your approval each time. You are told when it needs you or is done.

Operation · risk High · contract claude.session.start

Flag	Type	Required	Notes
--connection	string	yes	The Claude integration (me integration list).
--repo	string	yes	A repository folder directly under the integration’s workspace root.
--task	string	yes	What to do, in plain words. At most 20000 characters.
--permission-mode	plan | acceptEdits | default		plan: propose only; acceptEdits: may edit files in its worktree (default).
--max-turns	integer		Range: 1–200.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me claude session stop

Stop a running Claude Code session (its worktree and branch are kept for review).

Operation · risk LocalWrite · contract claude.session.stop

Flag	Type	Required	Notes
--session	string	yes

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me comms

me comms archive

Operation · risk ExternalReversible · contract comms.archive

Flag	Type	Required	Notes
--conversation	string	yes

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me comms channel get

Show one comms.channel by ref.

Resource · risk Read · contract comms.channel

Usage: me comms channel get <ref>

me comms channel list

List comms.channel resources.

Resource · risk Read · contract comms.channel

Flags: --limit <n> (default 20).

me comms conversation get

Show one comms.conversation by ref.

Resource · risk Read · contract comms.conversation

Usage: me comms conversation get <ref>

me comms conversation list

List comms.conversation resources.

Resource · risk Read · contract comms.conversation

Flags: --limit <n> (default 20).

me comms delivery get

Show one comms.delivery by ref.

Resource · risk Read · contract comms.delivery

Usage: me comms delivery get <ref>

me comms delivery list

List comms.delivery resources.

Resource · risk Read · contract comms.delivery

Flags: --limit <n> (default 20).

me comms draft create

Create a draft without sending.

Operation · risk LocalWrite · contract comms.draft.create

Flag	Type	Required	Notes
--channel	email | sms | call | voicemail | chat | session	yes
--to	array<object>	yes
--subject	string (or null)
--body	string	yes
--reply-to	string (or null)

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me comms draft get

Show one comms.draft by ref.

Resource · risk Read · contract comms.draft

Usage: me comms draft get <ref>

me comms draft list

List comms.draft resources.

Resource · risk Read · contract comms.draft

Flags: --limit <n> (default 20).

me comms draft update

Edit a draft. Any change invalidates approval evidence bound to the old text (spec 03 §3.7).

Operation · risk LocalWrite · contract comms.draft.update

Flag	Type	Required	Notes
--draft	string	yes
--to	array<object>
--subject	string (or null)
--body	string

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me comms followup clear

Stop waiting for a reply on a conversation.

Operation · risk LocalWrite · contract comms.followup.clear

Flag	Type	Required	Notes
--conversation	string	yes

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me comms followup set

Wait for a reply on a conversation until a due time. At the due time comms.followup.due fires (and comms.reply.overdue when waiting on someone); a reply first clears it.

Operation · risk LocalWrite · contract comms.followup.set

Flag	Type	Required	Notes
--conversation	string	yes
--due	string	yes	Format: date-time.
--waiting-on	string (or null)

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me comms mark_read

Operation · risk ExternalReversible · contract comms.mark_read

Flag	Type	Required	Notes
--message	string	yes

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me comms message get

Show one comms.message by ref.

Resource · risk Read · contract comms.message

Usage: me comms message get <ref>

me comms message list

List comms.message resources.

Resource · risk Read · contract comms.message

Flags: --limit <n> (default 20).

me comms reply

Reply in a conversation. To draft a reply without sending, use comms.draft.create with reply_to (local_write).

Operation · risk ExternalCommunication · contract comms.reply

Flag	Type	Required	Notes
--message	string	yes
--body	string	yes
--sensitivity	Public | Internal | Confidential | Restricted		How sensitive your reply is (default Internal: your own words). Say Confidential for anything health- or money-sensitive; providers not covered for it then refuse it.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me comms send

Send a draft (or an inline message) on its channel. Agents always need approval in v1 (D-21).

Operation · risk ExternalCommunication · contract comms.send

Flag	Type	Required	Notes
--draft	string
--channel	email | sms | chat
--to	array<object>
--subject	string (or null)
--body	string
--from-channel	string (or null)
--sensitivity	Public | Internal | Confidential | Restricted		How sensitive your message is (default Internal: your own words). Say Confidential for anything health- or money-sensitive; providers not covered for it then refuse it.

Requires one of: --draft; or --channel + --to + --body.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me connection

me connection verify

Check that a connection works (credentials accepted, the mailbox, number or account reachable), changing nothing at the provider. Run by me integration add and me integration test.

Operation · risk Read · contract connection.verify

Flag	Type	Required	Notes
--connection	string	yes

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me context

me context assemble

Assemble the model input for one call in cache-friendly layers (profile, lane pack, segment, per-turn retrieval, input), within a token budget, each layer with a stable hash.

Query · risk Read · contract context.assemble

Flag	Type	Required	Notes
--purpose	string (or null)		At most 100 characters.
--lane	string (or null)		At most 100 characters.
--segment	string (or null)
--input	string (or null)		The current input (L5). At most 20000 characters.
--query	string (or null)		At most 1000 characters.
--referenced	array<string>
--token-budget	integer (or null)		Range: 100–200000.
--max-sensitivity	Public | Internal | Confidential | Restricted (or null)

Here --input sets the command’s own input field; use --input-json for the whole input.

Common options: --json, --input-json '<json>' | - | @file.

me context view

What a past context assembly contained (refs and hashes per layer), for debugging.

Query · risk Read · contract context.view

Flag	Type	Required	Notes
--view	string	yes

Common options: --json, --input | --input-json '<json>' | - | @file.

me conversation

me conversation inbox

Your inbox: messages the system composed for you (or the person you act for), newest first; unacknowledged only unless all is set.

Query · risk Read · contract conversation.inbox

Flag	Type	Required	Notes
--all	boolean		Include acknowledged messages.
--limit	integer		Range: 1–200.

Common options: --json, --input | --input-json '<json>' | - | @file.

me conversation reply

Reply to the system’s questions in your own words. The reply resolves the open questions it clearly answers; anything unclear gets a follow-up question. A reply never approves anything.

Operation · risk LocalWrite · contract conversation.reply

Flag	Type	Required	Notes
--text	string	yes	The person’s reply in their own words. At most 8000 characters.
--message	string (or null)		The inbox message being answered (inb_…); omitted = any open question.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me device

me device claim

A connector takes the work waiting for it (and says it is online). Run by the device itself.

Operation · risk LocalWrite · contract device.claim

Flag	Type	Required	Notes
--max	integer		Range: 1–20.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me device complete

A connector reports the outcome of work it claimed. Run by the device itself.

Operation · risk LocalWrite · contract device.complete

Flag	Type	Required	Notes
--invocation	string	yes
--ok	boolean	yes
--result	object (or null)
--error	string (or null)		At most 2000 characters.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me device get

Show one device.device by ref.

Resource · risk Read · contract device.device

Usage: me device get <ref>

me device invoke

Ask one of your own computers to do something it offers (open a page, start a Claude Desktop session, query QuickBooks Desktop). Only your devices; you approve each request (a capability can act as you on that computer), and the device’s own allowlist still applies. The result arrives as device.invocation.completed.

Operation · risk High · contract device.invoke

Flag	Type	Required	Notes
--device	string (or null)		Which of your devices; omitted: one that is online and offers the capability.
--capability	string	yes
--input	object	yes
--deadline-seconds	integer		Give up if no device has done it by then (default 600). Range: 10–86400.

Here --input sets the command’s own input field; use --input-json for the whole input.

Common options: --json, --dry-run, --idempotency-key <key>, --input-json '<json>' | - | @file, --contract <major>.

me device list

List device.device resources.

Resource · risk Read · contract device.device

Flags: --limit <n> (default 20).

me device register

A connector on a person’s computer says what it is and which capabilities it serves (run by the device itself, with its enrolment token). Repeat to update.

Operation · risk LocalWrite · contract device.register

Flag	Type	Required	Notes
--name	string	yes	At most 100 characters.
--kind	native | claude-desktop	yes
--capabilities	array<string>	yes

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me directory

me directory member leave

Record that someone left the organization: their roles end, their access to this tenant and every delegation they granted stop at once, and their open work is re-offered. Their other tenants are untouched. Needs step-up.

Operation · risk Critical · contract directory.member.leave

Flag	Type	Required	Notes
--principal	string	yes
--reason	string (or null)		At most 300 characters.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me directory org enable

Turn this tenant into an organization: members get a baseline plus what their roles allow, and you become its first admin (role:admin). Needs step-up.

Operation · risk Critical · contract directory.org.enable

No flags.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me directory role assign

Give a member a role.

Operation · risk High · contract directory.role.assign

Flag	Type	Required	Notes
--role	string	yes
--principal	string	yes

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me directory role define

Add a role to the organization’s catalog (e.g. finance-reviewer), so work can be offered to role:<name>.

Operation · risk Critical · contract directory.role.define

Flag	Type	Required	Notes
--name	string	yes
--description	string (or null)		At most 300 characters.
--allow	array<string>		Operation types (globs) the role lets its holders run in an organization.
--deny	array<string>
--max-risk	Read | LocalWrite | ExternalReversible | ExternalCommunication | High | Critical (or null)
--max-sensitivity	Public | Internal | Confidential | Restricted (or null)

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me directory role list

The organization’s roles and how many hold each.

Query · risk Read · contract directory.role.list

No flags.

Common options: --json, --input | --input-json '<json>' | - | @file.

me directory role members

Who holds a role now (people who left are excluded).

Query · risk Read · contract directory.role.members

Flag	Type	Required	Notes
--role	string	yes

Common options: --json, --input | --input-json '<json>' | - | @file.

me directory role unassign

Take a role away from a member.

Operation · risk High · contract directory.role.unassign

Flag	Type	Required	Notes
--role	string	yes
--principal	string	yes

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me mail

me mail flag

Operation · risk ExternalReversible · contract mail.flag

Flag	Type	Required	Notes
--message	string	yes
--flagged	boolean	yes

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me mail message get

Show one mail.message by ref.

Resource · risk Read · contract mail.message

Usage: me mail message get <ref>

me mail message list

List mail.message resources.

Resource · risk Read · contract mail.message

Flags: --limit <n> (default 20).

me mail move

Operation · risk ExternalReversible · contract mail.move

Flag	Type	Required	Notes
--message	string	yes
--folder	string	yes

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me mail send

Send an email from one of the tenant’s mailboxes. Normally run by the comms hub as a child of comms.send/comms.reply (ADR 0005); calling it directly needs the same approval as comms.send.

Operation · risk ExternalCommunication · contract mail.send

Flag	Type	Required	Notes
--from-channel	string	yes	The comms.channel (mailbox) to send from.
--to	array<object>	yes
--cc	array<object>
--bcc	array<object>
--subject	string	yes
--body	string	yes
--attachments	array<string>
--in-reply-to	string (or null)
--draft	string (or null)
--conversation	string (or null)
--sensitivity	Public | Internal | Confidential | Restricted		How sensitive the email is. Omitted means the contract default (Confidential): a provider not covered for it refuses the send (D-45/D-54).

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me mail subscription ensure

Make the mail provider push new mail for this connection (create the change-notification subscription, or renew it). The provider keeps it renewed with timers.

Operation · risk ExternalReversible · contract mail.subscription.ensure

Flag	Type	Required	Notes
--connection	string	yes	The mail connection whose inbox should push new mail.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me mail sync

Fetch new mail for a connected mailbox now (it also syncs every few minutes on its own). Only mail the signed-in person can open.

Operation · risk Read · contract mail.sync

Flag	Type	Required	Notes
--connection	string	yes	The mailbox (conn_… from me integration list).

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me memory

me memory accept

Keep a proposed memory (the user’s own decision).

Operation · risk LocalWrite · contract memory.accept

Flag	Type	Required	Notes
--item	string	yes

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me memory forget

Forget a memory for good: its text is erased (the user’s own decision).

Operation · risk LocalWrite · contract memory.forget

Flag	Type	Required	Notes
--item	string	yes

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me memory list

What is remembered about the user (kept memories, newest first); with lane, that area plus what applies everywhere.

Query · risk Read · contract memory.list

Flag	Type	Required	Notes
--lane	string (or null)		At most 100 characters.

Common options: --json, --input | --input-json '<json>' | - | @file.

me memory propose

Propose something to remember about the user: a fact, preference, decision, procedure or relationship (one short statement). The user’s own facts and preferences are kept at once; anything else waits for their review. A commitment becomes a task instead.

Operation · risk LocalWrite · contract memory.propose

Flag	Type	Required	Notes
--kind	fact | preference | decision | procedure | relationship | commitment	yes
--text	string	yes	At most 500 characters.
--lane	string (or null)		Area it belongs to (finance, tasks, project:Atlas …); none means everywhere. At most 100 characters.
--sensitivity	Public | Internal | Confidential | Restricted (or null)
--confidence	number (or null)		Range: 0–1.
--source	string (or null)		Where it came from (a ref or a short note). At most 200 characters.
--expires	string (or null)		Format: date-time.
--due	string (or null)		For a commitment: when it is due. Format: date-time.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me memory reject

Reject a proposed memory (the user’s own decision).

Operation · risk LocalWrite · contract memory.reject

Flag	Type	Required	Notes
--item	string	yes

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me memory review

Proposed memories waiting for the user to keep or reject.

Query · risk Read · contract memory.review

No flags.

Common options: --json, --input | --input-json '<json>' | - | @file.

me model

me model classify

Query · risk Read · contract model.classify

Flag	Type	Required	Notes
--purpose	string	yes
--text	string	yes
--labels	array<string>	yes
--sensitivity	Public | Internal | Confidential | Restricted	yes

Common options: --json, --input | --input-json '<json>' | - | @file.

me model extract

Extract structured fields matching a JSON Schema from text or an artifact, with provenance.

Query · risk Read · contract model.extract

Flag	Type	Required	Notes
--purpose	string	yes
--source	object	yes
--schema	object	yes
--sensitivity	Public | Internal | Confidential | Restricted	yes

Common options: --json, --input | --input-json '<json>' | - | @file.

me model generate

Generate text with a BAA-covered model chosen by tenant policy; input passes model.egress.filter first.

Query · risk Read · contract model.generate

Flag	Type	Required	Notes
--purpose	string	yes
--system	string (or null)
--messages	array<object>	yes
--max-tokens	integer		Range: 1–128000.
--effort	low | medium | high
--sensitivity	Public | Internal | Confidential | Restricted	yes

Common options: --json, --input | --input-json '<json>' | - | @file.

me money

me money account get

Show one money.account by ref.

Resource · risk Read · contract money.account

Usage: me money account get <ref>

me money account list

List money.account resources.

Resource · risk Read · contract money.account

Flags: --limit <n> (default 20).

me money bill create

Record a bill you expect to pay: payee, amount or estimate, due date. You’re told 3 days before it’s due and if it goes overdue.

Operation · risk LocalWrite · contract money.bill.create

Flag	Type	Required	Notes
--payee	string	yes	At most 100 characters.
--amount	string
--estimate	string
--due	string	yes	Format: date.
--currency	string (or null)

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me money bill get

Show one money.bill by ref.

Resource · risk Read · contract money.bill

Usage: me money bill get <ref>

me money bill list

List money.bill resources.

Resource · risk Read · contract money.bill

Flags: --limit <n> (default 20).

me money categorize

Put a transaction in a category (yours wins over rules).

Operation · risk LocalWrite · contract money.categorize

Flag	Type	Required	Notes
--transaction	string	yes
--category	string	yes	At most 60 characters.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me money import

Import a bank or card statement file (CSV with a header row, or OFX/QFX) into an account (CSV files name no account: give account_label). Re-importing the same lines adds nothing. Account numbers are never stored, only masked.

Operation · risk LocalWrite · contract money.import

Flag	Type	Required	Notes
--format	csv | ofx | qfx	yes
--content	string		Inline statement text, for small pasted CSVs only; files go through upload. At most 2000000 characters.
--account-label	string (or null)		Required when the file names no account (CSV); use the same label for every import of that account. At most 100 characters.
--currency	string (or null)
--upload	string (or null)		The statement file, staged in the money plugin’s storage (the CLI uploads a path given here); its raw content never enters the operation.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me money invoice get

Show one money.invoice by ref.

Resource · risk Read · contract money.invoice

Usage: me money invoice get <ref>

me money invoice ingest

Read an invoice (its text) into extracted fields with provenance; the same invoice twice is reported as a duplicate. Creates no payable until validated.

Operation · risk LocalWrite · contract money.invoice.ingest

Flag	Type	Required	Notes
--text	string	yes	At most 200000 characters.
--source	string (or null)		Where it came from (message, artifact).
--source-id	string (or null)		At most 200 characters.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me money invoice list

List money.invoice resources.

Resource · risk Read · contract money.invoice

Flags: --limit <n> (default 20).

me money invoice unreviewed

Invoices captured but not yet reviewed (validated), oldest first.

Query · risk Read · contract money.invoice.unreviewed

Flag	Type	Required	Notes
--limit	integer		At most this many invoices (default 20); count is the full number. Range: 1–50.

Common options: --json, --input | --input-json '<json>' | - | @file.

me money invoice validate

Confirm an invoice’s fields (correcting any) so it becomes a bill to pay.

Operation · risk LocalWrite · contract money.invoice.validate

Flag	Type	Required	Notes
--invoice	string	yes
--supplier	string (or null)
--total	string (or null)
--due	string (or null)		Format: date.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me money payment execute

Send a prepared payment. Moves money: needs step-up approval with your passkey, never an agent alone. Restate the prepared amount and payee; a mismatch moves nothing. Runs exactly once.

Operation · risk Critical · contract money.payment.execute

Flag	Type	Required	Notes
--payment	string	yes
--amount	string	yes	The prepared amount, restated: the passkey approval shows it and binds it.
--payee	string	yes	The prepared payee, restated exactly. At most 100 characters.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me money payment get

Show one money.payment by ref.

Resource · risk Read · contract money.payment

Usage: me money payment get <ref>

me money payment list

List money.payment resources.

Resource · risk Read · contract money.payment

Flags: --limit <n> (default 20).

me money payment prepare

Prepare a payment for a bill or payee (no money moves). Needs your approval; the amount and payee are fixed from then on.

Operation · risk High · contract money.payment.prepare

Flag	Type	Required	Notes
--bill	string (or null)
--payee	string (or null)		At most 100 characters.
--amount	string

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me money rule create

Categorize every transaction whose description contains the text (now and on future imports).

Operation · risk LocalWrite · contract money.rule.create

Flag	Type	Required	Notes
--match	string	yes	At most 100 characters.
--category	string	yes	At most 60 characters.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me money spend

Money out in a month (YYYY-MM), grouped by category or payee, per currency, as decimal strings.

Query · risk Read · contract money.spend

Flag	Type	Required	Notes
--month	string (or null)
--by	category | payee

Common options: --json, --input | --input-json '<json>' | - | @file.

me money transaction get

Show one money.transaction by ref.

Resource · risk Read · contract money.transaction

Usage: me money transaction get <ref>

me money transaction list

List money.transaction resources.

Resource · risk Read · contract money.transaction

Flags: --limit <n> (default 20).

me note

me note create

Write a note, optionally about other resources.

Operation · risk LocalWrite · contract note.create

Flag	Type	Required	Notes
--body	string	yes	At most 100000 characters.
--title	string (or null)		At most 300 characters.
--about	array<string>
--tags	array<string>

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me note get

Show one note.note by ref.

Resource · risk Read · contract note.note

Usage: me note get <ref>

me note list

List note.note resources.

Resource · risk Read · contract note.note

Flags: --limit <n> (default 20).

me note update

Replace a note’s title or body.

Operation · risk LocalWrite · contract note.update

Flag	Type	Required	Notes
--note	string	yes
--body	string		At most 100000 characters.
--title	string (or null)		At most 300 characters.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me notify

me notify acknowledge

Mark a message in your inbox as seen. Acknowledging is not approving anything.

Operation · risk LocalWrite · contract notify.acknowledge

Flag	Type	Required	Notes
--message	string	yes	The inbox message (inb_…).

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me notify request

Inform a person for a purpose. Carries intent, never a message body (D-30); the router picks the channel. local_write covers recipients with a principal in this tenant only: a recipient outside the tenant is delivered through comms.send (external_communication, evidence binds the composed words, spec 05 §5.12), never straight through notify.channel.

Operation · risk LocalWrite · contract notify.request

Flag	Type	Required	Notes
--recipient	string	yes
--purpose	string	yes
--urgency	low | normal | high | critical	yes
--sensitivity	Public | Internal | Confidential | Restricted	yes
--subject	array<string>
--facts	object
--desired-outcome	string (or null)
--response-schema	object (or null)
--requires-authenticated-response	boolean

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me notify verification

Deliver a verification code to an address (a fixed message, never composed). Used by person.identity.verify.

Operation · risk LocalWrite · contract notify.verification

Flag	Type	Required	Notes
--endpoint	string	yes
--code	string	yes

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me person

me person create

Add a person to the directory, optionally with their identities (email addresses, phone numbers).

Operation · risk LocalWrite · contract person.create

Flag	Type	Required	Notes
--display-name	string	yes	At most 200 characters.
--given-name	string (or null)
--family-name	string (or null)
--notes	string (or null)		At most 4000 characters.
--identities	array<object>
--principal	string (or null)		Link this person to a principal: only yourself (“this is me”).

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me person endpoint address

For channel plugins delivering to an endpoint: the raw address behind an opaque endpoint id.

Query · risk Read · contract person.endpoint.address

Flag	Type	Required	Notes
--endpoint	string	yes

Common options: --json, --input | --input-json '<json>' | - | @file.

me person endpoints

Disclosure-safe contact routes for a person for a purpose and sensitivity (never raw secrets).

Query · risk Read · contract person.endpoints

Flag	Type	Required	Notes
--person	string	yes
--purpose	string	yes
--sensitivity	Public | Internal | Confidential | Restricted	yes

Common options: --json, --input | --input-json '<json>' | - | @file.

me person get

Show one person.person by ref.

Resource · risk Read · contract person.person

Usage: me person get <ref>

me person identity add

Attach an identity (email address, phone number, chat id) to a person. An identity belongs to at most one person.

Operation · risk LocalWrite · contract person.identity.add

Flag	Type	Required	Notes
--person	string	yes
--kind	email | phone | chat | payee | other	yes
--value	string	yes	At most 320 characters.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me person identity get

Show one person.identity by ref.

Resource · risk Read · contract person.identity

Usage: me person identity get <ref>

me person identity list

List person.identity resources.

Resource · risk Read · contract person.identity

Flags: --limit <n> (default 20).

me person identity verify

Prove an address is reachable: without a code, a 6-digit code is sent to it (valid 10 minutes); with the code, the identity becomes verified. Only verified addresses receive notifications.

Operation · risk LocalWrite · contract person.identity.verify

Flag	Type	Required	Notes
--identity	string	yes	The identity (address) to verify.
--code	string (or null)		Omit to send a code to the address; give the code you received to confirm.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me person list

List person.person resources.

Resource · risk Read · contract person.person

Flags: --limit <n> (default 20).

me person resolve

Resolve a raw identity (email address, phone number, chat id) to a person, with confidence and evidence.

Query · risk Read · contract person.resolve

Flag	Type	Required	Notes
--kind	email | phone | chat | payee | other	yes
--value	string	yes

Common options: --json, --input | --input-json '<json>' | - | @file.

me person update

Change a person’s names or notes.

Operation · risk LocalWrite · contract person.update

Flag	Type	Required	Notes
--person	string	yes
--display-name	string		At most 200 characters.
--given-name	string (or null)
--family-name	string (or null)
--notes	string (or null)		At most 4000 characters.
--principal	string (or null)		Link this person to a principal: only yourself (“this is me”).

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me presence

me presence get

Availability signals for a principal (calendar busy, chat status, quiet hours), merged by the caller.

Query · risk Read · contract presence.get

Flag	Type	Required	Notes
--principal	string	yes

Common options: --json, --input | --input-json '<json>' | - | @file.

me schedule

me schedule create

Create a recurring schedule from an RFC 5545 RRULE in an IANA time zone. Each occurrence publishes schedule.occurrence.due (once per planned time); workflows, triggers and series react to it.

Operation · risk LocalWrite · contract schedule.create

Flag	Type	Required	Notes
--rrule	string	yes	e.g. FREQ=WEEKLY;BYDAY=FR;BYHOUR=16;BYMINUTE=0
--start	string	yes	Local wall-clock start, e.g. 2026-10-23T16:00 (first possible occurrence).
--timezone	string	yes	IANA zone, e.g. America/New_York.
--misfire	skip | run_once | latest_only | catch_up		Occurrences missed while the system was down: skip them, run once, run only the latest, or run each (default run_once).
--title	string (or null)		At most 200 characters.
--subject	string (or null)		What the schedule is for (e.g. a task series); copied onto each occurrence.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me schedule delete

Delete a schedule for good: no further occurrences.

Operation · risk LocalWrite · contract schedule.delete

Flag	Type	Required	Notes
--schedule	string	yes	The schedule (sch_…).

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me schedule get

Show one schedule.schedule by ref.

Resource · risk Read · contract schedule.schedule

Usage: me schedule get <ref>

me schedule list

List schedule.schedule resources.

Resource · risk Read · contract schedule.schedule

Flags: --limit <n> (default 20).

me schedule pause

Pause a schedule: no occurrences until it is resumed (missed ones are not replayed).

Operation · risk LocalWrite · contract schedule.pause

Flag	Type	Required	Notes
--schedule	string	yes	The schedule (sch_…).

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me schedule resume

Resume a paused schedule from the next occurrence after now.

Operation · risk LocalWrite · contract schedule.resume

Flag	Type	Required	Notes
--schedule	string	yes	The schedule (sch_…).

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me schedule skip

Skip the schedule’s next occurrence; the one after it is planned instead.

Operation · risk LocalWrite · contract schedule.skip

Flag	Type	Required	Notes
--schedule	string	yes	The schedule (sch_…).

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me search

me search query

Find anything by text (spec 05 section 5.10): tasks, notes, messages, people… ranked, with refs. Lexical (Postgres full-text) in v1.

Query · risk Read · contract search.query

Flag	Type	Required	Notes
--q	string	yes	At most 500 characters.
--types	array<string>
--limit	integer		Range: 1–50.

Common options: --json, --input | --input-json '<json>' | - | @file.

me session

me session external get

Show one session.external by ref.

Resource · risk Read · contract session.external

Usage: me session external get <ref>

me session external import

Import (or refresh) a session from an external AI tool so it can be found later. me session import claude-code does this for local Claude Code transcripts.

Operation · risk LocalWrite · contract session.external.import

Flag	Type	Required	Notes
--source	claude-code	yes
--external-id	string	yes	At most 200 characters.
--title	string	yes	At most 200 characters.
--project	string (or null)		At most 500 characters.
--started-at	string (or null)		Format: date-time.
--ended-at	string (or null)		Format: date-time.
--messages	integer (or null)		Range: 0–….
--text	string (or null)		What the person typed in the session (not tool output), for search. At most 20000 characters.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me session external list

List session.external resources.

Resource · risk Read · contract session.external

Flags: --limit <n> (default 20).

me session line disable

Stop the system answering your texts to its own number.

Operation · risk LocalWrite · contract session.line.disable

No flags.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me session line enable

Let the system answer your texts to its own number (from your verified phone), using what it knows about you. It answers; it never acts on a text.

Operation · risk LocalWrite · contract session.line.enable

No flags.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me session line respond

Answer one text the person sent to the system’s number (run by their standing order, as them): it first answers their open asks, then their question.

Operation · risk LocalWrite · contract session.line.respond

Flag	Type	Required	Notes
--message	string	yes
--conversation	string (or null)
--text	string	yes	At most 2000 characters.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me session list

Your recent sessions (one per Claude Code session, terminal or conversation), most recent first, with their state and lanes. Nobody has to create, name or close them.

Query · risk Read · contract session.list

Flag	Type	Required	Notes
--limit	integer (or null)		Range: 1–100.
--all	boolean (or null)		Include archived sessions.

Common options: --json, --input | --input-json '<json>' | - | @file.

me session show

One of your sessions: its segments by lane and what was done in each.

Query · risk Read · contract session.show

Flag	Type	Required	Notes
--session	string	yes

Common options: --json, --input | --input-json '<json>' | - | @file.

me sms

me sms message get

Show one sms.message by ref.

Resource · risk Read · contract sms.message

Usage: me sms message get <ref>

me sms message list

List sms.message resources.

Resource · risk Read · contract sms.message

Flags: --limit <n> (default 20).

me sms send

Send an SMS/MMS from one of the tenant’s numbers. Normally run by the comms hub as a child of comms.send/comms.reply (ADR 0005); calling it directly needs the same approval as comms.send.

Operation · risk ExternalCommunication · contract sms.send

Flag	Type	Required	Notes
--from-channel	string	yes	The comms.channel (number) to send from.
--to	object	yes
--text	string	yes	At most 1600 characters.
--media	array<string>
--draft	string (or null)
--conversation	string (or null)
--sensitivity	Public | Internal | Confidential | Restricted		How sensitive the text is. Omitted means the contract default (Confidential): a provider not covered for it refuses the send (D-45/D-54).

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me task

me task complete

Operation · risk LocalWrite · contract task.complete

Flag	Type	Required	Notes
--task	string	yes

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me task create

Create a task. Idempotent on idempotency key.

Operation · risk LocalWrite · contract task.create

Flag	Type	Required	Notes
--title	string	yes	At most 500 characters.
--notes	string (or null)
--due	string (or null)		Format: date-time.
--priority	integer		Range: 0–3.
--project	string (or null)
--about	array<string>
--tags	array<string>

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me task delegate

Hand a task to a person or agent: they get a work item; the task waits on them and completes when they complete it.

Operation · risk LocalWrite · contract task.delegate

Flag	Type	Required	Notes
--task	string	yes
--to	string	yes
--due	string (or null)		Format: date-time.
--remind-after	string (or null)
--escalate-to	string (or null)

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me task get

Show one task.task by ref.

Resource · risk Read · contract task.task

Usage: me task get <ref>

me task list

List task.task resources.

Resource · risk Read · contract task.task

Flags: --limit <n> (default 20).

me task review

What a weekly review looks at: overdue open tasks, tasks waiting on someone, and projects with open tasks but no activity for stalled_days.

Query · risk Read · contract task.review

Flag	Type	Required	Notes
--stalled-days	integer		A project is stalled when none of its open tasks changed for this many days (default 14). Range: 1–365.
--limit	integer		At most this many entries per list (default 20). Range: 1–50.

Common options: --json, --input | --input-json '<json>' | - | @file.

me task series create

Create a recurring task: one task instance per occurrence of an RFC 5545 RRULE in an IANA time zone, due at the occurrence. Mode fixed: instances follow the schedule whether or not earlier ones are done.

Operation · risk LocalWrite · contract task.series.create

Flag	Type	Required	Notes
--title	string	yes	At most 500 characters.
--notes	string (or null)
--rrule	string	yes	e.g. FREQ=WEEKLY;BYDAY=FR;BYHOUR=9;BYMINUTE=0
--start	string	yes	Local wall-clock time of the first possible instance, e.g. 2026-10-23T09:00.
--timezone	string	yes	IANA zone, e.g. America/New_York.
--mode	fixed		fixed (default). after_completion is planned.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me task series delete

Stop a recurring task for good: no new instances (existing tasks stay).

Operation · risk LocalWrite · contract task.series.delete

Flag	Type	Required	Notes
--series	string	yes

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me task series get

Show one task.series by ref.

Resource · risk Read · contract task.series

Usage: me task series get <ref>

me task series list

List task.series resources.

Resource · risk Read · contract task.series

Flags: --limit <n> (default 20).

me task series pause

Pause a task series: no new instances until resumed.

Operation · risk LocalWrite · contract task.series.pause

Flag	Type	Required	Notes
--series	string	yes	The task series (tser_…).

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me task series resume

Resume a paused task series from its next occurrence.

Operation · risk LocalWrite · contract task.series.resume

Flag	Type	Required	Notes
--series	string	yes	The task series (tser_…).

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me task series skip

Skip the next instance of a task series.

Operation · risk LocalWrite · contract task.series.skip

Flag	Type	Required	Notes
--series	string	yes	The task series (tser_…).

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me teams

me teams sync

Fetch new Teams chat and channel messages for a connected account now (it also syncs every few minutes on its own). Only messages the signed-in person can see.

Operation · risk Read · contract teams.sync

Flag	Type	Required	Notes
--connection	string	yes	The Teams account (conn_… from me integration list).

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me transcribe

me transcribe audio

Transcribe an audio artifact; the transcript inherits the audio’s sensitivity.

Query · risk Read · contract transcribe.audio

Flag	Type	Required	Notes
--audio	string	yes
--language	string (or null)
--sensitivity	Public | Internal | Confidential | Restricted	yes

Common options: --json, --input | --input-json '<json>' | - | @file.

me trigger

me trigger create

When an event happens (optionally matching a JSON Logic condition), run an operation as you. Only local writes; each event fires once; a trigger never re-fires on what its own action caused.

Operation · risk LocalWrite · contract trigger.create

Flag	Type	Required	Notes
--event	task.created | task.completed | note.created | comms.message.received | comms.reply.overdue | comms.followup.due | mail.message.received | sms.message.received | call.missed | call.voicemail.received | person.created | schedule.occurrence.due | money.transaction.posted | money.transaction.unusual | money.bill.due_soon | money.bill.overdue | money.invoice.detected | money.invoice.validated | money.invoice.duplicate | money.payment.prepared | money.payment.executed | attention.raised	yes	The event that fires it.
--when	object (or null)		JSON Logic over {type, subject, data} of the event; omitted = every event.
--do	task.create | task.complete | note.create | comms.followup.set | comms.draft.create | notify.request | user.tag | user.pin | user.snooze	yes	The operation to run, as the person who set the trigger up.
--input	object		Its input. A string value “{{data.x}}” is replaced by that event field (a whole-string placeholder keeps the field’s JSON type).
--title	string (or null)		At most 200 characters.

Here --input sets the command’s own input field; use --input-json for the whole input.

Common options: --json, --dry-run, --idempotency-key <key>, --input-json '<json>' | - | @file, --contract <major>.

me trigger delete

Delete a trigger: it stops firing and its standing order is revoked.

Operation · risk LocalWrite · contract trigger.delete

Flag	Type	Required	Notes
--trigger	string	yes	The trigger (trg_…).

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me trigger get

Show one trigger.trigger by ref.

Resource · risk Read · contract trigger.trigger

Usage: me trigger get <ref>

me trigger list

List trigger.trigger resources.

Resource · risk Read · contract trigger.trigger

Flags: --limit <n> (default 20).

me user

me user pin

Pin or unpin any resource.

Operation · risk LocalWrite · contract user.pin

Flag	Type	Required	Notes
--resource	string	yes
--pinned	boolean

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me user snooze

Snooze any resource until a time (null to wake it).

Operation · risk LocalWrite · contract user.snooze

Flag	Type	Required	Notes
--resource	string	yes
--until	string (or null)		Format: date-time.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me user tag

Add or remove the user’s tags on any resource.

Operation · risk LocalWrite · contract user.tag

Flag	Type	Required	Notes
--resource	string	yes
--add	array<string>
--remove	array<string>

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me work

me work cancel

Withdraw an item you delegated.

Operation · risk LocalWrite · contract work.cancel

Flag	Type	Required	Notes
--work	string	yes	The work item (wrk_…).

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me work claim

Take an item offered to you.

Operation · risk LocalWrite · contract work.claim

Flag	Type	Required	Notes
--work	string	yes	The work item (wrk_…).

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me work complete

Finish an item assigned to you, with its response.

Operation · risk LocalWrite · contract work.complete

Flag	Type	Required	Notes
--work	string	yes	The work item (wrk_…).
--response	object

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me work decline

Decline an item assigned to you.

Operation · risk LocalWrite · contract work.decline

Flag	Type	Required	Notes
--work	string	yes	The work item (wrk_…).
--reason	string (or null)		At most 500 characters.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me work item get

Show one work.item by ref.

Resource · risk Read · contract work.item

Usage: me work item get <ref>

me work item list

List work.item resources.

Resource · risk Read · contract work.item

Flags: --limit <n> (default 20).

me work offer

Delegate a piece of work to a person or agent in this tenant: they are told (the conversation layer writes it), can claim, complete with a response, or decline; reminders, expiry and escalation follow the deadline.

Operation · risk LocalWrite · contract work.offer

Flag	Type	Required	Notes
--work-type	string	yes	At most 100 characters.
--outcome	string	yes	What done looks like. At most 2000 characters.
--assignee	string	yes	Principal (person or agent) to do it, or role:<name> to offer it to whoever holds that role (least loaded first, never the requester).
--subject	array<string>		What it is about (task, message, invoice…).
--due	string (or null)		Format: date-time.
--remind-after	string (or null)		ISO 8601 duration, e.g. PT4H.
--escalate-to	string (or null)		Reassign here at the due time if still open.
--response-schema	object (or null)		What completing it must return.
--sensitivity	Public | Internal | Confidential | Restricted

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me work queue

Open work items assigned to you (or the person you act for), soonest due first.

Query · risk Read · contract work.queue

Flag	Type	Required	Notes
--principal	string (or null)

Common options: --json, --input | --input-json '<json>' | - | @file.

me work reassign

Give an item you delegated to someone else.

Operation · risk LocalWrite · contract work.reassign

Flag	Type	Required	Notes
--work	string	yes	The work item (wrk_…).
--to	string	yes

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me workflow

me workflow cancel

Cancel a running workflow run; steps already done stay done.

Operation · risk LocalWrite · contract workflow.cancel

Flag	Type	Required	Notes
--run	string	yes	The run (wfr_…).

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me workflow definition get

Show one workflow.definition by ref.

Resource · risk Read · contract workflow.definition

Usage: me workflow definition get <ref>

me workflow definition list

List workflow.definition resources.

Resource · risk Read · contract workflow.definition

Flags: --limit <n> (default 20).

me workflow execution get

Show one workflow.execution by ref.

Resource · risk Read · contract workflow.execution

Usage: me workflow execution get <ref>

me workflow execution list

List workflow.execution resources.

Resource · risk Read · contract workflow.execution

Flags: --limit <n> (default 20).

me workflow publish

Publish a new immutable version of a workflow: sequential steps (operations as you, bounded reads as you, timers, waits for events) started by a trigger event or by workflow.run. Steps may only run local writes.

Operation · risk LocalWrite · contract workflow.publish

Flag	Type	Required	Notes
--definition	object	yes	{name, trigger?: {event, when?}, steps: [{id, when?, for_each?, operation: {type, input} | query: {name, input} | timer: {duration} | wait_event: {event, correlate?, timeout?}}]}. Values may use {{trigger.data.x}}, {{input.x}}, {{steps.<id>.output.x}} and, in a for_each step (a JSON Logic list), {{item.x}} and {{index}}; conditions are JSON Logic. Query steps read as you; their results feed later steps and are not recorded in the run.

Common options: --json, --dry-run, --idempotency-key <key>, --input | --input-json '<json>' | - | @file, --contract <major>.

me workflow run

Start a run of a published workflow now.

Operation · risk LocalWrite · contract workflow.run

Flag	Type	Required	Notes
--workflow	string	yes	Workflow name (its active version) or definition ref (wfd_…).
--input	object		Available to steps as {{input.x}}.

Here --input sets the command’s own input field; use --input-json for the whole input.

Common options: --json, --dry-run, --idempotency-key <key>, --input-json '<json>' | - | @file, --contract <major>.