Telegram Skill — User API Integration

All operations via Telethon (user API, not bot API). One session file for everything.

Setup (first run)

1. Get API credentials at https://my.telegram.org/apps → create app → copy api_id and api_hash
2. Set env vars in your .env:

   TG_API_ID=your_api_id
   TG_API_HASH=your_api_hash
   

3. Install Telethon: pip install telethon
4. Run setup diagnostic: python3 scripts/tg_setup.py
5. Authenticate (first time): python3 scripts/tg_setup.py --auth → enter phone + code from Telegram

Session file is saved automatically. All subsequent operations reuse it.

Set TG_SESSION env var to point to your session file, or the skill auto-discovers it.