Repository navigation
commands
Справочник: каждая команда, каждая опция, каждый код возврата. Страница собирается из самой программы, поэтому описать версию, которой не существует, она не может.
chats send-as и --send-as пока недоступны для MAX: команда откажет до отправки.
Как устроена строка:
max [профиль] [опции] <команда> <действие> [аргументы]Первое слово — профиль, если оно не совпадает с именем команды: max personal chats list
читает чаты профиля personal. То же самое говорит переменная MAX_PROFILE на весь сеанс
оболочки, а defaultProfile в файле настроек — насовсем (max config set defaultProfile personal).
Профиль никогда не подразумевается: если его не назвать, команда, которой нужен аккаунт,
останавливается и перечисляет профили этого компьютера — даже если профиль один. Первый вход тоже
с именем: max personal setup. Без профиля работают только команды, которым аккаунт не нужен:
--help, --version, commands, skill show, account list, config show.
⚠ Описания команд и опций ниже — ровно те, что печатает max --help, то есть по-английски. Это
не недоработка перевода: текст живёт в программе, и второй его копии здесь быть не должно.
Действуют на любую команду.
| Опция | Что делает |
|---|---|
-V, --version |
output the version number. |
-v, --verbose |
more detail in what is shown: -v ids, -vv everything we know. По умолчанию: 0. |
--json |
machine-readable output: one JSON value on stdout; --json=id,text keeps only those fields. |
--jsonl |
machine-readable output: one JSON object per line, for streaming and jq. |
--quiet |
diagnostics off. |
--trace |
one line per request on stderr: ids and timings, never message content. |
--debug |
on a failure, its whole record — cause and stack — in place of the short line. |
--timeout <duration> |
give up on the whole command after this — 30s, 2m, 500ms. |
--offline |
answer from what was recorded and never connect; fails if nothing was. |
--no-input |
never prompt or open interactive login; piped input remains available. |
--max-input-bytes <bytes> |
maximum buffered input bytes (default: 16777216). |
--max-output-bytes <bytes> |
maximum machine output bytes (default: 4194304; 0 disables). |
--brief |
found messages and mail as reference, title, time, sender and excerpt only. |
--full |
found messages and mail with their whole text and every provider field. |
--dry-run |
preview parsed arguments and permissions before running the action. |
--yes |
go ahead without the question an ask level puts before a write. |
--record |
keep this run under max runs — ids and timings, never message content. |
--no-record |
do not keep it, whatever the configuration says. |
--serve |
start max serve in the background if it is not running (the default). |
--no-serve |
do not start it; log in on this command's own connection unless one is running. |
the stored MAX session for this profile
log this profile in to MAX
max session start [method]| Аргумент | Что это | |
|---|---|---|
method |
необязательный | token (pasted or piped), qr, qr-chrome or sms. Одно из: token, qr, qr-chrome, sms. По умолчанию: token. |
log this profile out on MAX's side and forget the session here
Меняет что-то в MAX.
max session endset up your personal MAX account and connect your agent
Меняет что-то в MAX.
max setup [options]| Опция | Что делает |
|---|---|
--agent <agent> |
install the skill for this agent; asks at a terminal, otherwise none. Одно из: none, codex, cursor, claude, gemini, all. |
--method <method> |
how to log in when there is no session. Одно из: token, qr, qr-chrome, sms. По умолчанию: qr. |
the logged-in account
every profile on this computer, and the account each is logged in as; asks the messenger nothing
max account listwho this profile is logged in as; the phone number shows its last four digits
max account show [options]| Опция | Что делает |
|---|---|
--show-phone |
print the whole phone number. |
change the name, the description or the photo everyone sees on your profile
Меняет что-то в MAX.
max account update [options]| Опция | Что делает |
|---|---|
--first-name <name> |
your first name. |
--last-name <name> |
your last name. |
--description <text> |
about you. |
--photo <file> |
a new profile photo — an image file. |
where else this account is logged in — not max session, which is this tool's own login
every device and app logged in to this account; nothing is ended
max account sessions listlog out every other device, your phone included; this one stays
Меняет что-то в MAX.
max account sessions end [options]| Опция | Что делает |
|---|---|
--others |
every session but this one. |
who may find, call or add the account
the account's privacy settings; reading changes nothing
max account privacy showchange who may find, call or add the account; the settings not named stay
Меняет что-то в MAX.
max account privacy set [options]| Опция | Что делает |
|---|---|
--find-by-phone <who> |
who finds the account by its number: everyone, contacts or nobody. |
--phone-number <who> |
who sees the number: everyone, contacts or nobody. |
--calls <who> |
who may call: everyone, contacts or nobody. |
--chat-invites <who> |
who may add the account to groups and channels: everyone, contacts or nobody. |
--hide-online <on|off> |
hide online status and last seen. |
the account's calls
calls made and received, newest first; reading changes nothing
max calls list [options]| Опция | Что делает |
|---|---|
--limit <n> |
how many to show. |
the stickers the account has added
sticker sets, or with --set the stickers in one; reading changes nothing
max stickers list [options]| Опция | Что делает |
|---|---|
--set <id> |
the stickers in this set. |
the chats this account is in
chats, newest first, archived ones included
max chats list [options]| Опция | Что делает |
|---|---|
--limit <n> |
how many to show. |
--page <n> |
which page, starting at 1. |
--all |
every row, no paging. |
--search <text> |
only chats whose name contains this; at least 3 characters. |
--kind <kind> |
only chats of this kind: dialog, group, channel, saved. |
--unread |
only chats with unread messages. |
one chat: its kind, unread count, last message time and who is in it
max chats show <chat>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
who joined, left, was added or removed, and by whom — from the chat's service messages
max chats events <chat> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
| Опция | Что делает |
|---|---|
--since-time <time> |
ISO 8601, or 2h / 1d ago; 7 days ago if not given. |
--type <names> |
only these, comma-separated: join, leave, add, remove, create, title, pin. |
what an invite or public link leads to, without joining it
max chats inspect <link>| Аргумент | Что это | |
|---|---|---|
link |
обязательный | an invite link or a public one. |
join a group or channel by its link; the others in it see that you joined
Меняет что-то в MAX.
max chats join <link>| Аргумент | Что это | |
|---|---|---|
link |
обязательный | an invite link, or a public one. |
mark a chat read; the other side sees that you read it
Меняет что-то в MAX.
max chats mark-read <chat> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
| Опция | Что делает |
|---|---|
--until <message> |
only up to this message id; the newest by default. |
--topic <id> |
mark only this forum topic read; unsupported by messengers without topics. |
leave a group or channel; the others in it see that you left
Меняет что-то в MAX.
max chats leave <chat>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
create a group or a channel; the people added are told
Меняет что-то в MAX.
max chats create <title> [person] [options]| Аргумент | Что это | |
|---|---|---|
title |
обязательный | the group's name. |
person |
необязательный | people to add: an id, or part of a name. |
| Опция | Что делает |
|---|---|
--channel |
a private channel instead of a group; people join it by its link. |
who is in a group
everyone in a group, a page at a time, with their role and when they were last seen
max chats members list <chat> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
| Опция | Что делает |
|---|---|
--limit <n> |
how many to show. |
--page <n> |
which page, starting at 1. |
--all |
every row, no paging. |
members that look like bots, each with its reasons — read from the member list and the local store; never one request per person, and it removes nobody
max chats members audit <chat> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
| Опция | Что делает |
|---|---|
--budget <pages> |
at most this many pages of 200 members, a pause between them (default: 10). |
--min-score <n> |
only members scoring at least this; 1 lists everyone with a reason (default: 2). |
--deep <n> |
also check the top n in full — profile, photos and everything they wrote — one person a second; the public ban lists cover Telegram only, so nothing is sent. |
who joined, who left and whose profile changed, oldest first — what chats members fetch recorded in the local store; never asks the messenger
max chats members history <chat> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
| Опция | Что делает |
|---|---|
--since-time <time> |
ISO 8601, or 2h / 1d ago; everything recorded if not given. |
read a group's whole member list into the local store's member history: who joined, who left, daily counts and profile changes; someone is recorded as gone only when every member was read
max chats members fetch <chat> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
| Опция | Что делает |
|---|---|
--track |
also fetch it daily while serve runs; chats tracking lists and edits those chats. |
--budget <pages> |
at most this many pages of 200 members, a pause between them (default: 10). |
add people; they are told
Меняет что-то в MAX.
max chats members add <chat> <person> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
person |
обязательный | an id, or part of a name. |
| Опция | Что делает |
|---|---|
--history |
the people added also see the messages from before they came. |
remove people; their messages stay
Меняет что-то в MAX.
max chats members remove <chat> <person>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
person |
обязательный | an id, or part of a name. |
the chats whose member lists serve fetches daily into the local store — chats members fetch --track adds one
every tracked chat: since when, and its last member count
max chats tracking listone chat: whether it is tracked, and its member count per day for the last 30 days
max chats tracking show <chat>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
fetch this chat's member list daily while serve runs, from its next run
max chats tracking add <chat>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
stop fetching it daily; the history already kept stays
max chats tracking remove <chat>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
give or take back a member's admin rights
make a member an admin with these rights
Меняет что-то в MAX.
max chats admins add <chat> <person> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
person |
обязательный | an id, or part of a name. |
| Опция | Что делает |
|---|---|
--can <rights> |
what they may do, comma-separated: read, members, admins, info, pin, link, post, edit, delete. |
take an admin's rights back; they stay a member
Меняет что-то в MAX.
max chats admins remove <chat> <person>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
person |
обязательный | an id, or part of a name. |
rename a group or channel, change its description, or turn one of its settings on or off
Меняет что-то в MAX.
max chats update <chat> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
| Опция | Что делает |
|---|---|
--title <title> |
the new name. |
--description <text> |
the new description. |
--photo <file> |
a new photo for it — an image file. |
--all-can-pin <on|off> |
every member may pin messages. |
--only-admins-add <on|off> |
only admins may add members. |
--only-admins-call <on|off> |
only admins may start a call. |
--only-owner-edits-info <on|off> |
only the owner may change the name and photo. |
--members-see-link <on|off> |
members may see the invite link. |
a group's invite link
the invite link, if you may see it
max chats link show <chat>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
replace the invite link; the old one stops working
Меняет что-то в MAX.
max chats link reset <chat>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
requests to join a MAX channel needing approval
pending requests to join a MAX channel needing approval; admins only; requestedAt is null
max chats requests list <chat> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
| Опция | Что делает |
|---|---|
--limit <n> |
how many. |
--search <text> |
only people whose name or @username has this. |
--link <link> |
not supported by MAX; use name search instead. |
let them in; the group sees them join
Меняет что-то в MAX.
max chats requests accept <chat> [person] [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
person |
необязательный | who asked: an id from chats requests list. |
| Опция | Что делает |
|---|---|
--all |
not supported by MAX; select one person from chats requests list. |
--link <link> |
not supported by MAX; select one person from chats requests list. |
turn the request away
Меняет что-то в MAX.
max chats requests decline <chat> [person] [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
person |
необязательный | who asked: an id from chats requests list. |
| Опция | Что делает |
|---|---|
--all |
not supported by MAX; select one person from chats requests list. |
--link <link> |
not supported by MAX; select one person from chats requests list. |
your chat folders
your chat folders, in the order the app shows them
max chats folders listone chat folder, with the names of the chats in it
max chats folders show <folder>| Аргумент | Что это | |
|---|---|---|
folder |
обязательный | the folder's id, or its title exactly. |
create a chat folder
Меняет что-то в MAX.
max chats folders create <title> [options]| Аргумент | Что это | |
|---|---|---|
title |
обязательный | the folder's name; the app may refuse a long one. |
| Опция | Что делает |
|---|---|
--chat <chat> |
a chat to put in it, by id or name; repeat it for more. |
rename a folder, or change which chats are in it
Меняет что-то в MAX.
max chats folders update <folder> [options]| Аргумент | Что это | |
|---|---|---|
folder |
обязательный | folder id, or its title exactly. |
| Опция | Что делает |
|---|---|
--title <title> |
a new name. |
--add <chat> |
put a chat in it; repeat it for more. |
--remove <chat> |
take a chat out of it, and off its excluded and pinned lists; repeat it for more. |
delete a folder; the chats in it stay
Меняет что-то в MAX.
max chats folders delete <folder>| Аргумент | Что это | |
|---|---|---|
folder |
обязательный | folder id, or its title exactly. |
put folders in this order; the ones not named keep theirs after them
Меняет что-то в MAX.
max chats folders order <folders>| Аргумент | Что это | |
|---|---|---|
folders |
обязательный | folder ids, or titles exactly, first one first. |
what chats moderate judges a group by, kept in a file of this profile
the group's rules; the defaults, marked not saved, if it has none yet
max chats rules show <chat>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
change one rule; the group's first change writes every rule with its default
Меняет что-то только на этом компьютере.
max chats rules set <chat> <key> <value>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
key |
обязательный | one of: trusted, blocked, blockedNames, links, invites, forwards, blockedPeople, flood.messages, flood.minutes, flood.action, newAccount.days, newAccount.action, consent.delete, consent.remove. |
value |
обязательный | the new value; a list is comma-separated. |
put one rule back to its default
Меняет что-то только на этом компьютере.
max chats rules unset <chat> <key>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
key |
обязательный | one of: trusted, blocked, blockedNames, links, invites, forwards, blockedPeople, flood.messages, flood.minutes, flood.action, newAccount.days, newAccount.action, consent.delete, consent.remove. |
judge a group's new messages and members by its rules, and act as they allow
Меняет что-то в MAX.
max chats moderate <chat> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
| Опция | Что делает |
|---|---|
--since-time <time> |
judge what came after this ISO 8601 time, or 2h / 1d ago; the saved point stays. |
--dry-run |
judge and plan; do nothing. |
--allow-dangerous |
yes to every action whose level in the group's rules is ask. |
--max-actions <n> |
at most this many actions in one run; 10 if not given. |
a chat's photos, videos, files, audio and links, from the messenger's server; reading marks nothing
max chats media <chat> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
| Опция | Что делает |
|---|---|
--type <names> |
only these kinds, comma-separated: photo, video, file, audio, link. |
--limit <n> |
how many to show. |
--before-id <id> |
read what came before this message id. |
stop notifications from a chat, for good or until a time; nobody in it is told
Меняет что-то в MAX.
max chats mute <chat> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
| Опция | Что делает |
|---|---|
--until <time> |
only until then: 2026-09-25T09:00 (local time), or 30m, 2h, 7d from now. |
hear a muted chat again
Меняет что-то в MAX.
max chats unmute <chat>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
delete a chat from this account; the others in it keep it and its messages
Меняет что-то в MAX.
max chats delete <chat> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
| Опция | Что делает |
|---|---|
--allow-dangerous |
go ahead without the question an ask level puts before a deletion. |
delete every message in a chat for this account; the others in it keep theirs
Меняет что-то в MAX.
max chats clear <chat> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
| Опция | Что делает |
|---|---|
--allow-dangerous |
go ahead without the question an ask level puts before a deletion. |
start a bot, as its Start button does; the bot sees that you started it
Меняет что-то в MAX.
max chats start <bot> [options]| Аргумент | Что это | |
|---|---|---|
bot |
обязательный | the chat with the bot — its id or its name — or the bot's link, even one never opened. |
| Опция | Что делает |
|---|---|
--payload <text> |
the start parameter the bot reads; a link's own ?start= when not given. |
the address that opens a bot's mini app, signed in as you — keep it to yourself
Меняет что-то в MAX.
max chats app <bot> [options]| Аргумент | Что это | |
|---|---|---|
bot |
обязательный | the chat with the bot: its id or its name. |
| Опция | Что делает |
|---|---|
--start <param> |
the start parameter the app reads. |
people you have a one-to-one chat with
people you have a one-to-one chat with
max contacts list [options]| Опция | Что делает |
|---|---|
--limit <n> |
how many to show. |
--page <n> |
which page, starting at 1. |
--all |
every row, no paging. |
--order <recent|name> |
newest conversation first, or alphabetical. По умолчанию: recent. |
--search <text> |
only people whose name, local alias or @username contains this. |
--search-notes <text> |
only people whose private notes contain this text. |
one person and the chats you share with them
max contacts show <person> [options]| Аргумент | Что это | |
|---|---|---|
person |
обязательный | their id, @username, or part of their name. |
| Опция | Что делает |
|---|---|
--with-notes |
include your private notes, subject to contacts.notes.list permission. |
everything the messenger says about one person — handles, flags, last seen, when they registered — and how many of their messages the store holds in each chat you share, the first and the last, and the earlier names and usernames the store saw them with
max contacts profile <person> [options]| Аргумент | Что это | |
|---|---|---|
person |
обязательный | their id, @username, or part of their name. |
| Опция | Что делает |
|---|---|
--show-phone |
print the whole phone number. |
a private local display name in the selected account
Меняет что-то только на этом компьютере.
max contacts alias set <person> <alias>| Аргумент | Что это | |
|---|---|---|
person |
обязательный | |
alias |
обязательный |
Меняет что-то только на этом компьютере.
max contacts alias rm <person>| Аргумент | Что это | |
|---|---|---|
person |
обязательный |
your private notes on a stored contact, the same in every account that sees them
max contacts notes list <person>| Аргумент | Что это | |
|---|---|---|
person |
обязательный |
max contacts notes show <person> <id>| Аргумент | Что это | |
|---|---|---|
person |
обязательный | |
id |
обязательный |
Меняет что-то только на этом компьютере.
max contacts notes add <person> [options]| Аргумент | Что это | |
|---|---|---|
person |
обязательный |
| Опция | Что делает |
|---|---|
--file <path> |
read note text from a file; omitted or - reads stdin. |
Меняет что-то только на этом компьютере.
max contacts notes edit <person> <id> [options]| Аргумент | Что это | |
|---|---|---|
person |
обязательный | |
id |
обязательный |
| Опция | Что делает |
|---|---|
--file <path> |
read note text from a file; omitted or - reads stdin. |
--revision <number> |
the revision you read before editing. |
Меняет что-то только на этом компьютере.
max contacts notes remove <person> <id>| Аргумент | Что это | |
|---|---|---|
person |
обязательный | |
id |
обязательный |
forget where the last sync left off and take the whole list again
max contacts syncwho MAX has under a phone number — asks for it, or reads it from stdin
max contacts lookupadd a person to your contacts — contacts list still shows only people you have a dialog with
Меняет что-то в MAX.
max contacts add <person>| Аргумент | Что это | |
|---|---|---|
person |
обязательный | person id — contacts lookup finds one — or part of a known name. |
remove a person from your contacts; the chat stays, a name you gave them may not
Меняет что-то в MAX.
max contacts remove <person>| Аргумент | Что это | |
|---|---|---|
person |
обязательный | person id — contacts lookup finds one — or part of a known name. |
stop a person from writing to you — they need not be a contact
Меняет что-то в MAX.
max contacts block <person>| Аргумент | Что это | |
|---|---|---|
person |
обязательный | person id — contacts lookup finds one — or part of a known name. |
let a blocked person write to you again
Меняет что-то в MAX.
max contacts unblock <person>| Аргумент | Что это | |
|---|---|---|
person |
обязательный | person id — contacts lookup finds one — or part of a known name. |
rename the contact in the messenger address book; use contacts alias for a private local name
Меняет что-то в MAX.
max contacts rename <person> <first-name> [last-name]| Аргумент | Что это | |
|---|---|---|
person |
обязательный | person id — contacts lookup finds one — or part of a known name. |
first-name |
обязательный | the name you want to see for them. |
last-name |
необязательный |
upload phone numbers and add the people the messenger has under them
Меняет что-то в MAX.
max contacts import <file>| Аргумент | Что это | |
|---|---|---|
file |
обязательный | one person per line: number, then a comma, a tab or a semicolon, then the name. |
what the store holds about one person, in every messenger linked to them: shared chats, the last messages each way, their recent messages, where others mentioned them — never connects
max contacts context <person> [options]| Аргумент | Что это | |
|---|---|---|
person |
обязательный | their id, @username, or part of their name. |
| Опция | Что делает |
|---|---|
--limit <n> |
at most this many messages in each list; 10 if not given. |
--since-time <time> |
nothing older than this ISO 8601 time, or 2h / 1d ago. |
--chat <chat> |
a chat, by id or name; repeat it for more — then their newest messages in each, 20 unless --limit, short unless -v. |
--refresh |
with --chat, read their newest messages in each from the messenger first. |
everything one person took part in, in every messenger linked to them — messages they wrote or were mentioned in, chats, mail, meetings, tasks — newest first, from the store; never connects
max contacts timeline <person> [options]| Аргумент | Что это | |
|---|---|---|
person |
обязательный | their id, @username, or part of their name. |
| Опция | Что делает |
|---|---|
--scope <personal|work> |
only what belongs to personal or to work accounts. |
--since-time <time> |
nothing older than this ISO 8601 time, or 2h / 1d ago. |
--until-time <time> |
through this ISO 8601 time, or 2h / 1d ago. |
--limit <n> |
at most this many; 50 if not given. |
whether one person looks like a bot, a fake or a spammer: their profile and what they wrote in the store — a hint, never a verdict; the public ban lists cover Telegram only, so nothing is sent
max contacts check <person> [options]| Аргумент | Что это | |
|---|---|---|
person |
обязательный | their id, @username, or part of their name. |
| Опция | Что делает |
|---|---|
--no-registries |
do not ask the public ban lists; nothing about them leaves this machine. |
record that two people in the store are one person — the same name is never enough
max contacts link <person> <other>| Аргумент | Что это | |
|---|---|---|
person |
обязательный | their id, @username, or part of their name. |
other |
обязательный | the same in another messenger of the store, as : — max:Ana. |
undo contacts link for one identity: it is a person of its own again
max contacts unlink <person>| Аргумент | Что это | |
|---|---|---|
person |
обязательный | their id, @username, or part of their name; : for another messenger. |
read and send messages in a chat
a chat's messages, oldest to newest
max messages list <chat> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
| Опция | Что делает |
|---|---|
--limit <n> |
how many. |
--before-id <id> |
only messages older than this message id. |
--before-time <time> |
only messages older than this ISO 8601 time, or 2h / 1d ago. |
--after-id <id> |
only messages newer than this message id. |
--after-time <time> |
only messages newer than this ISO 8601 time, or 2h / 1d ago. |
--transcribe |
turn voice messages not heard yet into text — by the messenger, or a model on this machine; can take minutes. |
--model <id> |
which downloaded speech model hears them, with --transcribe; models audio list shows them. |
--mark-read |
also mark the chat read up to the newest message shown; the other person sees it. |
one message, by its chat and id or by its msg: locator
max messages show <chat> [message]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title; or a msg: locator, with no message id after it. |
message |
необязательный | the message id. |
a message and what came either side of it, oldest first
max messages context <chat> [message] [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title; or a msg: locator, with no message id after it. |
message |
необязательный | the message id. |
| Опция | Что делает |
|---|---|
--thread |
the stored reply chain and replies instead of time neighbours; falls back when no graph exists. |
--thread-hops <n> |
at most this many links from the hit (default: 8). |
--thread-messages <n> |
at most this many messages in each thread context (default: 50). |
--thread-bytes <n> |
at most this many bytes of whole messages and links in each context (default: 65536). |
--thread-within <duration> |
messages within this long either side of the hit (default: 1d). |
--before-n <n> |
how many before it. По умолчанию: 5. |
--after-n <n> |
how many after it. По умолчанию: 5. |
why a message is in its conversation: each link it has, and the chain of answers back to the start
max messages links <chat> <message>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
message |
обязательный | the message id. |
a message permalink when supported, and its account-scoped locator
max messages link <chat> [message]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title; or a msg: locator, with no message id after it. |
message |
необязательный | the message id. |
save a message's photos, files, videos and voice notes to a folder — or a whole chat's with --all
max messages download <chat> [message] [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
message |
необязательный | the message id; left out with --all. |
| Опция | Что делает |
|---|---|
--output-dir <dir> |
where to save them; created if missing. По умолчанию: .. |
--all |
every file of the chat, newest first; run it again to continue where it stopped. |
--pause <duration> |
with --all, a pause between pages, to stay under the provider's limits. По умолчанию: 5s. |
--extract |
read text layers from the files this download maps into the local content index. |
--output <dir> |
compatibility alias for --output-dir. |
a bounded evidence packet from stored messages, newest first
max messages evidence <chat> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
| Опция | Что делает |
|---|---|
--limit <n> |
how many, 1–100. |
--before-id <id> |
only messages older than this message id. |
bring a chat's history in the local store up to date, newest first; run it again to continue; --all syncs every chat
max messages sync [chat] [options]| Аргумент | Что это | |
|---|---|---|
chat |
необязательный | a chat: its id, or part of its title. |
| Опция | Что делает |
|---|---|
--all |
every chat, most recently active first — what search needs; the last 90d unless --since-time or --last. |
--limit <n> |
at most this many messages in this run, per chat with --all; 1200 if not given. |
--page-size <n> |
how many messages one request asks for; 30 if not given. |
--pause <duration> |
the least pause between pages, to stay under the provider's limits; each is up to twice that. По умолчанию: 5s. |
--since-time <time> |
stop once it reaches messages older than this: ISO 8601, or 2h / 1d ago. |
--last <n> |
stop once the newest n messages are held. |
--catch-up |
prepare local search after this run; overrides searchCatchUp. |
--no-catch-up |
skip local preparation after this run. |
--catch-up-chunks <n> |
at most this many local vector chunks. |
--catch-up-messages <n> |
skip a graph rebuild larger than this many messages. |
--catch-up-time <duration> |
local preparation time budget, 30s by default. |
--background |
run as a job that outlives this command; store jobs show follows it. |
--estimate |
only estimate how many messages, requests and minutes a full fetch would still take — from the store, no request. |
turn a voice message into text, on this machine — the recording goes nowhere
max messages transcribe <chat> <message> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | chat id, or part of a chat name. |
message |
обязательный | id of a voice message. |
| Опция | Что делает |
|---|---|
--model <id> |
which downloaded speech model to use; max models audio list shows them. |
send a text message; without [text], the text is read from stdin
Меняет что-то в MAX.
max messages send <chat> [text] [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
text |
необязательный | the message. |
| Опция | Что делает |
|---|---|
--topic <id> |
send to this forum topic; unsupported by messengers without topics. |
--reply-to <message> |
answer this message, by its id in the same chat. |
--send-as <id> |
post as one of the identities chats send-as lists; required where the chat posts as someone else by default. |
--send-id <id> |
repeat a send whose outcome was unknown, without risking a second copy. |
--silent |
deliver without a notification. |
--no-preview |
no preview card for a link in the text. |
--md |
read this messenger's Markdown; see its formatting guide for supported syntax. |
--file <file> |
attach a file; the text becomes its caption. |
--photo <file> |
attach a .jpg, .png or .webp as a photo; the text becomes its caption. |
--as-file |
send the --file as a file to download, a video included. |
--voice <file> |
send an Ogg Opus file as a voice message, alone, with no text. |
--allow-any-file |
send a file even from credential folders or this CLI's own folders. |
--at-time <time> |
let the messenger send it later, even with this machine off: 2026-09-25T09:00 (local time), or 30m, 2h, 1d from now. |
--sticker <id> |
send this sticker, alone; stickers list finds its id. |
messages waiting to be sent later in a chat, soonest first; cancel one in the app
max messages scheduled <chat>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
change the text of your own message; the other side may have read it already
Меняет что-то в MAX.
max messages edit <chat> <message> [text] [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
message |
обязательный | the id of your own message. |
text |
необязательный | the new text; without it, read from stdin. |
| Опция | Что делает |
|---|---|
--md |
read this messenger's Markdown; see its formatting guide for supported syntax. |
delete messages for you only; with --for-everyone, for everyone in the chat
Меняет что-то в MAX.
max messages delete <chat> <messages> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
messages |
обязательный | the message ids, at most 10. |
| Опция | Что делает |
|---|---|
--for-everyone |
delete for everyone in the chat, not only for you — they cannot get it back. |
--allow-dangerous |
go ahead without the question an ask level puts before a deletion. |
forward one message to another chat
Меняет что-то в MAX.
max messages forward <chat> <message> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | the chat the message is in: a chat: its id, or part of its title. |
message |
обязательный | the message id. |
| Опция | Что делает |
|---|---|
--to <chat> |
where it goes: a chat: its id, or part of its title. |
--silent |
deliver it without a notification. |
--send-as <id> |
post as one of the identities chats send-as lists for the --to chat; required where the chat posts as someone else by default. |
--send-id <id> |
repeat a forward whose outcome was unknown, without risking a second copy. |
pin a message in a chat, quietly unless --notify
Меняет что-то в MAX.
max messages pin <chat> <message> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
message |
обязательный | the message id. |
| Опция | Что делает |
|---|---|
--notify |
tell the chat's members about the pin. |
unpin a message in a chat
Меняет что-то в MAX.
max messages unpin <chat> <message>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
message |
обязательный | the message id. |
press a bot's button under a message; the bot sees that you pressed it
Меняет что-то в MAX.
max messages press <chat> <message> <button>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
message |
обязательный | the id of the message with the buttons. |
button |
обязательный | its number as messages show prints it, or its exact text. |
the local store of messages
per chat: messages stored, the oldest and newest, and the stretches held completely
max store status [chat]| Аргумент | Что это | |
|---|---|---|
chat |
необязательный | a chat: its id, or part of its title. |
inspect recorded interior coverage gaps and explicitly fetch them
local coverage plan; missing message ids alone do not imply missing history
max store gaps plan <chat>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
fetch bounded interior gaps and recheck coverage; never delete unseen messages
max store gaps repair <chat> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
| Опция | Что делает |
|---|---|
--limit <n> |
total messages in this repair, 500 by default. |
--max-gaps <n> |
at most this many gaps, 5 by default. |
--repair-time <duration> |
time budget for the repair, 30s by default. По умолчанию: 30s. |
--page-size <n> |
messages per provider page. |
--pause <duration> |
provider pause between pages. По умолчанию: 5s. |
--fingerprint <hash> |
refuse if this previously inspected coverage plan changed. |
--catch-up |
prepare local search after repair; overrides searchCatchUp. |
--no-catch-up |
skip local search preparation after repair. |
--catch-up-chunks <n> |
maximum local chunks prepared. |
--catch-up-messages <n> |
maximum stored messages read for preparation. |
--catch-up-time <duration> |
preparation time within the repair's remaining budget. |
--background |
repair as an existing store job; inspect store jobs show. |
background sync jobs
background sync jobs, newest first
max store jobs list [options]| Опция | Что делает |
|---|---|
--state <state> |
only jobs in this state. Одно из: running, done, partial, failed, cancelled, died. |
one background job — the newest when none is named — and what the store now holds of its chat
max store jobs show [job]| Аргумент | Что это | |
|---|---|---|
job |
необязательный | the job id messages sync --background printed. |
stop a running background job after its current page; a later sync resumes where it stopped
max store jobs cancel <job>| Аргумент | Что это | |
|---|---|---|
job |
обязательный | the job id. |
start a partial, failed or died job again, as a new job; the sync resumes where the store stopped
max store jobs retry [job] [options]| Аргумент | Что это | |
|---|---|---|
job |
необязательный | the job id. |
| Опция | Что делает |
|---|---|
--failed |
every chat whose newest job partial, failed or died. |
forget finished jobs and remove their logs; a running job is kept
Меняет что-то только на этом компьютере.
max store jobs cleara chat's stored messages, oldest first: --jsonl one message per line, --json one { items, page, limit, hasMore } object; never asks the messenger
max store export [chats] [options]| Аргумент | Что это | |
|---|---|---|
chats |
необязательный | a chat: its id, or part of its title; several with --to. |
| Опция | Что делает |
|---|---|
--format <format> |
jsonl: one message per line, the default with --output; markdown: a transcript with a heading per day, replies and forwards quoted. |
--since-time <time> |
only from this ISO 8601 time, or 30m / 2h / 1d ago, on. |
--output <file> |
write JSON lines, or the transcript, to this new file, readable only by you. |
--to <dir> |
write into this folder, a file per chat and a manifest; run again on it for only what changed since. |
--kind <kinds> |
with --to: every stored chat of these kinds, comma-separated: dialog, group, channel, saved. |
--all |
with --to: every stored chat of this account. |
--encrypt |
compress and encrypt with a password, typed at a hidden prompt or piped on stdin; it is never kept — lose it and the file cannot be opened. |
delete from the store the chats this account has left, with their messages
max store clear [options]| Опция | Что делает |
|---|---|
--left |
the chats this account has left — the only thing this clears. |
--allow-dangerous |
yes, delete — it cannot be undone, and a chat you left cannot be fetched again. |
the store file: where it is, its size, its schema and how many rows it holds; changes nothing
max store infowhether the store is healthy — integrity, search indexes, disk, and which chats are behind
max store checkbring the store up to this build's schema, then normalize, index and stem the messages and notes stored before it
max store migraterebuild the word index, its typo vocabulary, the stems, the files' word index, the notes' indexes and who took part in what, from what is stored; loses nothing
max store reindexcopy the store into a new file, while it is in use; never overwrites a file
max store backup <file> [options]| Аргумент | Что это | |
|---|---|---|
file |
обязательный | the new file. |
| Опция | Что делает |
|---|---|
--encrypt |
compress and encrypt with a password, typed at a hidden prompt or piped on stdin; it is never kept — lose it and the file cannot be opened. |
put a backup in place of the store; the store it replaces is kept beside it, never deleted
max store restore <file>| Аргумент | Что это | |
|---|---|---|
file |
обязательный | a file store backup wrote; one written with --encrypt asks for its password. |
open a file written with --encrypt into a new file; asks for its password
max store decrypt <file> [options]| Аргумент | Что это | |
|---|---|---|
file |
обязательный | a file store backup --encrypt or store export --encrypt wrote. |
| Опция | Что делает |
|---|---|
--output <file> |
the new file, readable only by you. |
bring every table to this build's shape, deleting nothing: a table of the wrong shape is kept as a copy beside a new one
max store repair [options]| Опция | Что делает |
|---|---|
--dry-run |
say what it would do, and change nothing. |
back the store up beside itself, then delete it and start an empty one at this build's schema; asks first, or --yes
max store reset [options]| Опция | Что делает |
|---|---|
--no-backup |
delete the store without backing it up first. |
the tables store repair kept as copies
delete one copy store repair kept, named exactly; refuses any other table
max store copies delete <name>| Аргумент | Что это | |
|---|---|---|
name |
обязательный | the copy's name, as store repair printed it. |
statistics about messages, chats and their authors
message statistics from the local store
how many stored messages match, by chat, sender, day or hour — the local store only; optionally fetches new messages with --sync-first
max stats messages show [query] [options]| Аргумент | Что это | |
|---|---|---|
query |
необязательный | a strict Lucene query, as for search messages; none counts every stored message; with --saved, more words AND-ed to it. |
| Опция | Что делает |
|---|---|
--sync-first |
first fetch new messages within the chat, time and message bounds. |
--max-chats <n> |
refresh at most this many chats (default: 5). |
--sync-time <duration> |
stop fetching after this long (default: 30s). |
--max-messages <n> |
fetch at most this many messages total (default: 500). |
--by <chat|sender|day|hour> |
what to count by (default: chat). |
--chat <chat> |
only this chat — the same as chat: in the query; a chat: its id, or part of its title. |
--source <accounts> |
every account of this messenger held in the store; personal, bots or all — the same as in: in the query. |
--limit <n> |
how many rows. |
--timezone <zone> |
the IANA timezone for calendar days and hours. |
--exact |
bare words and quotes match their exact form only, as exact:word does; text: still matches every form. |
--saved <name|id> |
count what a saved search or an earlier run matches; options typed here replace its own. |
per-counter observations and bounded remote refresh
show saved counter values and their observation freshness
max stats messages counters show [query] [options]| Аргумент | Что это | |
|---|---|---|
query |
необязательный | strict Lucene query over stored messages. |
| Опция | Что делает |
|---|---|
--chat <chat> |
only this chat; a chat: its id, or part of its title. |
--source <accounts> |
held accounts of this messenger; refresh uses the active account. |
--exact |
bare words match exact forms. |
--timezone <zone> |
IANA timezone for query dates. |
--selection <json> |
pinned counter-targets selection from counters show; conflicts with query and scope. |
--counters <names> |
distinct views,reactions,comments fields; all three by default. |
--limit <n> |
messages, 1–100; 20 by default. |
--max-age <duration> |
maximum fresh observation age; 24h by default. |
read authoritative counters for bounded messages and update their local observations
Меняет что-то только на этом компьютере.
max stats messages counters refresh [query] [options]| Аргумент | Что это | |
|---|---|---|
query |
необязательный | strict Lucene query over stored messages. |
| Опция | Что делает |
|---|---|
--chat <chat> |
only this chat; a chat: its id, or part of its title. |
--source <accounts> |
held accounts of this messenger; refresh uses the active account. |
--exact |
bare words match exact forms. |
--timezone <zone> |
IANA timezone for query dates. |
--selection <json> |
pinned counter-targets selection from counters show; conflicts with query and scope. |
--counters <names> |
distinct views,reactions,comments fields; all three by default. |
--limit <n> |
messages, 1–100; 20 by default. |
--max-messages <n> |
maximum messages to refresh, 1–100. |
--sync-time <duration> |
remote refresh budget; 30s by default, maximum 5m. |
--dry-run |
preview exact stored targets and counter capabilities without connecting. |
oldest detected questions without an observed qualifying explicit reply
max stats messages unanswered [query] [options]| Аргумент | Что это | |
|---|---|---|
query |
необязательный | a strict Lucene query; none selects every stored message. |
| Опция | Что делает |
|---|---|
--chat <chat> |
only this chat; a chat: its id, or part of its title. |
--source <accounts> |
every held account of this messenger; personal, bots or all. |
--exact |
bare words match exact forms rather than stems. |
--saved <name|id> |
run a saved report of this kind; typed report options replace stored options. |
--timezone <zone> |
the IANA timezone for calendar date boundaries. |
--limit <n> |
report rows, 1–100; 20 if not given. |
--answerer <person> |
stored name, alias, @username, ID or person:provider/account/id; ambiguous names require a choice; repeat for more. |
--older-than <duration> |
minimum age of a question without an observed qualifying answer. |
viewed posts with little recorded discussion
max stats messages discussion [query] [options]| Аргумент | Что это | |
|---|---|---|
query |
необязательный | a strict Lucene query; none selects every stored message. |
| Опция | Что делает |
|---|---|
--chat <chat> |
only this chat; a chat: its id, or part of its title. |
--source <accounts> |
every held account of this messenger; personal, bots or all. |
--exact |
bare words match exact forms rather than stems. |
--saved <name|id> |
run a saved report of this kind; typed report options replace stored options. |
--timezone <zone> |
the IANA timezone for calendar date boundaries. |
--limit <n> |
report rows, 1–100; 20 if not given. |
--min-views <n> |
minimum known cumulative views. |
--max-replies <n> |
maximum observed discussion replies. |
rank stored messages by a measure or explainable score; counters are snapshots with per-field observation freshness
max stats messages top [query] [options]| Аргумент | Что это | |
|---|---|---|
query |
необязательный | a strict Lucene query; none selects every stored message. |
| Опция | Что делает |
|---|---|
--sync-first |
first fetch new messages within the chat, time and message bounds. |
--max-chats <n> |
refresh at most this many chats (default: 5). |
--sync-time <duration> |
stop fetching after this long (default: 30s). |
--max-messages <n> |
fetch at most this many messages total (default: 500). |
--measure <name> |
the ranking metric; not with score or weights. Одно из: views, reactions, forwards, comments, replies, thread-size. |
--score <preset> |
helpful/active for authors; engaging for either target. Одно из: helpful, active, engaging. |
--weights <json> |
the complete component weights; replaces preset weights. |
--message-kind <kind> |
select proven all, posts or comments before ranking. Одно из: all, posts, comments. |
--chat <chat> |
only this chat; a chat: its id, or part of its title. |
--source <accounts> |
every held account of this messenger; personal, bots or all. |
--timezone <zone> |
the IANA timezone for dates and active days. |
--exact |
bare words match exact forms rather than stems. |
--limit <n> |
ranked rows, 1–100. |
--saved <name|id> |
run a saved query or ranking run; typed options replace stored options. |
bounded messages, answer pairs or retention members from an exact drilldown selection
max stats messages evidence <message> [options]| Аргумент | Что это | |
|---|---|---|
message |
обязательный | the canonical message locator, or retention cohort reference, from drilldown. |
| Опция | Что делает |
|---|---|
--selection <json> |
the resolved ranking selection returned in drilldown. |
--component <name> |
the exposed ranking component. |
--limit <n> |
evidence rows, 1–100; 20 if not given. |
--cursor <cursor> |
continue the same component and stored-evidence fingerprint. |
statistics about human authors
counts and median/p90 latency for selected human answering identities
max stats contacts responses [query] [options]| Аргумент | Что это | |
|---|---|---|
query |
необязательный | a strict Lucene query; none selects every stored message. |
| Опция | Что делает |
|---|---|
--chat <chat> |
only this chat; a chat: its id, or part of its title. |
--source <accounts> |
every held account of this messenger; personal, bots or all. |
--exact |
bare words match exact forms rather than stems. |
--saved <name|id> |
run a saved report of this kind; typed report options replace stored options. |
--timezone <zone> |
the IANA timezone for calendar date boundaries. |
--limit <n> |
report rows, 1–100; 20 if not given. |
--answerer <person> |
stored name, alias, @username, ID or person:provider/account/id; ambiguous names require a choice; repeat for more. |
rank the human authors of stored messages by a measure or explainable score; counters are snapshots with per-field observation freshness
max stats contacts top [query] [options]| Аргумент | Что это | |
|---|---|---|
query |
необязательный | a strict Lucene query; none selects every stored message. |
| Опция | Что делает |
|---|---|
--sync-first |
first fetch new messages within the chat, time and message bounds. |
--max-chats <n> |
refresh at most this many chats (default: 5). |
--sync-time <duration> |
stop fetching after this long (default: 30s). |
--max-messages <n> |
fetch at most this many messages total (default: 500). |
--measure <name> |
the ranking metric; not with score or weights. Одно из: messages, words, reactions, replies, answers, answer-time, threads, active-days. |
--score <preset> |
helpful/active for authors; engaging for either target. Одно из: helpful, active, engaging. |
--weights <json> |
the complete component weights; replaces preset weights. |
--message-kind <kind> |
select proven all, posts or comments before ranking. Одно из: all, posts, comments. |
--chat <chat> |
only this chat; a chat: its id, or part of its title. |
--source <accounts> |
every held account of this messenger; personal, bots or all. |
--timezone <zone> |
the IANA timezone for dates and active days. |
--exact |
bare words match exact forms rather than stems. |
--limit <n> |
ranked rows, 1–100. |
--saved <name|id> |
run a saved query or ranking run; typed options replace stored options. |
--min-messages <n> |
minimum selected messages per author; 1, or 5 for engaging. |
bounded messages, answer pairs or retention members from an exact drilldown selection
max stats contacts evidence <person> [options]| Аргумент | Что это | |
|---|---|---|
person |
обязательный | the exact native person id from the ranking row. |
| Опция | Что делает |
|---|---|
--selection <json> |
the resolved ranking selection returned in drilldown. |
--component <name> |
the exposed ranking component. |
--limit <n> |
evidence rows, 1–100; 20 if not given. |
--cursor <cursor> |
continue the same component and stored-evidence fingerprint. |
statistics about one chat
a group's or channel's numbers for a period: messages, active members, replies, reactions, questions answered, joins and leaves — counted from the local store; joins and leaves are asked of the messenger
max stats chats show <chat> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
| Опция | Что делает |
|---|---|
--since-time <time> |
ISO 8601, or 2h / 1d ago; 7 days ago if not given. |
--by <day|week> |
also one row per calendar day or week (weeks start on Monday). |
--timezone <zone> |
the IANA timezone for calendar days. |
known-join members and their help within a join window
max stats chats newcomers <chat> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
| Опция | Что делает |
|---|---|
--since-time <time> |
from this ISO 8601 time, or 2h / 1d ago; 30d ago if not given. |
--until-time <time> |
through this ISO 8601 time, or 2h / 1d ago. |
--within <duration> |
the help window after a known newcomer join. |
--saved <name|id> |
run a saved report of this kind; typed report options replace stored options. |
--timezone <zone> |
the IANA timezone for calendar date boundaries. |
--limit <n> |
report rows, 1–100; 20 if not given. |
--answerer <person> |
stored name, alias, @username, ID or person:provider/account/id; ambiguous names require a choice; repeat for more. |
joining cohorts and observed checkpoint membership from saved roster observations
max stats chats retention <chat> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
| Опция | Что делает |
|---|---|
--since-time <time> |
joining period starts at ISO 8601 or a relative time; last 90 days by default. |
--until-time <time> |
joining period ends at this time; now by default. |
--checkpoints <durations> |
up to 10 increasing joining ages, comma separated; 1d,7d,30d by default. |
--within <duration> |
activity and early departure window after joining; 7d by default. |
--by <day|week> |
group joining dates by calendar day or Monday week. Одно из: day, week. |
--timezone <zone> |
IANA timezone for joining cohorts. |
--limit <n> |
cohorts and member evidence, 1–100. |
task statistics
per chat: how many tasks are open, the oldest open one, the median time to close
max stats tasks show [options]| Опция | Что делает |
|---|---|
--chat <chat> |
only this chat; a chat: its id, or part of its title. |
--type <name> |
only this type: question, request, mention or promise. |
a chart's data from a chat's statistics, and optionally a dark SVG or PNG image
max stats charts <chat> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
| Опция | Что делает |
|---|---|
--chart-kind <messages|active|membership> |
what to draw: messages, active authors, or joins and leaves. По умолчанию: messages. |
--by <day|week> |
one point per calendar day or week (weeks start on Monday). По умолчанию: day. |
--since-time <time> |
ISO 8601, or 2h / 1d ago; 7 days ago if not given. |
--timezone <zone> |
the IANA timezone for calendar days. |
--output <file> |
write a dark image to a new .svg or .png file. |
what waits on you — unanswered questions, mentions, requests, promises — kept in the local store; review and serve add them
tasks, oldest first, with their message or note source
max tasks list [query] [options]| Аргумент | Что это | |
|---|---|---|
query |
необязательный | field:value terms that narrow the list — the fields are below. |
| Опция | Что делает |
|---|---|
--limit <n> |
how many. |
add a task for a stored message or note — a promise, a request
max tasks add <message> [options]| Аргумент | Что это | |
|---|---|---|
message |
обязательный | a message locator, msg:///, or note:. |
| Опция | Что делает |
|---|---|
--type <name> |
the task's type: question, request, mention or promise. |
--title <text> |
one line: the action and its object — send Alex the API token. |
--description <text> |
the detail, in Markdown: who owes whom, done when, next step, keywords. |
--due <when> |
when it must be done: an ISO 8601 time or 2h, 3d from now; none clears it. |
--check <when> |
when to look at it again: an ISO 8601 time or 2h, 3d from now; none clears it. |
set a task's title, description, due date and next check; nothing reaches the messenger
max tasks plan <task> [options]| Аргумент | Что это | |
|---|---|---|
task |
обязательный | the task's id or key, as tasks list shows it. |
| Опция | Что делает |
|---|---|
--title <text> |
one line: the action and its object — send Alex the API token. |
--description <text> |
the detail, in Markdown: who owes whom, done when, next step, keywords. |
--due <when> |
when it must be done: an ISO 8601 time or 2h, 3d from now; none clears it. |
--check <when> |
when to look at it again: an ISO 8601 time or 2h, 3d from now; none clears it. |
link a task to what it concerns — messages, chats, people, documents, URLs — to read around later
max tasks link <task> [targets] [options]| Аргумент | Что это | |
|---|---|---|
task |
обязательный | the task's id or key, as tasks list shows it. |
targets |
необязательный | msg: locators, person:, document:, note:, or a URL. |
| Опция | Что делает |
|---|---|
--chat <chat> |
a chat it concerns, repeatable; a chat: its id, or part of its title. |
--kind <kind> |
related-to (default), evidence — it shows the task is real — or created-from. |
one task: its plan and everything linked to it
max tasks show <task>| Аргумент | Что это | |
|---|---|---|
task |
обязательный | the task's id or key, as tasks list shows it. |
what needs a look today, from the local store and without message text: tasks overdue, due or to check, chats where you owe an answer, chats where you wait for one
max tasks agenda [options]| Опция | Что делает |
|---|---|
--due <span> |
list tasks due within this: 30m, 2h, 1d (default 1d). |
--unanswered <span> |
list chats where someone else wrote last this long ago (default 1d). |
--waiting <span> |
list chats where you wrote last this long ago (default 7d). |
--within <span> |
leave out chats silent longer than this: they ended (default 30d). |
--kind <kinds> |
only these chat kinds, comma-separated (default dialog,group). |
close a task: done, or dismissed when it needs no answer; a closed task stays closed
max tasks close <task> [options]| Аргумент | Что это | |
|---|---|---|
task |
обязательный | the task's id, as tasks list shows it. |
| Опция | Что делает |
|---|---|
--as <state> |
how it is closed: done, or dismissed — it needs no answer. |
--reason <text> |
why, kept with the task — no-reply-needed, for example. |
the conversations inside a chat, found in the stored messages by replies, mentions and who wrote next
find a chat's conversations in what the store holds, replacing the last build; without --chat, every chat that changed since its build and every group never built; never asks the messenger
max conversations build [options]| Опция | Что делает |
|---|---|
--chat <chat> |
a chat: its id, or part of its title. |
--analyze |
link batches using the configured analysis provider; requires --chat and remembers consent for this chat/provider. |
--provider <provider> |
analysis: agent, openai or anthropic. |
--model <model> |
analysis model; overrides analysisModel. |
--base-url <url> |
analysis API endpoint; overrides analysisBaseUrl. |
--size <n> |
analysis answer messages per batch, 10–200; default 50. |
--max-tokens <n> |
analysis input/output reservation cap per run; default 100000. |
--max-chats <n> |
at most this many chats in one run; 20 if not given. |
a chat's conversations, the newest first: when, how many messages, how many people
max conversations list <chat> [query] [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
query |
необязательный | field:value terms that narrow the list — the fields are below. |
| Опция | Что делает |
|---|---|
--limit <n> |
how many. |
one conversation's messages, oldest first — by its id, or the one a message is in
max conversations show <conversation> [message]| Аргумент | Что это | |
|---|---|---|
conversation |
обязательный | a conversation id from conversations list; or a chat: its id, or part of its title, with a message. |
message |
необязательный | a message id in that chat: show the conversation it is in. |
the conversations nearest in meaning to the one a message is in, in every built chat, best first — from the vectors conversations embed stored; runs no model
max conversations related <chat> <message> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
message |
обязательный | a message id in that chat. |
| Опция | Что делает |
|---|---|
--limit <n> |
how many. |
--model <model> |
local: a model id from models text list (default: e5-small); remote: the provider's model. |
--provider <provider> |
embedding provider: local or openai; flags override profile settings. |
--base-url <url> |
a server with OpenAI's /v1/embeddings: Gemini, Jina, or Ollama and LM Studio on this machine. |
--dims <n> |
remote: the vector size — needed with --base-url; shortens an OpenAI model's. |
how fresh each built chat's conversations and vectors are: messages the build has not seen, chunks with a current, stale or missing vector
max conversations status [options]| Опция | Что делает |
|---|---|
--chat <chat> |
only this chat: a chat: its id, or part of its title. |
--model <model> |
local: a model id from models text list (default: e5-small); remote: the provider's model. |
--provider <provider> |
embedding provider: local or openai; flags override profile settings. |
--base-url <url> |
a server with OpenAI's /v1/embeddings: Gemini, Jina, or Ollama and LM Studio on this machine. |
--dims <n> |
remote: the vector size — needed with --base-url; shortens an OpenAI model's. |
windows of a chat for your own AI agent to link: which earlier message each one answers
how many messages still wait for an answer, in how many batches, and how much text
max conversations batches status [options]| Опция | Что делает |
|---|---|
--chat <chat> |
a chat: its id, or part of its title. |
--size <n> |
messages to answer per batch, 10–200; 50 by default. |
the next window to answer, with the messages before it; message text goes to stdout only
max conversations batches next [options]| Опция | Что делает |
|---|---|
--chat <chat> |
a chat: its id, or part of its title. |
--size <n> |
messages to answer per batch, 10–200; 50 by default. |
your agent's answers: which earlier message each message of a batch answers
store your agent's answer to a batch, read as JSON from stdin: { "model", "answers": [{ "message", "parent", "confidence" }] }; all or nothing
max conversations links add [options]| Опция | Что делает |
|---|---|
--batch <id> |
the batch id conversations batches next printed. |
drop your agent's answers for a chat, or only one model's; messages are never touched
max conversations links clear [options]| Опция | Что делает |
|---|---|
--chat <chat> |
a chat: its id, or part of its title. |
--model <model> |
only the answers this model gave. |
remembered analysis permissions for this account's chats and provider endpoints
max conversations consents listmax conversations consents revoke [options]| Опция | Что делает |
|---|---|
--chat <chat> |
revoke only this chat's consents; defaults to every chat. |
--provider <identity> |
exact provider identity from consents list; defaults to every provider. |
compute a vector for each chunk of a chat's conversations for search by meaning — on this machine, or with --provider through a service and your key; resumes where it stopped; without --chat, every built chat with chunks left, on this machine only
max conversations embed [options]| Опция | Что делает |
|---|---|
--chat <chat> |
a chat: its id, or part of its title. |
--model <model> |
local: a model id from models text list (default: e5-small); remote: the provider's model. |
--provider <provider> |
embedding provider: local or openai; flags override profile settings. |
--base-url <url> |
a server with OpenAI's /v1/embeddings: Gemini, Jina, or Ollama and LM Studio on this machine. |
--dims <n> |
remote: the vector size — needed with --base-url; shortens an OpenAI model's. |
--workers <n> |
local: sessions in parallel, each with its own copy of the model (~0.7 GB each). |
--threads <n> |
local: threads in all (default: min(8, cores)). |
--concurrency <n> |
remote: requests at once (default: 4). |
--max-tokens <n> |
remote: stop before a run that could send more tokens than this. |
--max-chats <n> |
at most this many chats in one run; 20 if not given. |
--max-chunks <n> |
at most this many chunks embedded in one run; 2000 if not given, and no limit with --chat. |
how many chunks of a chat have a vector of the model, how many are left, and what is left costs
max conversations embed status [options]| Опция | Что делает |
|---|---|
--chat <chat> |
a chat: its id, or part of its title. |
--model <model> |
local: a model id from models text list (default: e5-small); remote: the provider's model. |
--provider <provider> |
embedding provider: local or openai; flags override profile settings. |
--base-url <url> |
a server with OpenAI's /v1/embeddings: Gemini, Jina, or Ollama and LM Studio on this machine. |
--dims <n> |
remote: the vector size — needed with --base-url; shortens an OpenAI model's. |
drop a chat's vectors, or only one model's; messages and conversations are never touched
max conversations embed clear [options]| Опция | Что делает |
|---|---|
--chat <chat> |
a chat: its id, or part of its title. |
--model <model> |
local: a model id from models text list (default: e5-small); remote: the provider's model. |
--provider <provider> |
embedding provider: local or openai; flags override profile settings. |
--base-url <url> |
a server with OpenAI's /v1/embeddings: Gemini, Jina, or Ollama and LM Studio on this machine. |
--dims <n> |
remote: the vector size — needed with --base-url; shortens an OpenAI model's. |
the files of stored messages: their text in the local store, where search finds it
read the text of downloaded files — text, PDF/DOCX text layers, ODT/ODS/XLSX/PPTX/EPUB — into the local store, where search finds them
max attachments extract [options]| Опция | Что делает |
|---|---|
--chat <chat> |
only this chat's files; a chat: its id, or part of its title. |
--from-dir <dir> |
match files in this nonrecursive directory; needs --chat. |
--cursor <cursor> |
continue from the cursor returned by a bounded extraction. |
--download |
first save the files no download saved yet, from the messenger, into --output-dir. |
--output-dir <dir> |
with --download, where to save them; created if missing. |
--limit <n> |
read at most this many files; run it again to continue. |
--ocr |
explicitly call models.ocr for bulk image and scanned-PDF text extraction. |
--concurrency <n> |
remote: requests at once (default: 4). |
files of stored messages, where each was saved and whether its text is held — never the text
max attachments list [options]| Опция | Что делает |
|---|---|
--chat <chat> |
only this chat's files; a chat: its id, or part of its title. |
--needs-text |
only files saved here whose text nobody has yet: what an agent reads and writes back. |
--limit <n> |
how many to show. |
--page <n> |
which page, starting at 1. |
--all |
every row, no paging. |
read a bounded chunk of one retained attachment; JSON includes base64 bytes
max attachments show <chat> [message] [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title; or a msg: locator alone. |
message |
необязательный | the message id. |
| Опция | Что делает |
|---|---|
--attachment <n> |
file position from 1; required for several files. |
--page <n> |
render one PDF page as PNG, from 1; optional unpdf/canvas, no OCR. |
--offset-bytes <n> |
byte offset from 0. |
--chunk-bytes <n> |
bytes to return, 1–1048576 (default524288). |
--if-sha256 <hash> |
require the whole file SHA-256 from the preceding chunk. |
the text of one file, as an agent read it
keep the text an agent read from a file — a scan, a photo — so search finds it; nothing is sent
max attachments text set <chat> [message] [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title; or a msg: locator, with no message id after it. |
message |
необязательный | the message id. |
| Опция | Что делает |
|---|---|
--attachment <n> |
which file of the message, from 1; needed when it has more than one. |
--text-file <path> |
read the text from this file; - or none reads stdin. |
your own labels on chats, people and messages, kept in the local store and never sent; tag: in a search finds them
derive local group/channel tags from cached metadata using keyword rules
Меняет что-то только на этом компьютере.
max tags auto [options]| Опция | Что делает |
|---|---|
--chat <chat> |
a stored group/channel; repeat to select several. По умолчанию: ``. |
--limit <number> |
process at most 1–500 chats. По умолчанию: 50. |
--refresh-metadata |
read current descriptions from the messenger before classifying. |
--dry-run |
preview cached classification without changing the store. |
put tags on one chat, person or message
Меняет что-то только на этом компьютере.
max tags add <tag> [options]| Аргумент | Что это | |
|---|---|---|
tag |
обязательный | one or more tags: 1–32 letters a–z, digits and hyphens; upper case is lowered. |
| Опция | Что делает |
|---|---|
--chat <chat> |
the chat to tag, or the chat of --message; a chat: its id, or part of its title. |
--contact <person> |
the person to tag: their id, @username or name, as the local store knows them. |
--message <message> |
the message to tag: its id in --chat, or a msg: locator alone. |
take tags off one chat, person or message
Меняет что-то только на этом компьютере.
max tags remove <tag> [options]| Аргумент | Что это | |
|---|---|---|
tag |
обязательный | one or more tags: 1–32 letters a–z, digits and hyphens; upper case is lowered. |
| Опция | Что делает |
|---|---|
--chat <chat> |
the chat to untag, or the chat of --message; a chat: its id, or part of its title. |
--contact <person> |
the person to untag: their id, @username or name, as the local store knows them. |
--message <message> |
the message to untag: its id in --chat, or a msg: locator alone. |
--source <manual|auto> |
remove only this ownership claim. |
what is tagged: this account's chats and messages, and the people of its messenger
max tags list [query]| Аргумент | Что это | |
|---|---|---|
query |
необязательный | field:value terms that narrow the list — the fields are below. |
phones, e-mail, links and documents found in stored messages
this account's mentions matching the query, newest first; local store only
max mentions list [query] [options]| Аргумент | Что это | |
|---|---|---|
query |
необязательный | fields below; a bare word is a value, so 89001234567 finds +79001234567. |
| Опция | Что делает |
|---|---|
--limit <n> |
how many to show. |
--page <n> |
which page, starting at 1. |
one mention, the text around it, and how many other places hold its value
max mentions show <id>| Аргумент | Что это | |
|---|---|---|
id |
обязательный | the mention's id, from mentions list. |
find the mentions of every stored message again; decisions are kept
Меняет что-то только на этом компьютере.
max mentions rebuildcached group/channel descriptions for local automatic tags
max metadata get [options]| Опция | Что делает |
|---|---|
--chat <chat> |
a stored chat. |
Меняет что-то только на этом компьютере.
max metadata refresh [options]| Опция | Что делает |
|---|---|
--chat <chat> |
stored group/channel; repeat for several. По умолчанию: ``. |
--only-missing |
only chats with no metadata yet; without --chat, every stored group/channel. |
--limit <number> |
process at most 1–500 chats. По умолчанию: 50. |
find things by text: one resource when you know it (mail, messages, notes), or search all across messages, mail and notes
search messenger messages, mail and notes in the local store, and the messenger's server for messages (--backend; mail and notes are local only), and a meeting account's transcripts when --source names one — best match first; not tasks, people, memories or projects. Use it when you do not know where something was written; search mail, messages or notes reads one kind with all its fields
max search all <query> [options]| Аргумент | Что это | |
|---|---|---|
query |
обязательный | strict Lucene query: words, "phrases", AND/OR/NOT, field groups and date ranges. |
| Опция | Что делает |
|---|---|
--only <resources> |
only these resources, separated by commas: messages, mail, notes; meetings when --source names a meeting account. |
--source <accounts> |
only these accounts, separated by commas: provider:account as a hit shows it, a provider, a kind or group:; each resource reads the ones of its kind, and meetings only when it names one. |
--max-meetings <n|all> |
how many of the meeting account's meetings to look through, newest first; all looks through every one (default 100). |
--limit <n> |
how many. |
--offset <n> |
skip this many, for the next page. |
--exact |
bare words and quotes match their exact form only, as exact:word does. |
--timezone <zone> |
the IANA timezone for calendar date boundaries. |
--backend <archive|server|both> |
where to search: the local archive, the messenger's server, or both (default: both; message discovery uses archive only). |
--server-time <duration> |
stop waiting for the server after this long (default: 5s). |
search messenger messages in the local store and on the messenger's server (--backend); optionally fetches new messages with --sync-first; --discover searches the archive only
max search messages [query] [options]| Аргумент | Что это | |
|---|---|---|
query |
необязательный | strict Lucene query: words, "phrases", AND/OR/NOT, field groups and date ranges; --language legacy keeps discovery; with --saved, more words AND-ed to it. |
| Опция | Что делает |
|---|---|
--sync-first |
first fetch new messages within the chat, time and message bounds. |
--max-chats <n> |
refresh at most this many chats (default: 5). |
--sync-time <duration> |
stop fetching after this long (default: 30s). |
--max-messages <n> |
fetch at most this many messages total (default: 500). |
--thread |
the stored reply chain and replies instead of time neighbours; falls back when no graph exists. |
--thread-hops <n> |
at most this many links from the hit (default: 8). |
--thread-messages <n> |
at most this many messages in each thread context (default: 50). |
--thread-bytes <n> |
at most this many bytes of whole messages and links in each context (default: 65536). |
--thread-within <duration> |
messages within this long either side of the hit (default: 1d). |
--backend <archive|server|both> |
where to search: the local archive, the messenger's server, or both (default: both; message discovery uses archive only). |
--server-time <duration> |
stop waiting for the server after this long (default: 5s). |
--chat <chat> |
only this chat — the same as chat: in the query; a chat: its id, or part of its title. |
--source <accounts> |
every account of this messenger held in the store; personal, bots or all — the same as in: in the query; or a list: group:work,telegram:Alice,email:me@example.com. |
--type <text|voice|file> |
only messages of this type: text alone, a voice message, or a file. |
--limit <n> |
how many. |
--offset <n> |
skip this many, for the next page. |
--newest |
newest first instead of best first. |
--exact |
bare words and quotes match their exact form only, as exact:word does; text: still matches every form. |
--context <n> |
messages before and after each hit; 2 in the terminal, 0 otherwise. |
--discover |
find partial lexical matches and eligible replies in the local archive; results are evidence, not confirmed answers. |
--language <lucene|legacy> |
the query language: strict Lucene or legacy discovery. |
--timezone <zone> |
the IANA timezone for calendar date boundaries. |
--regex |
the words are one regular expression, case-insensitive, tested against every stored text. |
--saved <name|id> |
run a saved search or an earlier run; options typed here replace its own. |
search the mail imported into the local store — memo sync --mail brings it in
max search mail [query] [options]| Аргумент | Что это | |
|---|---|---|
query |
необязательный | strict Lucene query: words, "phrases", AND/OR/NOT, field groups and date ranges. |
| Опция | Что делает |
|---|---|
--chat <chat> |
only this mail thread, by id or subject. |
--source <accounts> |
only these mail accounts, separated by commas: email: as a hit shows it, email, mail or group:; every mail account when unset. |
--limit <n> |
how many. |
--offset <n> |
skip this many, for the next page. |
--newest |
newest first instead of best first. |
--exact |
bare words and quotes match their exact form only, as exact:word does; text: still matches every form. |
--context <n> |
messages before and after each hit; 2 in the terminal, 0 otherwise. |
--timezone <zone> |
the IANA timezone for calendar date boundaries. |
search the notes — written in memo, or imported from a notes folder — by words and, with the local text model, by meaning; each hit says which found it and what it links to
max search notes <query> [options]| Аргумент | Что это | |
|---|---|---|
query |
обязательный | strict Lucene query: words, "phrases", AND/OR/NOT, tag: and date ranges. |
| Опция | Что делает |
|---|---|
--type <internal|file> |
only notes written in memo, or only notes from a folder. |
--source <accounts> |
only these notes accounts, separated by commas: notes:internal for notes written in memo, notes: as a hit shows it, notes, documents or group:. |
--tag <tag> |
only notes with this tag. |
--filter <query> |
a query every hit must also match; it does not change the search by meaning. |
--limit <n> |
how many. |
--offset <n> |
skip this many, for the next page. |
--exact |
words as written only; meaning is not searched. |
--timezone <zone> |
the IANA timezone for calendar date boundaries. |
the conversations nearest to a query in meaning and in words, best first, in one chat or every one — meaning after conversations embed; runs on this machine
max search conversations <query> [options]| Аргумент | Что это | |
|---|---|---|
query |
обязательный | what to look for, in your own words, in any language the model reads. |
| Опция | Что делает |
|---|---|
--model <model> |
local: a model id from models text list (default: e5-small); remote: the provider's model. |
--provider <provider> |
embedding provider: local or openai; flags override profile settings. |
--base-url <url> |
a server with OpenAI's /v1/embeddings: Gemini, Jina, or Ollama and LM Studio on this machine. |
--dims <n> |
remote: the vector size — needed with --base-url; shortens an OpenAI model's. |
--max-chats <n> |
at most this many chats; 5 with --sync-first, 20 with --refresh if not given. |
--max-chunks <n> |
at most this many chunks embedded in one run; 2000 if not given. |
--sync-first |
first fetch new messages within the chat, time and message bounds. |
--sync-time <duration> |
stop fetching after this long (default: 30s). |
--max-messages <n> |
fetch at most this many messages total (default: 500). |
--chat <chat> |
only this chat: a chat: its id, or part of its title. |
--since-time <time> |
only those still going at this ISO 8601 time, or 30m / 2h / 1d ago, or later. |
--filter <query> |
strict Lucene filter: any message in a conversation must match; does not change the meaning query. |
--source <accounts> |
accounts to search: personal, bots, all, a provider, or a list like group:work,telegram:Alice,email:me@example.com; defaults to the active account. |
--timezone <zone> |
IANA timezone for filter dates; system timezone by default. |
--limit <n> |
how many. |
--refresh |
first build and embed, on this machine, the chats in scope that changed or were never built — within --max-chats and --max-chunks. |
saved searches and the history of search messages and stats messages show, kept in the local store; --saved runs one
save a search under a name without running it; search messages --saved runs it
max searches create <name> [query] [options]| Аргумент | Что это | |
|---|---|---|
name |
обязательный | up to 64 letters a–z, digits and hyphens, not only digits. |
query |
необязательный | the query, as for search messages; none matches every stored message. |
| Опция | Что делает |
|---|---|
--chat <chat> |
only this chat — the same as chat: in the query; a chat: its id, or part of its title. |
--source <accounts> |
every account of this messenger held in the store; personal, bots or all — the same as in: in the query; or a list: group:work,telegram:Alice,email:me@example.com. |
--limit <n> |
how many. |
--newest |
newest first instead of best first. |
--exact |
bare words and quotes match their exact form only, as exact:word does; text: still matches every form. |
--context <n> |
messages before and after each hit. |
--language <lucene|legacy> |
the query language: strict Lucene or legacy discovery. |
--timezone <zone> |
the IANA timezone for calendar date boundaries. |
--regex |
the words are one regular expression, case-insensitive, tested against every stored text. |
--by <chat|sender|day|hour> |
what stats messages show --saved counts by. |
--selection <json> |
save the resolved parent ranking query and options from a drilldown. |
--replace |
overwrite a saved search of the same name. |
one saved search or earlier run: its query, options and how often it ran
max searches show <name|id>| Аргумент | Что это | |
|---|---|---|
name|id |
обязательный | a saved search's name, or the id of any row of searches history. |
the saved searches, by name
max searches listthe searches and counts that ran, newest first — saved ones included; never their results
max searches history [options]| Опция | Что делает |
|---|---|
--limit <n> |
how many. |
delete a saved search, or one run from the history
max searches delete <name|id>| Аргумент | Что это | |
|---|---|---|
name|id |
обязательный | a saved search's name, or the id of any row of searches history. |
empty the history; saved searches stay
max searches clearthe waits MAX asked this profile to keep, and a hold on its writes
forget them, lift the hold and the profile's pace, once MAX no longer limits the account; changes nothing there
max flood clearmodels that run on this machine
speech models for transcribing voice messages
the speech models, most suitable first, which are downloaded, and which one is the default
max models audio listdownload a speech model once, checked against the sha256 this version expects
max models audio download <model>| Аргумент | Что это | |
|---|---|---|
model |
обязательный | a model id from models audio list. |
embedding models for searching conversations by meaning
the embedding models, most suitable first, which are downloaded, and which one is the default
max models text listdownload an embedding model once, checked against the sha256 this version expects
max models text download <model> [options]| Аргумент | Что это | |
|---|---|---|
model |
обязательный | a model id from models text list. |
| Опция | Что делает |
|---|---|
--accept-terms |
accept the model's licence terms, for a model that has its own. |
API keys for embedding and analysis providers
store a key, typed at a hidden prompt or piped on stdin — never as an argument
max models text key set <provider>| Аргумент | Что это | |
|---|---|---|
provider |
обязательный | openai, anthropic, or the host of a --base-url server that wants a key. |
forget a stored key
max models text key remove <provider>| Аргумент | Что это | |
|---|---|---|
provider |
обязательный | openai, anthropic, or a server's host. |
models that read pictures, for images embed and search by what a picture shows
the picture models, which are downloaded, and which one is the default
max models image listdownload a picture model once, checked against the sha256 this version expects
max models image download <model>| Аргумент | Что это | |
|---|---|---|
model |
обязательный | a model id from models image list. |
read a poll, vote in it, close your own, create one
a poll and its answer ids, as the message carries it now
max polls show <chat> <message>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
message |
обязательный | the id of the message that carries the poll. |
vote in a poll, or take your vote back; the others see it unless the poll is anonymous
Меняет что-то в MAX.
max polls vote <chat> <message> [answers] [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
message |
обязательный | the id of the message that carries the poll. |
answers |
необязательный | answer ids, as polls show prints them. |
| Опция | Что делает |
|---|---|
--retract |
take your vote back. |
close your own poll; nobody can vote after that, and it cannot be reopened
Меняет что-то в MAX.
max polls close <chat> <message>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
message |
обязательный | the id of your own message that carries the poll. |
send a poll to a chat, as a message of its own; public unless --anonymous
Меняет что-то в MAX.
max polls create <chat> <question> <answers> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
question |
обязательный | the question. |
answers |
обязательный | two answers or more. |
| Опция | Что делает |
|---|---|
--topic <id> |
send to this forum topic; unsupported by messengers without topics. |
--multiple |
people may pick several answers. |
--anonymous |
nobody sees who voted for what. |
--revote |
people may change their vote. |
--silent |
send without a notification. |
--send-as <id> |
post as one of the identities chats send-as lists; required where the chat posts as someone else by default. |
--send-id <id> |
repeat a create whose outcome was unknown, without risking a second poll. |
react to messages
put your reaction on a message; it replaces the one you had
Меняет что-то в MAX.
max reactions add <chat> <message> <emoji>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
message |
обязательный | the message id. |
emoji |
обязательный | one emoji, for example 👍. |
take your reaction off a message
Меняет что-то в MAX.
max reactions remove <chat> <message>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat: its id, or part of its title. |
message |
обязательный | the message id. |
the chats this profile may send to, when the list is on
the chats on the list; empty and off until the first add
max recipients listallow sending to this chat; the first add turns the list on
Меняет что-то только на этом компьютере.
max recipients add <chat>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | chat id, or part of a chat name. |
stop allowing this chat; the list stays on
Меняет что-то только на этом компьютере.
max recipients remove <chat>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | chat id, or the title as the list shows it. |
empty the list and turn it off: this profile may send to any chat again
Меняет что-то только на этом компьютере.
max recipients clearevery attempt to send from this profile — never the text
attempts to send, newest first: sent, refused, failed, or not known
max sends list [options]| Опция | Что делает |
|---|---|
--limit <n> |
how many to show. |
other people's unread messages in every chat; --new for what arrived since the last check
max inbox [options]| Опция | Что делает |
|---|---|
--new |
what arrived since the last check, each message once — for scheduled runs. |
--since-time <time> |
what arrived after this ISO 8601 time, or 2h / 1d ago; the saved point stays put. |
--limit <n> |
at most this many per chat, the newest. |
--all |
muted and archived chats too — left out unless they mention you or reply to you. |
--kind <kinds> |
only chats of these kinds, comma-separated: dialog, group, channel, saved. |
--transcribe |
turn voice messages not heard yet into text — by the messenger, or a model on this machine; can take minutes. |
--model <id> |
which downloaded speech model hears them, with --transcribe; models audio list shows them. |
--mark-read |
also mark each chat shown read, up to the newest message shown; the other side sees it. |
--no-mark-read |
do not, whatever the catchUpMarksRead setting says. |
every message, yours too, in chats that changed since a point — for reviewing who owes what
max review [options]| Опция | Что делает |
|---|---|
--since-time <time> |
where the last review ended — ISO 8601, or 2h / 1d ago; 3 days ago if not given. |
--chat <chat> |
only this chat: a chat: its id, or part of its title. |
--kind <kinds> |
only chats of these kinds, comma-separated: dialog, group, channel, saved. |
--unanswered [duration] |
only questions to you or a group's admins that nobody answered, asked at least this long ago — 4h, 1d; 24h if not given. |
--all |
muted and archived chats too — left out unless they mention you or reply to you. |
--transcribe |
turn voice messages not heard yet into text — by the messenger, or a model on this machine; can take minutes. |
--model <id> |
which downloaded speech model hears them, with --transcribe; models audio list shows them. |
--new |
what changed since the last review --new, a point per chat — for scheduled runs. |
--mark-read |
also mark each chat shown read, up to the newest message shown; the other side sees it. |
--no-mark-read |
do not, whatever the catchUpMarksRead setting says. |
rules that answer messages for you, kept in a file of this profile
add a rule with every default written out, off until you edit and enable it
Меняет что-то только на этом компьютере.
max replies add <id>| Аргумент | Что это | |
|---|---|---|
id |
обязательный | lower-case letters, digits and -; unique in this profile. |
enable one reply rule; its template must be ready
Меняет что-то только на этом компьютере.
max replies on <id>| Аргумент | Что это | |
|---|---|---|
id |
обязательный | the rule's id. |
disable one reply rule
Меняет что-то только на этом компьютере.
max replies off <id>| Аргумент | Что это | |
|---|---|---|
id |
обязательный | the rule's id. |
change only the named fields of a reply rule; lists replace the whole list
Меняет что-то только на этом компьютере.
max replies edit <id> [options]| Аргумент | Что это | |
|---|---|---|
id |
обязательный | the rule's id. |
| Опция | Что делает |
|---|---|
--do <actions> |
actions: reply, task, or both, comma-separated. |
--kinds <kinds> |
chat kinds: dialog, group; comma-separated, empty for any. |
--chats <ids> |
only these chat ids, comma-separated; empty for any. |
--not-chats <ids> |
leave these chat ids out, comma-separated; empty clears. |
--words <words> |
match any of these whole words, comma-separated; empty clears. |
--question |
match only questions. |
--no-question |
do not require a question. |
--mentions-me |
require a mention of you or a reply to you. |
--no-mentions-me |
do not require a mention of you or a reply to you. |
--people <ids> |
only these sender ids, comma-separated; empty for any. |
--not-people <ids> |
leave these sender ids out, comma-separated; empty clears. |
--contacts-only |
match only contacts. |
--no-contacts-only |
do not require a contact. |
--template <text> |
the reply template. |
--model <mode> |
legacy template mode: fill-only or may-reword; use ai blocks instead. |
--as-reply |
send as a reply to the matched message. |
--no-as-reply |
send without linking to the matched message. |
--per-chat <limit> |
at most this many per chat, such as 1/12h. |
--per-person <limit> |
at most this many per person, such as 1/1d. |
--outside <hours> |
answer outside this 24-hour window, such as 09:00-19:00. |
--days <days> |
days of the working window, such as mon-fri or sat,sun. |
--timezone <zone> |
the IANA timezone for the working window. |
--no-hours |
clear the working window. |
show the reply audience, who the rules may answer, or replace its named fields; a new file answers everyone a rule matches
Меняет что-то только на этом компьютере.
max replies audience [options]| Опция | Что делает |
|---|---|
--reply <mode> |
answer all or only listed senders and chats: all, listed. |
--allow-people <ids> |
replace allowed sender ids, comma-separated; empty clears. |
--allow-chats <ids> |
replace allowed chat ids, comma-separated; empty clears. |
--deny-people <ids> |
replace denied sender ids, comma-separated; empty clears; deny wins. |
--deny-chats <ids> |
replace denied chat ids, comma-separated; empty clears; deny wins. |
consent for reply models once per profile and endpoint, with chat opt-outs
show the reply model consent and chat opt-outs; never calls a model
max replies consents showallow incoming message data to go to the configured reply model for this profile; chat opt-outs remain
Меняет что-то только на этом компьютере.
max replies consents grantrevoke the profile's reply model consent immediately; chat opt-outs remain
Меняет что-то только на этом компьютере.
max replies consents revokekeep this chat's incoming data away from the reply model
Меняет что-то только на этом компьютере.
max replies consents deny <chat>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | the native chat id, used as written; never resolved over the network. |
remove this chat's model opt-out; does not grant profile consent
Меняет что-то только на этом компьютере.
max replies consents allow <chat>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | the native chat id, used as written; never resolved over the network. |
what the rules would have answered in the stored messages, to whom and why — sends nothing, changes nothing, never connects
max replies test [rule] [options]| Аргумент | Что это | |
|---|---|---|
rule |
необязательный | only this rule, by its id; every rule in file order if not given. |
| Опция | Что делает |
|---|---|
--since-time <time> |
from this ISO 8601 time, or 2h / 1d ago; 7d ago if not given. |
--ai |
call the configured reply model with stored message data; requires reply consent, otherwise uses fallback. |
stop every reply rule of this profile at once, a running serve too; resume undoes it
max replies pauselet the reply rules answer again after pause
max replies resumewhether the rules may send, which are on, and who they may answer
max replies statusstay connected to MAX and stream new messages to max watch, until Ctrl-C
max serve [options]| Опция | Что делает |
|---|---|
--idle <duration> |
stop after this long with nobody using it — 15m, 1h is 60m. |
max serve in the background: start, stop, restart, status, logs; install adds a systemd or launchd unit
start serve in the background — through the unit if one is installed — and answer once it connects
max server start [options]| Опция | Что делает |
|---|---|
--idle <duration> |
stop after this long with nobody using it — 15m, 1h. |
stop this profile's serve — through the unit if it runs under one
max server stopstop it and start it again
max server restart [options]| Опция | Что делает |
|---|---|
--idle <duration> |
stop after this long with nobody using it — 15m, 1h. |
whether serve runs for this profile, since when, who started it, and the unit if there is one
max server statusserve's latest log lines — from the journal under systemd, else its log file
max server logs [options]| Опция | Что делает |
|---|---|
-n, --lines <n> |
how many lines. По умолчанию: 50. |
write a systemd user unit or a launchd agent for this profile; starts nothing
max server installremove this profile's unit; stop it first
max server uninstallrun a max command or an agent later or on a timer (systemd, launchd, Task Scheduler); an agent cannot send
run max <args…> on a timer — reads save what they read, so this is how a chat's history fills the store
max schedule command <name> <args> [options]| Аргумент | Что это | |
|---|---|---|
name |
обязательный | lowercase letters, digits and dashes. |
args |
обязательный | the max command after its name, e.g. -- messages list --limit 50. |
| Опция | Что делает |
|---|---|
--every <duration> |
repeat: 30m, 2h, 1d. |
--at <HH:MM> |
every day at this local time. |
--once <when> |
one run: 30m, 2d from now, or an ISO time; the schedule removes itself after it. |
start an agent (claude or codex) with a prompt on a timer; it runs with MAX_READ_ONLY=1, so it reads and drafts and cannot send — its answer is kept and you are notified
max schedule agent <name> <harness> <prompt> [options]| Аргумент | Что это | |
|---|---|---|
name |
обязательный | lowercase letters, digits and dashes. |
harness |
обязательный | the agent to start. Одно из: claude, codex. |
prompt |
обязательный | what to do, e.g. "run the daily follow-up review: max skill show follow-ups". |
| Опция | Что делает |
|---|---|
--max-cost <usd> |
claude only: stop a run that costs more than this, in US dollars. |
--every <duration> |
repeat: 30m, 2h, 1d. |
--at <HH:MM> |
every day at this local time. |
--once <when> |
one run: 30m, 2d from now, or an ISO time; the schedule removes itself after it. |
the schedules, when they run and how their last run went
max schedule listrun a schedule now, as its timer would, and wait for it
max schedule run <name>| Аргумент | Что это | |
|---|---|---|
name |
обязательный |
stop a schedule and remove its timer; its past output stays
max schedule remove <name>| Аргумент | Что это | |
|---|---|---|
name |
обязательный |
what a timer runs, given the schedule's file; to run one by hand, use run
max schedule exec <file>| Аргумент | Что это | |
|---|---|---|
file |
обязательный |
print new messages as they arrive, from a running max serve
max watch [options]| Опция | Что делает |
|---|---|
--events |
also print edits, deletions, reactions, reads and chat changes; every line then names its event. |
the settings in force, and where each one came from
the profile, the profiles that exist, and each setting with where it came from
max config show [options]| Опция | Что делает |
|---|---|
--bot |
the settings a bot command on this profile gets, rather than the personal account's. |
replace legacy access settings with permissions, preserving effective levels
Меняет что-то только на этом компьютере.
max config migrate [options]| Опция | Что делает |
|---|---|
--dry-run |
show the migration without writing the file. |
save a setting to the configuration file
Меняет что-то только на этом компьютере.
max config set <setting> <value> [options]| Аргумент | Что это | |
|---|---|---|
setting |
обязательный | one of: limit, timeoutMs, color, record, keepRunsForDays, readOnly, allow, permissions, sendsPerHour, requestsPerMinute, embeddingProvider, embeddingModel, embeddingBaseUrl, embeddingDims, analysisProvider, analysisModel, analysisBaseUrl, models, senderColors, catchUpMarksRead, searchCatchUp, serve, mcpTools, readOtherBots, updateCheck, skillHint, transcribeModel, defaultProfile, searchStemmers.cyrillic, searchStemmers.latin. |
value |
обязательный | a number, true or false, or for allow a list like send,reaction. |
| Опция | Что делает |
|---|---|
--defaults |
change what every profile gets, rather than this profile. |
--personal |
only for personal accounts — the personal section of the file. |
--bot |
only for bots — the bot section of the file. |
remove a setting from the configuration file
Меняет что-то только на этом компьютере.
max config unset <setting> [options]| Аргумент | Что это | |
|---|---|---|
setting |
обязательный | one of: limit, timeoutMs, color, record, keepRunsForDays, readOnly, allow, permissions, sendsPerHour, requestsPerMinute, embeddingProvider, embeddingModel, embeddingBaseUrl, embeddingDims, analysisProvider, analysisModel, analysisBaseUrl, models, senderColors, catchUpMarksRead, searchCatchUp, serve, mcpTools, readOtherBots, updateCheck, skillHint, transcribeModel, defaultProfile, searchStemmers.cyrillic, searchStemmers.latin. |
| Опция | Что делает |
|---|---|
--defaults |
change what every profile gets, rather than this profile. |
--personal |
only for personal accounts — the personal section of the file. |
--bot |
only for bots — the bot section of the file. |
the state this installation is in, without contacting MAX unless --online
max doctor [options]| Опция | Что делает |
|---|---|
--online |
also log in once, read one chat and start the MCP server; sends nothing. |
what a problem report holds and where it goes; writes nothing
write a problem report to a file, and print how to send it
max doctor report create [options]| Опция | Что делает |
|---|---|
--run <id> |
the run the report is about; the newest failed one if not given. |
--output <file> |
where to write it; a new file in this directory if not given. |
recorded runs — what this tool did, and when
recorded runs, newest first
max runs list [options]| Опция | Что делает |
|---|---|
--limit <n> |
how many to show. По умолчанию: 20. |
one run: what it was, how it ended and what went wrong; -v for every event
max runs show <run-id>| Аргумент | Что это | |
|---|---|---|
run-id |
обязательный | an id from max runs list. |
search recorded diagnostic metadata and events; no message contents
max runs search [query] [options]| Аргумент | Что это | |
|---|---|---|
query |
необязательный | case-insensitive literal diagnostic text. |
| Опция | Что делает |
|---|---|
--status <status> |
run outcome. Одно из: success, failed, partial, running. |
--error-code <code> |
one stable error code. |
--operation <name> |
one operation, such as messages.download. |
--profile <name> |
one recorded profile. |
--since-time <time> |
runs starting on or after an ISO time or 2h / 1d ago. |
--limit <n> |
matches per page, at most 100. По умолчанию: 20. |
--page <n> |
result page. По умолчанию: 1. |
the directory holding one run
max runs path <run-id>| Аргумент | Что это | |
|---|---|---|
run-id |
обязательный | an id from max runs list. |
the instructions an agent is given for this tool
print SKILL.md — max skill install puts it where Claude Code, Codex and Gemini CLI look for it
max skill show [name]| Аргумент | Что это | |
|---|---|---|
name |
необязательный | one of the skills shipped for a task: follow-ups, link-conversations. |
write SKILL.md to ~/.claude/skills/max-cli/ (Claude Code) and ~/.agents/skills/max-cli/ (Codex, Gemini CLI)
max skill install [options]| Опция | Что делает |
|---|---|
--for <agents> |
which agents to install for. Одно из: claude, agents, all. По умолчанию: all. |
commands, options and exit codes as JSON — inspect one command path per call
one command's argv and result schemas, effects, permissions and retry guidance
max commands schema <path>| Аргумент | Что это | |
|---|---|---|
path |
обязательный | one command path, for example: stats messages show. |
upgrade max with the package manager that installed it; --check only looks
max upgrade [options]| Опция | Что делает |
|---|---|
--check |
say whether a newer version exists, and install nothing. |
shell completion: max complete zsh prints the script to source
max complete [words]| Аргумент | Что это | |
|---|---|---|
words |
необязательный |
serve this profile to an agent over MCP, on stdin and stdout — claude mcp add max -- max mcp
max mcp [options]| Опция | Что делает |
|---|---|
--permission <key=level> |
override a permission for this server only; repeat for more keys. |
--allow-dangerous |
no longer used — writes show no form; the profile's permissions decide. |
--allow-send |
deprecated: use permissions.messages.send in config; does not grant access. |
--confirm-send |
no longer used — writes show no form; the profile's permissions decide. |
--allow-mark-read |
deprecated: use permissions.chats.mark-read in config; does not grant access. |
--allow-delete |
deprecated: use permissions.messages.delete in config; does not grant access. |
--allow-moderate |
deprecated: use permissions.chats.moderate and group rules; does not grant access. |
--http |
serve over HTTP on 127.0.0.1 for ChatGPT and Claude in the browser, behind your tunnel; the profile's permissions decide. |
--http-confirmation <mode> |
no longer used — writes show no form; the profile's permissions decide. |
--port <port> |
the local port for --http (default 8765). |
--public-url <url> |
the tunnel's https address the browser apps use, e.g. https://.ts.net. |
--revoke |
forget every login given to a browser app; each must log in again. |
print the mcpServers entry for Claude Desktop, Cursor and others, with full paths; writes nothing
max mcp config [options]| Опция | Что делает |
|---|---|
--permission <key=level> |
override a permission for this server only; repeat for more keys. |
--allow-dangerous |
no longer used — writes show no form; the profile's permissions decide. |
--allow-send |
deprecated: use permissions.messages.send in config; does not grant access. |
--confirm-send |
no longer used — writes show no form; the profile's permissions decide. |
--allow-mark-read |
deprecated: use permissions.chats.mark-read in config; does not grant access. |
--allow-delete |
deprecated: use permissions.messages.delete in config; does not grant access. |
--allow-moderate |
deprecated: use permissions.chats.moderate and group rules; does not grant access. |
add this profile's local MCP server to Codex or Claude Code
Меняет что-то только на этом компьютере.
max mcp setup <client> [options]| Аргумент | Что это | |
|---|---|---|
client |
обязательный | codex or claude-code. |
| Опция | Что делает |
|---|---|
--allow-writes |
acknowledge that this profile offers writing tools. |
--permission <key=level> |
override a permission for this server only; repeat for more keys. |
--allow-dangerous |
no longer used — writes show no form; the profile's permissions decide. |
--allow-send |
deprecated: use permissions.messages.send in config; does not grant access. |
--confirm-send |
no longer used — writes show no form; the profile's permissions decide. |
--allow-mark-read |
deprecated: use permissions.chats.mark-read in config; does not grant access. |
--allow-delete |
deprecated: use permissions.messages.delete in config; does not grant access. |
--allow-moderate |
deprecated: use permissions.chats.moderate and group rules; does not grant access. |
check this profile's local MCP handshake and tool list
max mcp doctor [options]| Опция | Что делает |
|---|---|
--permission <key=level> |
override a permission for this server only; repeat for more keys. |
--allow-dangerous |
no longer used — writes show no form; the profile's permissions decide. |
--allow-send |
deprecated: use permissions.messages.send in config; does not grant access. |
--confirm-send |
no longer used — writes show no form; the profile's permissions decide. |
--allow-mark-read |
deprecated: use permissions.chats.mark-read in config; does not grant access. |
--allow-delete |
deprecated: use permissions.messages.delete in config; does not grant access. |
--allow-moderate |
deprecated: use permissions.chats.moderate and group rules; does not grant access. |
a MAX bot, through the official Bot API and a bot token — not your personal account
the bot token this profile uses
check a bot token with MAX, then keep it — typed at a hidden prompt or piped on stdin
Меняет что-то только на этом компьютере.
max bot auth setwhere this profile's bot token comes from, and which bot it is
max bot auth showforget this profile's bot token
Меняет что-то только на этом компьютере.
max bot auth removeevery name on this machine that has a bot token; --check asks MAX which bot each is
max bot list [options]| Опция | Что делает |
|---|---|
--check |
ask the messenger who each bot is, with its token. |
the chats this bot is in — MAX gives a bot no list of them, so list shows the ones it has seen
chats this bot has seen on this machine — not a complete list from MAX
max bot chats listone chat from MAX, and remember it
max bot chats show <chat>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat id, user: for a person, or the title of a chat this bot has seen. |
take the bot out of a chat; only an admin of the chat can bring it back
Меняет что-то в MAX.
max bot chats leave <chat>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat id, or the title of a chat this bot has seen. |
show what the bot is doing in a chat — typing, sending a photo — for a few seconds
Меняет что-то в MAX.
max bot chats action <chat> <action>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat id, user: for a person, or the title of a chat this bot has seen. |
action |
обязательный | what the chat sees. Одно из: typing, photo, video, voice, file. |
the admins of a chat the bot is an admin in
the chat's admins and what each may do
max bot chats admins list <chat>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat id, or the title of a chat this bot has seen. |
make a member an admin with these rights
Меняет что-то в MAX.
max bot chats admins add <chat> <person> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat id, or the title of a chat this bot has seen. |
person |
обязательный | the person's user id. |
| Опция | Что делает |
|---|---|
--can <rights> |
what they may do, comma-separated: read, members, admins, info, pin, link, edit, delete. |
--title <title> |
the title shown beside their name. |
take an admin's rights back; they stay a member
Меняет что-то в MAX.
max bot chats admins remove <chat> <person>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat id, or the title of a chat this bot has seen. |
person |
обязательный | the person's user id. |
the people in a chat the bot is an admin in
take a person out of a chat; their messages stay
Меняет что-то в MAX.
max bot chats members remove <chat> <person> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat id, or the title of a chat this bot has seen. |
person |
обязательный | the person's user id. |
| Опция | Что делает |
|---|---|
--block |
also keep them from coming back by the chat's link. |
members of a chat, a page at a time — --marker takes the marker the last page gave
max bot chats members list <chat> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный |
| Опция | Что делает |
|---|---|
--limit <n> |
how many, up to 100. |
--marker <marker> |
continue from here. |
add people to a chat by user id, at most 100; the bot must be an admin that may add members
Меняет что-то в MAX.
max bot chats members add <chat> <users>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | |
users |
обязательный |
a chat's moderation rules for this bot, kept on this machine
the chat's rules; the defaults, marked not saved, if it has none yet
max bot chats rules show <chat>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a group's id, or the title of a group this bot has seen. |
change one rule — trusted, blocked, blockedNames, links, invites, forwards, blockedPeople, flood.messages, flood.minutes, flood.action, newAccount.days, newAccount.action, consent.delete, consent.remove
Меняет что-то только на этом компьютере.
max bot chats rules set <chat> <key> <value>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a group's id, or the title of a group this bot has seen. |
key |
обязательный | the rule. |
value |
обязательный | its new value. |
put one rule back to its default
Меняет что-то только на этом компьютере.
max bot chats rules unset <chat> <key>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a group's id, or the title of a group this bot has seen. |
key |
обязательный | the rule. |
judge a group's new messages and joins by its rules, and act as they allow — as the bot
Меняет что-то в MAX.
max bot chats moderate <chat> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a group's id, or the title of a group this bot has seen. |
| Опция | Что делает |
|---|---|
--since-time <time> |
judge what came after this ISO 8601 time, or 2h / 1d ago; the saved point stays. |
--dry-run |
judge and plan; do nothing. |
--allow-dangerous |
yes to every action whose level in the group's rules is ask. |
--no-ban |
remove without banning; by default a removed person cannot come back by the link. |
--max-actions <n> |
at most this many actions in one run; 10 if not given. |
the messages in the chats this bot is in
send a message as the bot; without [text], the text is read from stdin
Меняет что-то в MAX.
max bot messages send <chat> [text] [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat id, user: for a person, or the title of a chat this bot has seen. |
text |
необязательный | the message. |
| Опция | Что делает |
|---|---|
--reply-to <message> |
answer this message, by its id in the same chat. |
--silent |
deliver without a notification. |
--md |
read this messenger's Markdown; see its formatting guide for supported syntax. |
--html |
the text is HTML: , , , .
|
--file <file> |
attach a file; the text becomes its caption. |
--photo <file> |
attach a .jpg, .png or .webp as a photo; the text becomes its caption. |
--as-file |
send the --file as a file to download, a video included. |
--voice <file> |
send an Ogg Opus file as a voice message, alone, with no text. |
--allow-any-file |
send a file even from credential folders or this CLI's own folders. |
the latest messages in a chat; where MAX gives a bot no history, and with --offline, the ones this bot has seen on this machine
max bot messages list <chat> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat id, user: for a person, or the title of a chat this bot has seen. |
| Опция | Что делает |
|---|---|
--limit <n> |
how many, the newest. |
one message by its id in a chat
max bot messages show <chat> <message>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat id, user: for a person, or the title of a chat this bot has seen. |
message |
обязательный | message id. |
replace the text of a message the bot sent
Меняет что-то в MAX.
max bot messages edit <chat> <message> <text> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat id, user: for a person, or the title of a chat this bot has seen. |
message |
обязательный | message id. |
text |
обязательный | the new text. |
| Опция | Что делает |
|---|---|
--md |
read this messenger's Markdown; see its formatting guide for supported syntax. |
--html |
the text is HTML: , , , .
|
delete messages in a chat the bot can delete in; it cannot be undone
Меняет что-то в MAX.
max bot messages delete <chat> <messages> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat id, user: for a person, or the title of a chat this bot has seen. |
messages |
обязательный | message ids. |
| Опция | Что делает |
|---|---|
--allow-dangerous |
delete without asking. |
pin a message in a chat; quietly unless --notify
Меняет что-то в MAX.
max bot messages pin <chat> <message> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat id, user: for a person, or the title of a chat this bot has seen. |
message |
обязательный | message id. |
| Опция | Что делает |
|---|---|
--notify |
tell the chat's members. |
unpin a message in a chat
Меняет что-то в MAX.
max bot messages unpin <chat> <message>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat id, user: for a person, or the title of a chat this bot has seen. |
message |
обязательный | message id. |
what two or more people wrote in the chats they have all written in — from the local copy, grouped by chat, oldest first; --limit counts per chat. Common chats are the ones this copy saw each of them write in, not a member list from MAX
max bot messages between <people> [options]| Аргумент | Что это | |
|---|---|---|
people |
обязательный | two or more people — an id, @username or part of a name each. |
| Опция | Что делает |
|---|---|
--all-bots |
also read every other bot's copy on this machine that readOtherBots allows. |
--bots <profiles> |
also read these bots' copies, comma separated — each allowed by readOtherBots. |
--limit <n> |
how many of the latest messages from each chat. |
find what this bot's local copy holds, by text
search the messages this bot has read, sent or received on this machine — the local copy only, best match first; every word must appear; "a phrase", -word, a OR b, from: chat: after: before: has:; by text, by --from, or both
max bot search messages [query] [options]| Аргумент | Что это | |
|---|---|---|
query |
необязательный | the words to find. |
| Опция | Что делает |
|---|---|
--all-bots |
also read every other bot's copy on this machine that readOtherBots allows. |
--bots <profiles> |
also read these bots' copies, comma separated — each allowed by readOtherBots. |
--limit <n> |
how many. |
--newest |
newest first instead of best first. |
--from <who> |
only what this person wrote — an id, @username or part of a name; repeat it for any of several. |
the chats this bot may write to; with no list, every chat — clear removes the list
the chats on the list, or nothing when there is no list
max bot recipients listallow a chat: its id, user:<id>, or the title of a chat this bot has seen
Меняет что-то только на этом компьютере.
max bot recipients add <chat>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный |
take a chat off the list
Меняет что-то только на этом компьютере.
max bot recipients remove <chat>| Аргумент | Что это | |
|---|---|---|
chat |
обязательный |
remove the list: the bot may write to any chat again
Меняет что-то только на этом компьютере.
max bot recipients clearwhat this bot sent, edited and deleted from this machine — ids and outcomes, never text
max bot sends listprint new messages as they arrive and keep them, until Ctrl-C or --timeout (either ends it normally)
max bot watch [options]| Опция | Что делает |
|---|---|
--events |
also edits, deletions, buttons pressed and people coming and going; every line names its event. |
--types <types> |
only these update types, comma-separated, in the messenger's words. |
answers to the buttons people press under the bot's messages
answer a pressed button by its callback id: --notification shows the person a one-time note, --text replaces the message the button was on
Меняет что-то в MAX.
max bot callbacks answer <callback> [options]| Аргумент | Что это | |
|---|---|---|
callback |
обязательный | the callback id bot watch printed. |
| Опция | Что делает |
|---|---|
--text <text> |
the message's new text. |
--notification <text> |
a note only the person who pressed sees. |
the bot's command menu — what people see after /
the commands in the menu now
max bot commands listreplace the whole menu: each command as name=description, e.g. start=Begin
Меняет что-то в MAX.
max bot commands set <commands>| Аргумент | Что это | |
|---|---|---|
commands |
обязательный | name=description, one per command. |
empty the menu
Меняет что-то в MAX.
max bot commands clearwhere the messenger pushes this bot's updates — while one is set, bot watch gets nothing
the webhooks this bot has
max bot webhooks listsend this bot's updates to an HTTPS address; refused while another is set
Меняет что-то в MAX.
max bot webhooks set <url> [options]| Аргумент | Что это | |
|---|---|---|
url |
обязательный | the HTTPS address. |
| Опция | Что делает |
|---|---|
--types <types> |
only these update types, comma-separated, in the messenger's words. |
--secret-stdin |
a secret the messenger sends back with each update — asked for, or read from a pipe. |
--add |
keep the webhooks already set and add this one beside them. |
stop sending updates to this address; with none left, bot watch works again
Меняет что-то в MAX.
max bot webhooks delete <url>| Аргумент | Что это | |
|---|---|---|
url |
обязательный | the address. |
people this bot has seen write — from the local copy on this machine, never asking MAX unless told to
one person: the chats they wrote in (with their last message there) and the latest messages of their private chat with the bot
max bot contacts show <who> [options]| Аргумент | Что это | |
|---|---|---|
who |
обязательный | an id, @username or part of a name. |
| Опция | Что делает |
|---|---|
--all-bots |
also read every other bot's copy on this machine that readOtherBots allows. |
--bots <profiles> |
also read these bots' copies, comma separated — each allowed by readOtherBots. |
--limit <n> |
how many messages from the private chat. |
--refresh |
read the private chat with them again from the messenger first — one request. |
the bot's local copy on this machine
fetch a chat's history into the bot's local copy, newest first; run it again to continue
max bot store fetch <chat> [options]| Аргумент | Что это | |
|---|---|---|
chat |
обязательный | a chat id, or the title of a chat this bot has seen. |
| Опция | Что делает |
|---|---|
--limit <n> |
at most this many messages in this run; 1000 if not given. |
--page-size <n> |
how many messages one request asks for; 100 if not given. |
--pause <duration> |
pause between pages, to stay under the messenger's limits. По умолчанию: 1s. |
--since-time <time> |
stop once it reaches messages older than this: ISO 8601, or 2h / 1d ago. |
--last <n> |
stop once the newest n messages are held. |
serve this bot to an agent over MCP, on stdin and stdout — claude mcp add sales-bot -- max sales bot mcp
max bot mcp [options]| Опция | Что делает |
|---|---|
--confirm-send |
no longer used — writes show no form; the profile's permissions decide. |
--allow-dangerous |
no longer used — writes show no form; the profile's permissions decide. |
--allow-send |
no longer used — the profile's permissions decide; kept so an old setup still starts. |
--allow-delete |
no longer used — the profile's permissions decide. |
--allow-moderate |
no longer used — the profile's permissions decide. |
print the mcpServers entry for Claude Desktop, Cursor and others, with full paths; writes nothing
max bot mcp config [options]| Опция | Что делает |
|---|---|
--confirm-send |
no longer used — writes show no form; the profile's permissions decide. |
--allow-dangerous |
no longer used — writes show no form; the profile's permissions decide. |
--allow-send |
no longer used — the profile's permissions decide; kept so an old setup still starts. |
--allow-delete |
no longer used — the profile's permissions decide. |
--allow-moderate |
no longer used — the profile's permissions decide. |
the bot this profile's token belongs to: name, id, description, commands
max bot mecomments under a channel post — each command takes the post's message id (mid.…) first
the comments under a post, newest last
max bot comments list <message> [options]| Аргумент | Что это | |
|---|---|---|
message |
обязательный |
| Опция | Что делает |
|---|---|
--limit <n> |
how many, up to 100. |
one comment under a post
max bot comments get <message> <comment>| Аргумент | Что это | |
|---|---|---|
message |
обязательный | |
comment |
обязательный |
comment under a post as the bot; - reads stdin
Меняет что-то в MAX.
max bot comments send <message> <text> [options]| Аргумент | Что это | |
|---|---|---|
message |
обязательный | |
text |
обязательный |
| Опция | Что делает |
|---|---|
--format <format> |
how the text is marked up. Одно из: markdown, html. |
replace the text of a comment the bot wrote; - reads stdin
Меняет что-то в MAX.
max bot comments edit <message> <comment> <text> [options]| Аргумент | Что это | |
|---|---|---|
message |
обязательный | |
comment |
обязательный | |
text |
обязательный |
| Опция | Что делает |
|---|---|
--format <format> |
how the text is marked up. Одно из: markdown, html. |
delete a comment under a post
Меняет что-то в MAX.
max bot comments delete <message> <comment> [options]| Аргумент | Что это | |
|---|---|---|
message |
обязательный | |
comment |
обязательный |
| Опция | Что делает |
|---|---|
--allow-dangerous |
skip confirmation for bot.messages.delete at level ask. |
files uploaded to MAX, to attach to a message
upload a file from disk and print the attachment to put in a message's attachments — messages send --file does both steps at once
Меняет что-то в MAX.
max bot uploads put <file> [options]| Аргумент | Что это | |
|---|---|---|
file |
обязательный |
| Опция | Что делает |
|---|---|
--type <type> |
upload as this kind instead of guessing by extension. Одно из: image, video, audio, file. |
every operation of the official Bot API, generated from its schema — docs/dev/bot-api-coverage.md
max bot api [options]| Опция | Что делает |
|---|---|
--store-token <profile> |
keep a returned authentication token only in this bot profile's OS keyring; never print it. |
Get current bot info — read (GET /me)
max bot api get-my-infoEdit current bot commands — write (PATCH /me/commands)
Меняет что-то в MAX.
max bot api edit-my-commands [options]| Опция | Что делает |
|---|---|
--body <json> |
the request body as JSON; - reads it from stdin. |
--body-file <path> |
the request body from a JSON file; - is stdin. |
Get chat — read (GET /chats/{chatId})
max bot api get-chat [options]| Опция | Что делает |
|---|---|
--chat-id <value> |
Requested chat or channel identifier. |
Edit chat or channel info — write (PATCH /chats/{chatId})
Меняет что-то в MAX.
max bot api edit-chat [options]| Опция | Что делает |
|---|---|
--chat-id <value> |
Chat or channel identifier. |
--body <json> |
the request body as JSON; - reads it from stdin. |
--body-file <path> |
the request body from a JSON file; - is stdin. |
Send action — write (POST /chats/{chatId}/actions)
Меняет что-то в MAX.
max bot api send-action [options]| Опция | Что делает |
|---|---|
--chat-id <value> |
Chat identifier. |
--body <json> |
the request body as JSON; - reads it from stdin. |
--body-file <path> |
the request body from a JSON file; - is stdin. |
Get pinned message — read (GET /chats/{chatId}/pin)
max bot api get-pinned-message [options]| Опция | Что делает |
|---|---|
--chat-id <value> |
Chat identifier to get its pinned message. |
Pin message — write (PUT /chats/{chatId}/pin)
Меняет что-то в MAX.
max bot api pin-message [options]| Опция | Что делает |
|---|---|
--chat-id <value> |
Chat identifier where message should be pinned. |
--body <json> |
the request body as JSON; - reads it from stdin. |
--body-file <path> |
the request body from a JSON file; - is stdin. |
Unpin message — write (DELETE /chats/{chatId}/pin)
Меняет что-то в MAX.
max bot api unpin-message [options]| Опция | Что делает |
|---|---|
--chat-id <value> |
Chat identifier to remove pinned message. |
Get chat or channel membership — read (GET /chats/{chatId}/members/me)
max bot api get-membership [options]| Опция | Что делает |
|---|---|
--chat-id <value> |
Chat or channel identifier. |
Leave chat — destructive (DELETE /chats/{chatId}/members/me)
Меняет что-то в MAX.
max bot api leave-chat [options]| Опция | Что делает |
|---|---|
--chat-id <value> |
Chat or channel identifier. |
Get chat or channel admins — read (GET /chats/{chatId}/members/admins)
max bot api get-admins [options]| Опция | Что делает |
|---|---|
--chat-id <value> |
Chat or channel identifier. |
Set chat or channel admins — write (POST /chats/{chatId}/members/admins)
Меняет что-то в MAX.
max bot api post-admins [options]| Опция | Что делает |
|---|---|
--chat-id <value> |
Chat or channel identifier. |
--body <json> |
the request body as JSON; - reads it from stdin. |
--body-file <path> |
the request body from a JSON file; - is stdin. |
Revoke admin rights — write (DELETE /chats/{chatId}/members/admins/{userId})
Меняет что-то в MAX.
max bot api delete-admins [options]| Опция | Что делает |
|---|---|
--chat-id <value> |
Chat or channel identifier. |
--user-id <value> |
User identifier. |
Get members — read (GET /chats/{chatId}/members)
max bot api get-members [options]| Опция | Что делает |
|---|---|
--chat-id <value> |
Chat or channel identifier. |
--user-ids <value> |
Comma-separated list of users identifiers to get their membership. When this parameter is passed, both count and marker are ignored. |
--marker <value> |
Marker. |
--count <value> |
Count. |
Add members — write (POST /chats/{chatId}/members)
Меняет что-то в MAX.
max bot api add-members [options]| Опция | Что делает |
|---|---|
--chat-id <value> |
Chat identifier. |
--body <json> |
the request body as JSON; - reads it from stdin. |
--body-file <path> |
the request body from a JSON file; - is stdin. |
Remove member — write (DELETE /chats/{chatId}/members)
Меняет что-то в MAX.
max bot api remove-member [options]| Опция | Что делает |
|---|---|
--chat-id <value> |
Chat or channel identifier. |
--user-id <value> |
User id to remove from chat or channel. |
--block <value> |
Set to true if user should be blocked in chat. |
Get subscriptions — read (GET /subscriptions)
max bot api get-subscriptionsSubscribe — write (POST /subscriptions)
Меняет что-то в MAX.
max bot api subscribe [options]| Опция | Что делает |
|---|---|
--body <json> |
the request body as JSON; - reads it from stdin. |
--body-file <path> |
the request body from a JSON file; - is stdin. |
Unsubscribe — write (DELETE /subscriptions)
Меняет что-то в MAX.
max bot api unsubscribe [options]| Опция | Что делает |
|---|---|
--url <value> |
URL to remove from WebHook subscriptions. |
Get upload URL — write (POST /uploads)
Меняет что-то в MAX.
max bot api get-upload-url [options]| Опция | Что делает |
|---|---|
--type <value> |
Uploaded file type: image, audio, video, file. |
Get messages — read (GET /messages)
max bot api get-messages [options]| Опция | Что делает |
|---|---|
--chat-id <value> |
Chat or channel identifier to get messages in chat or channel. |
--message-ids <value> |
Comma-separated list of message ids to get. |
--from <value> |
Start time for requested messages - use after instead. |
--to <value> |
End time for requested messages - use before instead. |
--before <value> |
Messages before timestamp. |
--after <value> |
Messages after timestamp. |
--count <value> |
Maximum amount of messages in response. |
Send message — write (POST /messages)
Меняет что-то в MAX.
max bot api send-message [options]| Опция | Что делает |
|---|---|
--user-id <value> |
Fill this parameter if you want to send message to user. |
--chat-id <value> |
Fill this if you send message to chat or channel. |
--disable-link-preview <value> |
If false, server will not generate media preview for links in text. |
--body <json> |
the request body as JSON; - reads it from stdin. |
--body-file <path> |
the request body from a JSON file; - is stdin. |
Edit message — write (PUT /messages)
Меняет что-то в MAX.
max bot api edit-message [options]| Опция | Что делает |
|---|---|
--message-id <value> |
Editing message identifier. |
--body <json> |
the request body as JSON; - reads it from stdin. |
--body-file <path> |
the request body from a JSON file; - is stdin. |
Delete message — destructive (DELETE /messages)
Меняет что-то в MAX.
max bot api delete-message [options]| Опция | Что делает |
|---|---|
--message-id <value> |
Deleting message identifier. |
--allow-dangerous |
skip confirmation for bot.messages.delete at level ask. |
Get message — read (GET /messages/{messageId})
max bot api get-message-by-id [options]| Опция | Что делает |
|---|---|
--message-id <value> |
Message identifier (mid) to get single message in chat or channel. |
Get comments — read (GET /messages/{messageId}/comments)
max bot api get-comments [options]| Опция | Что делает |
|---|---|
--message-id <value> |
Message identifier (mid) of the commented message. |
--comment-ids <value> |
Comma-separated list of comment ids to get. |
--before <value> |
Comments before timestamp. |
--after <value> |
Comments after timestamp. |
--count <value> |
Maximum amount of comments in response. |
Send comment — write (POST /messages/{messageId}/comments)
Меняет что-то в MAX.
max bot api send-comment [options]| Опция | Что делает |
|---|---|
--message-id <value> |
Message identifier (mid) of the commented message. |
--disable-link-preview <value> |
If false, server will not generate media preview for links in text. |
--body <json> |
the request body as JSON; - reads it from stdin. |
--body-file <path> |
the request body from a JSON file; - is stdin. |
Edit comment — write (PUT /messages/{messageId}/comments)
Меняет что-то в MAX.
max bot api edit-comment [options]| Опция | Что делает |
|---|---|
--message-id <value> |
Message identifier (mid) of the commented message. |
--comment-id <value> |
Editing comment identifier. |
--body <json> |
the request body as JSON; - reads it from stdin. |
--body-file <path> |
the request body from a JSON file; - is stdin. |
Delete comment — destructive (DELETE /messages/{messageId}/comments)
Меняет что-то в MAX.
max bot api delete-comment [options]| Опция | Что делает |
|---|---|
--message-id <value> |
Message identifier (mid) of the commented message. |
--comment-id <value> |
Deleting comment identifier. |
--allow-dangerous |
skip confirmation for bot.messages.delete at level ask. |
Get comment — read (GET /messages/{messageId}/comments/{commentId})
max bot api get-comment-by-id [options]| Опция | Что делает |
|---|---|
--message-id <value> |
Message identifier (mid) of the commented message. |
--comment-id <value> |
Comment identifier (mid) to get single comment in channel. |
Get video details — read (GET /videos/{videoToken})
max bot api get-video-attachment-details [options]| Опция | Что делает |
|---|---|
--video-token <value> |
Video attachment token. |
Answer on callback — write (POST /answers)
Меняет что-то в MAX.
max bot api answer-on-callback [options]| Опция | Что делает |
|---|---|
--callback-id <value> |
Identifies a button clicked by user. Bot receives this identifier after user pressed button as part of MessageCallbackUpdate. |
--disable-link-preview <value> |
If true, server will not generate media preview for links in updated message text. |
--body <json> |
the request body as JSON; - reads it from stdin. |
--body-file <path> |
the request body from a JSON file; - is stdin. |
Get updates — write (GET /updates)
Меняет что-то в MAX.
max bot api get-updates [options]| Опция | Что делает |
|---|---|
--limit <value> |
Maximum number of updates to be retrieved. |
--poll-timeout <value> |
Timeout in seconds for long polling. |
--marker <value> |
Pass null to get updates you didn't get yet. |
--types <value> |
Comma separated list of update types your bot want to receive. |
Скрипт ветвится по коду, а не по тексту: текст меняется, код — нет.
| Код | Когда |
|---|---|
0 |
получилось |
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 |
всё остальное |
0 и только 0 означает, что операция выполнена. 14 — outcome_unknown — означает, что
сообщение могло уйти: не отправлено и не провалено, и повторять его можно только с тем же
--send-id.