Command reference

firetg groups commands by Telegram capability. Run any group without a subcommand to see its local help.

sh

firetg --help
firetg messages
firetg messages send --help

Command map

Group	Commands	Purpose
Diagnostics	`status`, `doctor`	Inspect readiness and verify Telegram connectivity
`auth`	`login`, `logout`	Create and remove the local Telegram session
`profiles`	`me`, `get`	Read account and user profiles
`channels`	`view`, `messages`, `pinned`	Inspect broadcast channels
`messages`	`send`, `list`, `search`, `pinned`	Send and read message streams
`dialogs`	`list`	List chats, optionally by folder
`folders`	`list`	Discover dialog filters and archive scope

Global behavior

All successful command results are JSON written to stdout.
Structured failures are also JSON written to stdout.
Prompts and output-file confirmations are written to stderr.
--help is available at the root, group, and command level.
--json explicitly requests the default JSON contract.
--pretty formats JSON with indentation.
--output <path> writes output to a mode-0600 file and leaves stdout empty.
--no-input rejects commands that require prompts.
--timeout <seconds> bounds command execution and accepts positive decimals.
Positive integer options reject zero, negative values, and non-integers.

Legacy aliases

Canonical scoped commands are recommended. These compatibility aliases are also accepted:

Alias	Canonical command
`firetg me`	`firetg profiles me`
`firetg send ...`	`firetg messages send ...`
`firetg messages:list ...`	`firetg messages list ...`
`firetg messages:search ...`	`firetg messages search ...`
`firetg messages:pinned ...`	`firetg messages pinned ...`
`firetg dialogs:list ...`	`firetg dialogs list ...`
`firetg folders:list`	`firetg folders list`