Skip to content

Add tgcli skill — Telegram CLI for personal accounts#50

Merged
TechNickAI merged 3 commits intomainfrom
skill/tgcli
Mar 29, 2026
Merged

Add tgcli skill — Telegram CLI for personal accounts#50
TechNickAI merged 3 commits intomainfrom
skill/tgcli

Conversation

@TechNickAI
Copy link
Copy Markdown
Owner

What

Adds a new skill for tgcli, a CLI for reading, searching, and sending Telegram messages from your personal account via MTProto 2.0. The Telegram equivalent of wacli.

Why

Enables AI assistants to monitor and search Telegram message history the same way wacli enables WhatsApp monitoring — reading DMs, searching across chats, checking what was discussed, and sending messages as the user (not as a bot).

What's included

  • SKILL.md with full CLI reference, safety rules, setup instructions
  • Follows existing skill patterns (wacli, quo, limitless)
  • Generic/open-source friendly — no personal data or hardcoded credentials
  • Documents peer ID workflow (display names don't resolve as identifiers)

Tested

  • tgcli chat ls
  • tgcli msg ls <peer_id>
  • tgcli msg search ✅ (FTS5 local search)
  • tgcli sync ✅ (525 messages across 100 chats)

Telegram equivalent of wacli. Read, search, and send messages from
your personal Telegram account via MTProto 2.0.

- Full CLI reference (chat ls, msg ls/search/context, send, sync, export)
- SQLite FTS5 local search index
- Safety rules for sending
- Peer ID workflow documented (display names don't resolve)
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: fa964c220d

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".


### Prerequisites

1. Go 1.21+ with CGO enabled
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Raise tgcli prerequisite to supported Go version

The setup section advertises Go 1.21+, but upstream tgcli currently declares a much newer Go toolchain in its go.mod (and documents newer build requirements), so users on 1.21–1.24 will hit go install failures and treat the skill as broken. Please update the prerequisite to the real minimum supported Go version so installation guidance matches actual behavior.

Useful? React with 👍 / 👎.

@@ -0,0 +1,211 @@
---
name: tgcli
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Bump root VERSION when introducing this skill

/workspace/openclaw-config/AGENTS.md requires bumping the repo VERSION on changes, but this commit adds a new skill without a corresponding version increment. That breaks update detection flows that compare installed version state against repo VERSION, so existing OpenClaw instances may never discover and sync tgcli.

Useful? React with 👍 / 👎.

Comment on lines +2 to +3
name: tgcli
version: 0.1.0
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Sync README skill metadata with tgcli addition

/workspace/openclaw-config/AGENTS.md also requires updating README badges/counts/tables whenever skills are added or versioned. Adding tgcli without updating README leaves the advertised skill inventory stale (e.g., count and skill table), which causes user-facing documentation and release summaries to be inaccurate.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Nick Sullivan and others added 2 commits March 29, 2026 16:16
- Bump VERSION 0.18.0 → 0.19.0 for new skill addition
- Update README version badge (0.17.0 → 0.19.0), skill count (14 → 15), add tgcli to table
- Bump Go prerequisite from 1.21+ to 1.23+ to match upstream requirements
- Add credential exfiltration guardrail to Safety section

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Cursor Bugbot caught "Ali Katz" (a fleet member) used as an example
display name in a file intended to be open-source friendly.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@TechNickAI TechNickAI merged commit d8b3e1e into main Mar 29, 2026
6 checks passed
@TechNickAI TechNickAI deleted the skill/tgcli branch March 29, 2026 21:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant