Step-by-step scenarios

Each scenario is a common task in order: the commands to run, why each one runs and what to look at in the answer. The same scenarios are in the terminal: max guide lists them and max guide <name> prints one.

Commands that use an account start with your profile, the name you gave the account at login: max <profile> ….

Let an agent read MAX on a timerCopy Anchor Link

Get a summary of what needs your answer every morning, from an agent that cannot send.

1. Copy Text

   max schedule command sync-chats --every 2h -- messages sync --all

   keeps every chat's history in the local store up to date, so the agent reads it offline

2. Copy Text

   max schedule agent morning claude "run the daily follow-up review: max skill show follow-ups" --at 08:30

   starts the agent at 08:30 with MAX_READ_ONLY=1, so it reads and drafts and never sends

3. Copy Text

   max schedule list

   when each schedule runs next and how its last run went

What to look at:

• the last run's status for both schedules
• the agent's kept answer, and the notification that it is ready

The agent runs under the lock, so any send it tries is refused before MAX is reached. Remove a schedule with max schedule remove <name>.

In the terminal: max guide agent-on-a-timer

Catch up after a day awayCopy Anchor Link

Know who waits on you and what you promised, without opening every chat.

1. Copy Text

   max review 'date>1d' --unanswered 4h

   questions to you that nobody answered for four hours, across every chat

2. Copy Text

   max inbox --new

   other people's messages that arrived since your last check, each one once

3. Copy Text

   max tasks list

   questions, requests and promises the review kept, oldest first

What to look at:

• who asked first and how long ago
• tasks whose source message is a promise of yours

review and inbox read MAX and save what they read, so tasks list and later searches work from the local store. Add --offline to any of them to read only what is already saved.

In the terminal: max guide catch-up

Find what someone saidCopy Anchor Link

Get back a message, a file or a voice note when you remember only a word or the person.

1. Copy Text

   max search all "invoice"

   messages, notes, the text of files and voice transcripts in one search, best match first

2. Copy Text

   max contacts timeline Anna

   everything one person wrote or was mentioned in, newest first, from the store

3. Copy Text

   max messages context Team 1234

   the message a hit points to, with what came either side of it

What to look at:

• the chat and the time of each hit
• the msg locator, to cite it or to open the message

A search finds only what the store holds. Run max messages sync --all once, or max schedule command on a timer, so older history is there to find.

In the terminal: max guide find-what-was-said

Post as your botCopy Anchor Link

Send a message to a group as your bot, through MAX's official Bot API, not from your own account.

1. Copy Text

   max bot auth set

   checks the bot's token with MAX and keeps it; type it at the hidden prompt or pipe it on stdin

2. Copy Text

   max bot chats list

   the chats this bot has seen on this machine, to pick the one to write to

3. Copy Text

   max bot messages send Team "the release is out"

   sends the message as the bot; without the text it is read from stdin

What to look at:

• which bot bot auth set names, before anything is sent
• the message id the send returns, to edit or pin it later

A bot needs its own token from MAX; your personal login is not used. max bot recipients add limits which chats the bot may write to.

In the terminal: max guide post-as-a-bot

Works with other toolsCopy Anchor Link

These Memo scenarios also use max:

• One person across every tool: memo guide person-brief