Commands

Auth

Command	Notes
auth login	QR login with optional --qr-file PNG output.
auth status	Show session status.
auth logout	Clear session for the profile.
auth config set	Persist API ID/hash and defaults.
auth config show	Display current config.

Chats

Command	Notes
chat list	List recent dialogs.
chat history <chat_id>	Read history from a chat.
chat watch [peer]	Stream live updates, optionally filtered to one peer.
chat info <peer>	Show resolved chat metadata.
chat pin <peer> <message-id>	Pin a message.
chat unpin <peer> <message-id>	Unpin a message.

Messaging

Command	Notes
message send <peer> <text>	Send a text message.
message send <peer> --file <path> [--caption "text"]	Upload media or document (auto-detected).
message send <peer> --file <path> --voice	Send a voice note (audio/ogg opus recommended).
message send <peer> ... --schedule <when>	Schedule a message (RFC3339 or unix seconds).
message reply <peer> <reply-to-id> [text]	Reply to a specific message.
message edit <peer> <message-id> <text>	Edit an existing message.
message delete <peer> <message-id>...	Delete one or more messages.
message forward <from-peer> <message-id>... --to <peer>	Forward messages to another peer.
message react <peer> <message-id> [reaction...]	Add or remove reactions.
message info <peer> <message-id>	Inspect a single message.

Contacts

Command	Notes
contact list	List synced contacts.
contact info <peer>	Show contact details for a user.
contact search <query>	Search contacts by display name or username. Partial match, case-insensitive.

Files

Command	Notes
file download <peer> <message-id>	Download a file or photo from a message.
file info <peer> <message-id>	Inspect downloadable media metadata.

Search

Command	Notes
search messages <query>	Global or per-chat search.

Output

Use --output table|plain|json|ndjson. --json and --plain remain shorthand flags. Use --describe for command schema, or tmgc schema [command] for the same contract in a stable machine-readable form.