tg-ingest
Primary Telegram interface. Full-featured CLI for message export, DM management, group sync, contact scoring, and thread state. Use when user mentions "telegram", "tg", "@username", or telegram-specific terms. Triggers: "telegram messages", "export telegram", "telegram DMs", "telegram groups", "sync telegram", "@username messages", "telegram contacts". This is STANDALONE - do not defer to unified-messages for telegram operations.
Installation
Details
Usage
After installing, this skill will be available to your AI coding assistant.
Verify installation:
skills listSkill Instructions
name: tg-ingest description: > Primary Telegram interface. Full-featured CLI for message export, DM management, group sync, contact scoring, and thread state. Use when user mentions "telegram", "tg", "@username", or telegram-specific terms. Triggers: "telegram messages", "export telegram", "telegram DMs", "telegram groups", "sync telegram", "@username messages", "telegram contacts". This is STANDALONE - do not defer to unified-messages for telegram operations.
Telegram Export (tg-ingest)
Primary interface for all Telegram operations. Standalone and full-featured.
Location: /Users/satoshi/data/tg-ingest
Quick Start
cd /Users/satoshi/data/tg-ingest
# Check status
poetry run tg_export status
# Sync all DMs + whitelisted groups
poetry run tg_export sync-all
# Export specific DM
poetry run tg_export dump-dm --user vibhu --out exports/vibhu.jsonl
# List DMs
poetry run tg_export list-dms
Core Workflows
Quick Export for AI Context (Recommended)
Get recent messages as markdown, ready to paste into Claude:
# Syncs first, outputs to stdout (last 24h)
python scripts/quick_export.py klutch
# Custom time range
python scripts/quick_export.py klutch --hours 48
# Copy to clipboard
python scripts/quick_export.py klutch | pbcopy
# Visual copy in browser
python scripts/quick_export.py klutch | quick-view
# Intentional save
python scripts/quick_export.py klutch --save
# → exports/klutch_2026-01-02.md
See references/files.md for file management philosophy.
Export via CLI (Alternative)
# By username (pulls from API, may have caching issues)
poetry run tg_export dump-dm --user vibhu --out vibhu.jsonl
# Last 7 days only
poetry run tg_export dump-dm --user vibhu --last 7d --out vibhu.jsonl
Note: Prefer quick_export.py for reading synced data. Use dump-dm only for initial exports.
Sync Operations
# One-shot sync (DMs + whitelisted groups)
poetry run tg_export sync-all
# Backfill older messages
poetry run tg_export sync-all --backfill
# Live continuous sync
poetry run tg_export live --interval 5m
# Sync DMs only
poetry run tg_export sync-dms --dir data/dms
Manage Thread State
Thread states are stored in data/decisions.jsonl.
# Via CLI (if implemented) or direct file edit
# States: pending, done, archived
# Also supports: draft, snooze, note
See references/state.md for state management details.
Manage Groups
# List registered groups
poetry run tg_export groups list
# Add a group to sync
poetry run tg_export groups add "crypto trenches" --type trading
# Sync groups
poetry run tg_export groups sync
# Backfill group history
poetry run tg_export groups backfill crypto_trenches --limit 1000
See references/groups.md for registry management.
Contact Lookup & Scoring
# Initialize contacts from DMs
poetry run tg_export contacts-init --dm-dir data/dms
# List contacts by priority
poetry run tg_export contacts-list --tier high
# Score all contacts
poetry run tg_export contacts-score
# Show contact details
poetry run tg_export contacts-show vibhu
See references/contacts.md for scoring algorithm.
Data Locations
| Path | Purpose |
|---|---|
data/dms/ | DM exports (*.jsonl + *.jsonl.idx) |
data/groups/ | Group exports |
data/registry.json | Group registry |
data/decisions.jsonl | Thread states |
data/session.session | Telethon auth |
contacts/ | Contact database |
Authentication
First-time setup:
# Set env vars (in .env or shell)
export TG_API_ID=your_id
export TG_API_HASH=your_hash
# Login (interactive)
poetry run tg_export login
Session persists in data/session.session.
Thread ID Format
Telegram threads use format: tg:dm:username or tg:group:slug
Examples:
tg:dm:vibhu- DM with @vibhutg:group:crypto_trenches- Group chat
More by rohunvora
View allAnalyze bank transaction CSVs to find recurring charges, categorize subscriptions, and cancel what you don't need. Use when user says "cancel subscriptions", "audit subscriptions", "find recurring charges", or "what am I paying for". Supports Apple Card, Chase, Mint, and generic CSV formats. Outputs interactive HTML audit with copy-to-cancel workflow.
Designs optimal filtering UX for data tables. Use when building a table that needs filters - analyzes the data columns and determines the best filter type for each. Outputs a unified filter field with inline header filters.
Granular feedback on drafts without rewriting. Generates highlighted HTML with click-to-reveal inline comments. Use when user says "comment on this", "leave comments on", "give feedback on", or asks for feedback on a draft. Supports multiple lenses—editor feedback, POV simulation ("as brian would react"), or focused angles ("word choice only", "weak arguments"). A granular alternative to rewrites that lets users review feedback incrementally without losing their voice.
Generate minimal HTML pages to review Claude Code output in a browser. Use when terminal output is hard to read, when reviewing lists/tables/drafts, or when user says "show me", "make this reviewable", "quick view", or "open as webpage". Produces unstyled semantic HTML only. For granular feedback with inline comments, see the comment-mode skill.