# firetg

> Agent-ready Telegram MTProto CLI with predictable JSON output.

Use these docs to authenticate, resolve Telegram peers, read and search messages, send text or files, and handle errors safely.

## Table of Contents

### Start here

- [Getting started](/guide/getting-started.md): Install firetg, authenticate a Telegram account, and run the first read and send commands.
- [Authentication](/guide/authentication.md): Log in by QR or phone, manage local session files, migrate legacy sessions, and log out safely.
- [Peers and IDs](/guide/peers.md): Address Telegram users, groups, channels, and Saved Messages using usernames, IDs, or aliases.
- [Use with agents](/guide/agent-usage.md): Integrate firetg into an agent harness with safe permissions, JSON parsing, retries, and secret handling.

### Command reference

- [Command reference](/commands.md): Browse every firetg command group, global behavior, and compatibility alias.
- [Diagnostics](/commands/diagnostics.md): Check firetg readiness, local security, and live Telegram connectivity.
- [auth](/commands/auth.md): Create, revoke, and remove the local Telegram authentication session.
- [profiles](/commands/profiles.md): Read the current Telegram account or retrieve one user profile.
- [channels](/commands/channels.md): Inspect Telegram broadcast-channel metadata, message history, and pinned messages.
- [messages](/commands/messages.md): Send text or files, schedule delivery, read history, search streams, and list pinned messages.
- [dialogs and folders](/commands/dialogs-folders.md): List Telegram chats and scope dialog results by archive or custom folder.

### Reference

- [Output](/reference/output.md): Parse firetg success values, error envelopes, and every JSON result type.
- [Configuration](/reference/configuration.md): Configure credentials, session paths, XDG storage, file permissions, and account isolation.
- [Errors and exit codes](/reference/errors.md): Handle firetg error codes, process exit codes, Telegram flood waits, and safe retries.