Agent skill · writing content · steipete

telecrawl

Telegram archive: chats, messages, contacts, folders, search; import from Telegram Desktop/macOS.

Why this skill is useful

Provides specific commands and workflows for managing Telegram data that the AI wouldn't reliably generate on its own.

What it needs

Requires telecrawl installed locally. About 1k tokens when loaded. Last updated 2026-08-06. 6,510 stars on the source repository.

What this skill does

Telecrawl Use this for Telegram history questions. Local archive first; the Telegram apps only for live/current state. Sources DB: ~/.telecrawl/telecrawl.db Import source: Telegram Desktop tdata or native macOS Telegram Postbox (auto-detected) CLI: telecrawl Archive host: the populated archive currently lives on clawmac (~200 chats). Local DBs on other Macs may be empty — check status first and prefer SSH to the archive host over answering from an empty DB: Freshness Empty counts mean no import has run on this machine, not "no Telegram data". Queries All read commands take --json. Import / Refresh Imports merge by default; --restore replaces the archive — treat as destructive and confirm first. Backup Encrypted age shards to a git repo:

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills steipete/telecrawl

View the source on GitHub

Browse the @skills marketplace