discord-channel-cli

Interactive CLI for Discord channel permission and member management. Replace tedious web UI navigation with fast, keyboard-driven permission control.

Installation

npm install -g discord-channel-cli

Or run directly with npx:

npx discord-channel-cli

Quick Start

1. Create a Discord bot at the Discord Developer Portal
2. Enable the Server Members Intent under Bot settings
3. Invite the bot to your server with Manage Roles and Manage Channels permissions
4. Create a .env file in your working directory:

DISCORD_TOKEN=your_bot_token_here
DISCORD_GUILD_ID=your_server_id_here

5. Run the CLI:

discord-perms

Features

Channel Permissions

• View all permission overwrites on any channel
• Add, edit, or remove role/member permission overwrites
• Three-state permission selector (Allow / Deny / Inherit)
• Copy permissions from one channel and paste to another

Member Management

• Search members by username
• View and modify member roles
• Copy/paste role sets between members
• Browse member message history

User Experience

• Fuzzy search for channels, roles, and members
• Vim-style /regex filtering
• Keyboard-driven navigation (arrow keys, escape to go back)
• Debug mode with --debug flag

Usage

# Start interactive mode
discord-perms

# Start with debug logging
discord-perms --debug

Navigation

• Arrow keys: Navigate menus
• Enter: Select
• Escape: Go back
• Type: Filter/search
• Ctrl+C twice: Exit

Requirements

• Node.js 20.0.0 or higher
• Discord bot token with appropriate permissions
• Bot must be in the target server

Required Bot Permissions

• Manage Roles - For role assignment
• Manage Channels - For permission overwrites
• Read Message History - For message browsing

Required Bot Intents

• Server Members Intent - For member lookup (enable in Developer Portal)

License

ISC