skills/telecrawl/SKILL.md
Telegram archive: chats, messages, contacts, folders, search; import from Telegram Desktop/macOS.
npx skillsauth add steipete/agent-scripts telecrawlInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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
tools
npm registry ops: login, whoami, names, publish; 1Password tmux.
development
Mac fleet inventory and upkeep with full/worker profiles: collect installed apps and packages, compare desired versus observed state, audit local-account escrow references, update Homebrew/global packages, safely sync repos and Xcode, and report disk, service, backup, update, and security health.
tools
Claude Code work routing: delegate implementation, fixing, exploratory subagents, rebasing, and PR merging/landing to Codex CLI while the parent specifies, decides, reviews, and verifies. Load a private codex-next policy first when available; otherwise use the native-Claude model gate. Codex-backed autoreview is always allowed and preferred.
tools
macOS screen capture, accessibility inspection, and background-first app/window/UI automation with Peekaboo v4.