Menu
Telegram archive: chats, messages, contacts, folders, search; import from Telegram Desktop/macOS.
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/steipete/agent-scripts --skill telecrawlThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Showing SKILL.md
Based on SOC occupation classification
| name | telecrawl |
| description | Telegram archive: chats, messages, contacts, folders, search; import from Telegram Desktop/macOS. |
Use this for Telegram history questions. Local archive first; the Telegram apps only for live/current state.
~/.telecrawl/telecrawl.dbtdata or native macOS Telegram Postbox (auto-detected)telecrawlclawmac (~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:ssh -o RequestTTY=no -o RemoteCommand=none steipete@clawmac 'zsh -lc "telecrawl --json status"'
telecrawl --json status
Empty counts mean no import has run on this machine, not "no Telegram data".
All read commands take --json.
telecrawl --json chats --limit 20
telecrawl --json chats --unread
telecrawl --json messages --chat <ID> --limit 50 --after 2026-01-01
telecrawl --json search "query" [--chat ID]
telecrawl --json contacts --limit 50
telecrawl --json folders
telecrawl --json topics --chat <ID>
telecrawl doctor # verify a Telegram data source is readable
telecrawl import # merge-import from detected local Telegram app
telecrawl import --fetch-media # also pull Telegram cloud media
Imports merge by default; --restore replaces the archive — treat as destructive and confirm first.
Encrypted age shards to a git repo:
telecrawl backup status
telecrawl backup push