claude-channel-plugins

claude-channel-plugins

This repo contains two complementary tools: the channel-setup plugin (Claude Code skills) and the claude-channel-wizard CLI (npx setup wizard). They share configuration and are designed to be used together.

Marketplace for Claude Code channel plugins — setup wizards, access management, and verification tools for Discord (Telegram coming soon).

Quick Start: Setup Wizard CLI

The fastest way to configure multiple Discord bots at once:

npx claude-channel-wizard

Or batch import from a JSON file:

npx claude-channel-wizard --import bots.json

Or pick and launch a configured bot without memorizing commands:

npx claude-channel-wizard start

Or directly add a user who can command a bot (without re-running the full wizard):

npx claude-channel-wizard add-user 123456789
npx claude-channel-wizard add-user 123456789 --profile discord-mybot --groups

See channel-wizard/README.md for full documentation.

---

Plugin Install

# Add the marketplace
claude plugin marketplace add girofu/claude-channel-plugins

# Install the plugin
claude plugin install channel-setup@claude-channel-plugins

For local development:

git clone https://github.com/girofu/claude-channel-plugins.git
claude plugin marketplace add ./claude-channel-plugins
claude plugin install channel-setup@claude-channel-plugins

Skills

Command	Description
/channel-setup:setup	Interactive wizard — token validation, server/channel selection, access control, tool permissions
/channel-setup:verify	Verify config — token, bot presence, access.json format, permissions
/channel-setup:status	Show current config — DM policy, groups, allowed users
/channel-setup:access	Profile-aware access management — pair, allow, deny, policy
/channel-setup:reset	Reset config with automatic backup

Example: Set Up Discord

> /channel-setup:setup

Phase 1: Environment Detection
  ✅ Bun runtime detected

Phase 2: Token Setup
  Paste your Discord Bot Token: ********
  ✅ Token verified (bot: MyClaude#1234)

Phase 3: Invite & Server/Channel Setup
  🔗 Invite URL: https://discord.com/oauth2/authorize?...
  Select server: My Dev Server
  Select channels: #claude-dev, #claude-ops
  Require @mention? Yes

Phase 4: Tool Permissions
  ✅ Added mcp__plugin_discord_discord__* to settings.json

Phase 5: Complete!
  Launch: claude --channels plugin:discord@claude-plugins-official

Example: Pair a User (Cross-Profile)

> /channel-setup:access pair 80ff6a

Scanning all profiles...
  ✅ Found code 80ff6a in profile discord-frontend
  ✅ Approved sender 890824536533131274

Scans ALL profiles automatically — no need to know which profile received the pairing request.

Multi-Bot Profiles

Map different Discord channels to different Claude Code sessions:

~/.claude/channels/
├── discord/              # Default profile
├── discord-frontend/     # Bot A
└── discord-backend/      # Bot B

Launch each session separately:

DISCORD_STATE_DIR=~/.claude/channels/discord-frontend \
  claude --channels plugin:discord@claude-plugins-official

DISCORD_STATE_DIR=~/.claude/channels/discord-backend \
  claude --channels plugin:discord@claude-plugins-official

Or use the generated start-all.sh to open each bot in its own Terminal window:

bash ~/.claude/channels/scripts/start-all.sh

Discord Permissions

The invite URL includes exactly these permissions:

Permission	Value
View Channels	1024
Send Messages	2048
Send Messages in Threads	274877906944
Read Message History	65536
Attach Files	32768
Add Reactions	64
Total	274878008384

Structure

├── .claude-plugin/
│   └── marketplace.json         # Marketplace registry
├── channel-wizard/              # Batch setup CLI (npx claude-channel-wizard)
│   ├── src/                     # TypeScript source
│   ├── tests/                   # Test suite
│   └── package.json
└── plugins/
    └── channel-setup/
        ├── .claude-plugin/
        │   └── plugin.json      # Plugin manifest
        └── skills/
            ├── setup/SKILL.md   # Interactive setup wizard
            ├── verify/SKILL.md  # Config verification
            ├── status/SKILL.md  # Status display
            ├── access/SKILL.md  # Profile-aware access management
            └── reset/SKILL.md   # Reset with backup

Related

• Claude Code Channels Documentation
• Claude Code Channels Reference
• Official Channel Plugins

License

MIT