Pin/Unpin Telegram Messages
Pin or unpin messages in chats, groups, and channels.
Self-Evolving Skill: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.
Preflight
- Session must exist:
~/.local/share/gramjs/<profile>.session- If missing, run
/tlg:setupfirst
- If missing, run
Usage
/usr/bin/env bash << 'EOF'
ROOT="$(cc-plugin-root tlg)"
SCRIPT="$ROOT/scripts/tg-cli.ts"
# Pin a message (with notification)
bun "$SCRIPT" pin <chat> <message_id>
# Pin silently (no notification)
bun "$SCRIPT" pin <chat> <message_id> --silent
# Unpin a specific message
bun "$SCRIPT" pin <chat> <message_id> --unpin
# Unpin all messages
bun "$SCRIPT" pin <chat> --unpin
EOF
Parameters
| Parameter | Type | Description |
|---|---|---|
| chat | string/int | Chat/group/channel |
| message_id | int | Message to pin (omit with --unpin to unpin all) |
--unpin | flag | Unpin instead of pin |
--silent | flag | Pin without sending notification |
Post-Execution Reflection
After this skill completes, check before closing:
- Did the command succeed? — If not, fix the instruction or error table that caused the failure.
- Did parameters or output change? — If tg-cli.ts's interface drifted, update Usage examples and Parameters table to match.
- Was a workaround needed? — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.
Only update if the issue is real and reproducible — not speculative.