Tg Content Factory

TG Agent

Telegram automation for coding agents — Claude Code, OpenCode, Codex. Ships as a Claude Code plugin (skill + CLI): install the plugin and your agent can act on Telegram for you — read and send messages, manage channels and chats, download media, run LLM content pipelines. The content factory (collect → search → generate → publish) is one module among many.

Русская версия

How it works

- Skill + Claude Code plugin — this repo ships a skill (installed from the plugin marketplace, or copied manually) that teaches your agent the command catalog, the runtime model and safety rules. The skill drives the CLI — no MCP tool surface eating your context window.
- tg-agent CLI — the product surface: ~250 commands covering the full Telegram spectrum (channel, dialogs, messages, search, pipeline, photo-loader, analytics, scheduler, account, …). Every command is a self-contained one-shot: it opens a Telegram connection, does the work, exits. No daemon required.
- tg-agent worker — optional long-lived process for scheduled collection and queued sends.

Quick Start (coding agents)

Prerequisites

- Python 3.11+
- Telegram API credentials from my.telegram.org/apps

1. Install the plugin (Claude Code) — or the skill alone
The short form (axisrow/tg_content_factory) clones over SSH — without GitHub SSH keys it
fails; use the full HTTPS URL as above. If the marketplace is not visible right after
marketplace add, run /reload-plugins before plugin install.

OpenCode / Codex / other agents — skip the plugin: point the agent at skills/tg-agent/SKILL.md as an instruction file (AGENTS.md include, system-prompt attachment, etc.), or copy the skill folder:

2. Install the CLI

The skill drives the tg-agent CLI, which must be on the machine where your agent runs:

Create .env in your…