firetgTelegram CLI for scripts and agents

Read, search, and send through MTProto with predictable JSON output.

Agent-ready JSON

Successful results and structured errors are written as JSON for reliable tool use.

Use with agents

Read history, search streams, send files, and schedule Telegram-native delivery.

Message commands

Authentication

Discover related operations through consistent auth, profiles, channels, messages, dialogs, and folders groups.

Browse commands

Address usernames, known IDs, channels, groups, or Saved Messages with one peer model.

Peer formats

Pipe results directly into jq, Bun, or any runtime that can parse standard JSON.

Output reference