JSPM – @ibbybuilds/discli@0.3.0

Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@ibbybuilds/discli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Discord server management CLI for AI agents and humans.

Create channels, manage roles, set permissions, and control your Discord servers from the terminal.

No bot server needed. No dashboard clicking. Just commands.

Your AI agent (Claude Code, Cursor, Windsurf, Codex) can use discli to manage your Discord server. Create channels, assign roles, rename everything, in seconds.

Why discli?

Setting up a Discord server manually is slow. Using bots for management is limited. MCP tools eat your token budget.

discli gives you direct control over Discord through simple CLI commands:

discli channel create "💬・general" --category "Community"
discli role create "Moderator" --color "#ff5733"
discli perm lock "📜・rules"
discli channel rename "old-name" "🎯・new-name"

One command = one API call. No bot server. No token overhead.

Quick Start

# Install
npm install -g @ibbybuilds/discli

# Setup (paste your bot token)
discli init --token YOUR_BOT_TOKEN

# Start managing
discli channel list
discli server info

How to get a bot token

Go to Discord Developer Portal
Create a new application
Go to Bot > Reset Token > copy it
Go to Installation > set Guild Install scopes: bot, applications.commands with Administrator permission
Use the install link to add the bot to your server
Run discli init --token YOUR_TOKEN

Commands

Server

discli server list              # List servers the bot is in
discli server select <id>       # Set default server
discli server info              # Server overview

Channels

discli channel list                          # List all channels by category
discli channel create <name>                 # Create text channel
discli channel create <name> --type voice    # Create voice channel
discli channel create <name> --category Dev  # Create under a category
discli channel create "Dev" --type category  # Create a category
discli channel rename <channel> <new-name>   # Rename channel
discli channel topic <channel> "topic text"  # Set channel topic
discli channel move <channel> --category X   # Move to a category
discli channel delete <channel> --confirm    # Delete (requires --confirm)

Roles

discli role list                            # List all roles
discli role create <name>                   # Create role
discli role create <name> --color "#e74c3c" # Create with color
discli role assign <role> <user>            # Give role to member
discli role remove <role> <user>            # Remove role from member
discli role delete <name> --confirm         # Delete (requires --confirm)

Members

discli member list                                  # List members
discli member info <user>                           # Member details
discli member nick <user> <nick>                    # Change nickname
discli member kick <user> --confirm --reason "spam" # Kick
discli member ban <user> --confirm                  # Ban

Permissions

discli perm view <channel>                             # View channel permissions
discli perm lock <channel>                             # Make read-only
discli perm unlock <channel>                           # Remove read-only
discli perm set <channel> <role> --deny send_messages  # Fine-grained control
discli perm list                                       # List permission names

Messages

discli msg send <channel> "Hello world"                # Send message
discli msg send <channel> "reply" --reply <msg-id>     # Reply to message
discli msg embed <channel> --title "X" --description "Y" --color "#5865F2"  # Rich embed
discli msg embed <channel> --title "X" --field "Name|Value|inline"          # Embed with fields
discli msg read <channel> -n 10                        # Read last N messages
discli msg edit <channel> <msg-id> "new text"          # Edit bot message
discli msg delete <channel> <msg-id> --confirm         # Delete message
discli msg react <channel> <msg-id> 👍                  # Add reaction
discli msg unreact <channel> <msg-id> 👍                # Remove reaction
discli msg pin <channel> <msg-id>                      # Pin message
discli msg unpin <channel> <msg-id>                    # Unpin message
discli msg pins <channel>                              # List pinned messages
discli msg thread <channel> "Thread Name"              # Create thread
discli msg thread <channel> "Name" --message <msg-id>  # Thread from message

Audit Log

discli audit log                         # View recent audit log
discli audit log -n 50                   # Last 50 entries
discli audit log --type member_kick      # Filter by action type
discli audit log --user <id>             # Filter by who did it
discli audit types                       # List all action type names

For AI Agents

discli is designed for AI coding agents like Claude Code, Cursor, Codex, and others.

How agents use it

Install the skill: copy skills/SKILL.md to your agent's skill directory
Agent reads the skill and learns all available commands
Agent runs commands and manages your server through the terminal

Agent-friendly features

Feature	Details
YAML output by default	5x fewer tokens than JSON when piped
`-n` flag	Limit results to save tokens
`--dry-run`	Preview changes before applying
`--confirm` required	Destructive commands never auto-execute
Structured exit codes	`0` success, `1` error, `2` usage, `3` not found, `4` forbidden
SCHEMA.md	Documents output shapes for predictable parsing
No MCP overhead	Zero token cost at session start

Setup for Claude Code / Cursor

# Install discli globally
npm install -g @ibbybuilds/discli

# Copy the skill file
cp node_modules/discli/skills/SKILL.md ~/.claude/skills/discli/SKILL.md

# Done. Your agent can now use discli.

Example: agent sets up an entire server

You: "Set up my Discord like a dev community with channels for
      general chat, code help, AI tools, and read-only announcements"

Agent runs:
  discli channel create "Community" --type category
  discli channel create "💬・general" --category Community
  discli channel create "💻・code-help" --category Community
  discli channel create "🤖・ai-tools" --category Community
  discli channel create "📢・announcements" --category Info
  discli perm lock "📢・announcements"

Global Flags

Flag	Description
`--format <yaml\|json\|table\|auto>`	Output format. Default: auto (YAML when piped, table in terminal)
`--server <id>`	Target a specific server instead of default
`-n <count>`	Limit results on list commands
`--dry-run`	Preview changes without applying
`--confirm`	Required for destructive actions (delete, kick, ban)

How It Works

discli is not a bot. It's a thin CLI wrapper around the Discord REST API.

discli channel create "test"
    ↓
POST https://discord.com/api/v10/guilds/{id}/channels
Authorization: Bot {your_token}
Body: {"name": "test", "type": 0}
    ↓
Channel created. Done.

No WebSocket connection. No bot process. No server hosting. Your bot can be offline and commands still work.

Bring Your Own Bot

discli uses your bot token. You create the bot, you control the permissions, you own the data. Nothing is sent to us.

~/.discli/
├── config.json    # default server
└── .env           # your bot token (never leaves your machine)

Comparison

	discli	Discord MCP	discord-cli	Manual UI
Purpose	Server management	Server management	Read-only (fetch/search)	Everything
Used by	Agents + humans	Agents only	Agents + humans	Humans only
Token cost	Zero upfront	20-40k on load	Zero upfront	N/A
Create channels	✅	✅	❌	✅
Manage roles	✅	✅	❌	✅
Set permissions	✅	✅	❌	✅
Read messages	✅	✅	✅	✅
Send embeds	✅	✅	❌	✅
Self-hosted	✅	✅	✅	N/A

Roadmap

Message management (send, pin, delete)
Webhook management
Scheduled events
Automod rules
Server templates (export/import structure)
discli setup interactive guided server setup

License

MIT

Built by @ibbybuilds