{"id":37679100,"url":"https://github.com/lycfyi/community-agent-plugin","last_synced_at":"2026-01-22T04:01:07.773Z","repository":{"id":332614221,"uuid":"1127407465","full_name":"lycfyi/community-agent-plugin","owner":"lycfyi","description":"Community agent plugins for Claude Code - sync and analyze Discord \u0026 Telegram messages","archived":false,"fork":false,"pushed_at":"2026-01-14T17:15:16.000Z","size":5659,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-16T22:50:17.095Z","etag":null,"topics":["claude-ai","claude-code","claude-code-plugin","community-agent","discord","telegram"],"latest_commit_sha":null,"homepage":"https://discordhunt.com/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lycfyi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-03T20:26:00.000Z","updated_at":"2026-01-14T17:14:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"a0d878a8-78f2-427e-b80d-7e241f2dacac","html_url":"https://github.com/lycfyi/community-agent-plugin","commit_stats":null,"previous_names":["lycfyi/community-agent-plugin"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/lycfyi/community-agent-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lycfyi%2Fcommunity-agent-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lycfyi%2Fcommunity-agent-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lycfyi%2Fcommunity-agent-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lycfyi%2Fcommunity-agent-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lycfyi","download_url":"https://codeload.github.com/lycfyi/community-agent-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lycfyi%2Fcommunity-agent-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28653620,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-22T01:17:37.254Z","status":"online","status_checked_at":"2026-01-22T02:00:07.137Z","response_time":144,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-ai","claude-code","claude-code-plugin","community-agent","discord","telegram"],"created_at":"2026-01-16T12:21:48.859Z","updated_at":"2026-01-22T04:01:07.768Z","avatar_url":"https://github.com/lycfyi.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Community Agent Plugin Marketplace\n\nA Claude Code plugin marketplace for community management tools. Sync and analyze Discord \u0026 Telegram messages directly from Claude Code.\n\n## What You Can Do\n\nTalk to Claude in natural language to manage your community:\n\n**Track Growth \u0026 New Members**\n```\n\"How many members joined this week?\"\n\"Show me the growth stats for the last month\"\n```\n\n**Find Silent Members \u0026 Lurkers**\n```\n\"List lurkers who joined over 30 days ago but never posted\"\n\"Show me the engagement breakdown\"\n```\n\n**Smart Member Search**\n```\n\"Find members interested in AI\"\n\"Search for developers with moderator role\"\n\"Find active members who joined last month\"\n```\n\n**Track Churn**\n```\n\"Who left the server recently?\"\n\"Which departing members were actually active?\"\n```\n\n**Analyze \u0026 Export**\n```\n\"Which members are most active?\"\n\"Export member list as CSV\"\n\"Analyze community health\"\n```\n\n## Quick Start\n\n### 1. Install the Plugin\n\n```bash\n/plugin marketplace add https://github.com/lycfyi/community-agent-plugin\n```\n\nThen select the plugin(s) you want to install from the marketplace.\n\n### 2. Set Up Your First Connector\n\n**For Discord:**\n```\n\"Set up Discord sync for my account\"\n```\n\n**For Telegram:**\n```\n\"Set up Telegram sync for my account\"\n```\n\n### 3. Start Using\n\n```\n\"Sync my Discord messages\"\n\"Summarize what's happening in my community\"\n\"Analyze community health\"\n```\n\n## Prerequisites\n\n- Claude Code CLI\n- Python 3.11+\n- Discord account (for discord-user-connector)\n- Telegram account (for telegram-connector)\n\n## Demo\n\n**Summarize discussion topics from a Discord server:**\n\n![Summarize Topics](assets/demo1.png)\n\n**Find the most active community members:**\n\n![Active Members](assets/demo2.png)\n\n## Architecture\n\n```\n┌─────────────────────────────────────────────────────────┐\n│                   community-agent                        │\n│                   (THE BRAIN)                            │\n│                                                          │\n│  Orchestrating agent that coordinates cross-platform     │\n│  workflows using platform connectors as \"hands\"          │\n└─────────────────────────────────────────────────────────┘\n        │                    │                    │\n        ▼                    ▼                    ▼\n┌──────────────┐    ┌──────────────┐    ┌──────────────┐\n│discord-user  │    │ discord-bot  │    │  telegram    │\n│ -connector   │    │ -connector   │    │ -connector   │\n│              │    │              │    │              │\n│ Messages     │    │ Fast member  │    │ Messages     │\n│ DMs, Profiles│    │ sync (100k+) │    │ Groups       │\n└──────────────┘    └──────────────┘    └──────────────┘\n```\n\n## Available Plugins\n\n| Plugin | Description |\n|--------|-------------|\n| `community-agent` | Orchestrating agent + shared library. Coordinates cross-platform workflows. |\n| `discord-user-connector` | Sync messages, read DMs, get rich profiles (user token) |\n| `discord-bot-connector` | Fast member sync for large servers - 100k+ members (bot token) |\n| `telegram-connector` | Sync, read, and analyze Telegram messages |\n\n---\n\n## community-agent\n\nThe brain of the system. Provides:\n\n- **community-manager agent** - Coordinates cross-platform workflows\n- **community-patterns skill** - Domain knowledge for community management\n- **Shared utilities** - Config, storage, formatting used by all connectors\n\n**Example conversations:**\n- \"Sync all my communities\" (coordinates Discord + Telegram)\n- \"Summarize activity across all platforms\"\n- \"Send announcement to all my communities\"\n\n---\n\n## discord-user-connector\n\nSync, read, and analyze Discord messages directly from Claude Code.\n\n| Skill                  | Purpose                                            |\n| ---------------------- | -------------------------------------------------- |\n| `discord-init`         | Initialize configuration from your Discord account |\n| `discord-list`         | List accessible servers and channels               |\n| `discord-sync`         | Sync messages to local Markdown storage            |\n| `discord-read`         | Read and search synced messages                    |\n| `discord-send`         | Send messages to Discord channels                  |\n| `discord-members`      | Query members, track churn, get rich profiles      |\n| `discord-chat-summary` | AI-powered summary of Discord conversations        |\n| `discord-analyze`      | Generate community health reports with metrics     |\n| `discord-doctor`       | Diagnose configuration issues                      |\n\n**Example conversations:**\n\n- \"Set up Discord sync for my account\"\n- \"Show me all the servers I have access to\"\n- \"Sync the last 7 days of messages from all servers\"\n- \"Summarize what's been happening in XXX Server\"\n- \"Search for messages mentioning 'bug report'\"\n- \"Analyze community health for my Discord server\"\n- \"Draft a self-intro for me and send it to proper discord server and channels\"\n\n**Getting your Discord token:**\n\n[How to get your Discord user token (guide)](https://discordhunt.com/articles/how-to-get-discord-user-token)\n\n\u003e **Warning:** Using a user token may violate Discord's Terms of Service. This tool is intended for personal archival and analysis only. Use at your own risk.\n\n---\n\n## discord-bot-connector\n\nFast member syncing for large Discord servers using bot tokens. Can fetch complete member lists from servers with 100k+ members.\n\n| Skill                  | Purpose                                            |\n| ---------------------- | -------------------------------------------------- |\n| `discord-bot-members`  | Sync complete member list via Gateway API          |\n| `discord-sync`         | Sync messages (shares data with user-connector)    |\n\n**When to use bot-connector vs user-connector:**\n\n| Feature | Bot Connector | User Connector |\n|---------|---------------|----------------|\n| Member Sync | Fast, complete list | Cached only |\n| Message Sync | Yes | Yes |\n| DM Access | No | Yes |\n| Rich Profiles (bio, pronouns) | No | Yes |\n| ToS Compliant | Yes | Gray area |\n\n**Setup:** Create a bot at [Discord Developer Portal](https://discord.com/developers/applications), enable SERVER MEMBERS INTENT, and add to `.env`:\n```\nDISCORD_BOT_TOKEN=your_bot_token\n```\n\n---\n\n## telegram-connector\n\nSync, read, and analyze Telegram messages directly from Claude Code.\n\n| Skill            | Purpose                                      |\n| ---------------- | -------------------------------------------- |\n| `telegram-init`  | Initialize Telegram connection and config    |\n| `telegram-list`  | List accessible groups and forum topics      |\n| `telegram-sync`  | Sync messages to local Markdown storage      |\n| `telegram-read`  | Read and search synced messages              |\n| `telegram-send`  | Send messages to Telegram groups             |\n| `telegram-doctor`| Diagnose configuration issues                |\n\n**Example conversations:**\n\n- \"Set up Telegram sync for my account\"\n- \"List all my Telegram groups\"\n- \"Sync the last 7 days of messages from my group\"\n- \"Search Telegram messages for 'meeting'\"\n- \"Send a message to my Telegram group\"\n\n**Getting your Telegram credentials:**\n\n1. Get API credentials from https://my.telegram.org/apps\n2. Generate a session string (see important note below)\n3. Add to `.env`:\n   ```\n   TELEGRAM_API_ID=your_api_id\n   TELEGRAM_API_HASH=your_api_hash\n   TELEGRAM_SESSION=your_session_string\n   ```\n\n**⚠️ Important: Run session generation directly in your terminal**\n\nTelegram verification codes expire in ~2-5 minutes. You **must** run the session generation script directly in your terminal (not through Claude Code chat) to enter the code immediately when you receive it:\n\n```bash\n# Run this directly in your terminal\npython plugins/telegram-connector/scripts/generate_session.py\n\n# Enter your phone number when prompted\n# Enter the verification code IMMEDIATELY when you receive it via SMS/Telegram\n```\n\nWhy? The Claude Code chat workflow adds latency (typing the code → Claude processing → script execution), which often causes the code to expire before it reaches Telegram's API. Running directly in terminal allows immediate input.\n\n**For users in regions where Telegram is blocked:** Ensure your VPN connection is stable before starting, as network latency can contribute to code expiration.\n\n\u003e **Warning:** Using a user token may violate Telegram's Terms of Service. This tool is intended for personal archival and analysis only. Use at your own risk.\n\n---\n\n## Directory Structure\n\nAfter running any connector, your working directory will have:\n\n```\nyour-project/\n├── .env                           # Your credentials\n├── config/\n│   └── agents.yaml                # Unified config for all platforms\n└── data/                          # Synced messages\n    ├── manifest.yaml              # Index of all synced data\n    ├── {server_id}-{slug}/        # Discord servers\n    │   ├── server.yaml\n    │   ├── sync_state.yaml\n    │   ├── health-report.md       # Health analysis (if generated)\n    │   └── {channel}/\n    │       └── messages.md\n    └── {group_id}-{slug}/         # Telegram groups\n        ├── group.yaml\n        ├── sync_state.yaml\n        └── messages.md\n```\n\n## Plugin Structure\n\n```\nplugins/\n├── community-agent/         # THE BRAIN\n│   ├── agents/\n│   │   └── community-manager.md    # Orchestrating agent\n│   ├── skills/\n│   │   └── community-patterns/     # Domain knowledge\n│   └── lib/                        # Shared utilities\n│\n├── discord-user-connector/  # HANDS (Discord user token)\n│   ├── skills/              # Messages, DMs, profiles\n│   ├── tools/\n│   └── lib/\n│\n├── discord-bot-connector/   # HANDS (Discord bot token)\n│   ├── skills/              # Fast member sync\n│   ├── tools/\n│   └── lib/\n│\n└── telegram-connector/      # HANDS (Telegram)\n    ├── skills/\n    ├── tools/\n    └── lib/\n```\n\n## License\n\nAGPL-3.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flycfyi%2Fcommunity-agent-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flycfyi%2Fcommunity-agent-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flycfyi%2Fcommunity-agent-plugin/lists"}