CLI Commands

Complete reference for every discli command, subcommand, argument, and option.

Global Options

These options apply to all commands and must appear before the subcommand.

Option	Env Var	Description
`--token TEXT`	`DISCORD_BOT_TOKEN`	Discord bot token
`--json`		Output as JSON
`--yes`, `-y`		Skip confirmation prompts for destructive actions
`--profile CHOICE`	`DISCLI_PROFILE`	Override permission profile (`full`, `chat`, `readonly`, `moderation`)

message

Send, list, edit, and delete messages.

message send

Send a message to a channel.

discli message send <channel> <text> [OPTIONS]

Argument / Option	Required	Description
`CHANNEL`	yes	Channel name or ID
`TEXT`	yes	Message content
`--embed-title TEXT`	no	Embed title
`--embed-desc TEXT`	no	Embed description
`--embed-color HEX`	no	Embed color (e.g. `5865F2`)
`--embed-footer TEXT`	no	Embed footer text
`--embed-image URL`	no	Embed image URL
`--embed-thumbnail URL`	no	Embed thumbnail URL
`--embed-author TEXT`	no	Embed author name
`--embed-field TEXT`	no	Embed field (repeatable, format `Name::Value::Inline`)
`--file PATH`	no	File to attach (repeatable)

message list

List recent messages in a channel.

discli message list <channel> [OPTIONS]

Argument / Option	Required	Default	Description
`CHANNEL`	yes		Channel name or ID
`--limit N`	no	10	Number of messages to fetch
`--before DATE`	no		Before date (YYYY-MM-DD or ISO)
`--after DATE`	no		After date (YYYY-MM-DD or ISO)

message history

Fetch deep message history from a channel.

discli message history <channel> [OPTIONS]

Argument / Option	Required	Default	Description
`CHANNEL`	yes		Channel name or ID
`--days N`	no		Fetch messages from last N days
`--hours N`	no		Fetch messages from last N hours
`--limit N`	no	unlimited	Max messages to fetch

message get

Fetch a single message by ID.

discli message get <channel> <message_id>

Argument	Required	Description
`CHANNEL`	yes	Channel name or ID
`MESSAGE_ID`	yes	Message snowflake ID

message edit

Edit a message.

discli message edit <channel> <message_id> <new_text>

Argument	Required	Description
`CHANNEL`	yes	Channel name or ID
`MESSAGE_ID`	yes	Message snowflake ID
`NEW_TEXT`	yes	Replacement content

message delete

Delete a message. Requires confirmation (use --yes to skip).

discli message delete <channel> <message_id>

Argument	Required	Description
`CHANNEL`	yes	Channel name or ID
`MESSAGE_ID`	yes	Message snowflake ID

message bulk-delete

Delete multiple messages at once. Requires confirmation (use --yes to skip).

discli message bulk-delete <channel> <id1> <id2> ...

Argument	Required	Description
`CHANNEL`	yes	Channel name or ID
`ID1 ID2 ...`	yes	Message snowflake IDs to delete

message reply

Reply to a specific message.

discli message reply <channel> <message_id> <text> [OPTIONS]

Argument / Option	Required	Description
`CHANNEL`	yes	Channel name or ID
`MESSAGE_ID`	yes	Message to reply to
`TEXT`	yes	Reply content
`--file PATH`	no	File to attach (repeatable)

message search

Search messages in a channel by content.

discli message search <channel> <query> [OPTIONS]

Argument / Option	Required	Default	Description
`CHANNEL`	yes		Channel name or ID
`QUERY`	yes		Search string (case-insensitive)
`--limit N`	no	100	Number of messages to scan
`--author TEXT`	no		Filter by author name
`--before DATE`	no		Before date (YYYY-MM-DD or ISO)
`--after DATE`	no		After date (YYYY-MM-DD or ISO)

dm

Send and read direct messages.

dm send

Send a direct message to a user.

discli dm send <user> <text> [OPTIONS]

Argument / Option	Required	Description
`USER`	yes	User ID or username
`TEXT`	yes	Message content
`--file PATH`	no	File to attach (repeatable)

dm list

List recent DMs with a user.

discli dm list <user> [OPTIONS]

Argument / Option	Required	Default	Description
`USER`	yes		User ID or username
`--limit N`	no	10	Number of messages to fetch

reaction

Add, remove, and list reactions.

reaction add

Add a reaction to a message.

discli reaction add <channel> <message_id> <emoji>

Argument	Required	Description
`CHANNEL`	yes	Channel name or ID
`MESSAGE_ID`	yes	Message snowflake ID
`EMOJI`	yes	Emoji character or custom emoji string

reaction remove

Remove a reaction from a message.

discli reaction remove <channel> <message_id> <emoji>

Argument	Required	Description
`CHANNEL`	yes	Channel name or ID
`MESSAGE_ID`	yes	Message snowflake ID
`EMOJI`	yes	Emoji character or custom emoji string

reaction list

List reactions on a message.

discli reaction list <channel> <message_id>

Argument	Required	Description
`CHANNEL`	yes	Channel name or ID
`MESSAGE_ID`	yes	Message snowflake ID

reaction users

List users who reacted with a specific emoji.

discli reaction users <channel> <message_id> <emoji> [OPTIONS]

Argument / Option	Required	Default	Description
`CHANNEL`	yes		Channel name or ID
`MESSAGE_ID`	yes		Message snowflake ID
`EMOJI`	yes		Emoji character or custom emoji string
`--limit N`	no	100	Max users to list

channel

List, create, delete, and inspect channels.

channel list

List channels in a server.

discli channel list [OPTIONS]

Option	Required	Description
`--server TEXT`	no	Server name or ID (lists all servers if omitted)

channel create

Create a channel in a server.

discli channel create <server> <name> [OPTIONS]

Argument / Option	Required	Default	Description
`SERVER`	yes		Server name or ID
`NAME`	yes		Channel name
`--type CHOICE`	no	`text`	Channel type: `text`, `voice`, `category`, or `forum`
`--topic TEXT`	no		Channel topic

channel delete

Delete a channel. Requires confirmation (use --yes to skip).

discli channel delete <channel>

Argument	Required	Description
`CHANNEL`	yes	Channel name or ID

channel info

Show channel details.

discli channel info <channel>

Argument	Required	Description
`CHANNEL`	yes	Channel name or ID

channel edit

Edit channel settings.

discli channel edit <channel> [OPTIONS]

Argument / Option	Required	Description
`CHANNEL`	yes	Channel name or ID
`--name TEXT`	no	New channel name
`--topic TEXT`	no	New channel topic
`--slowmode N`	no	Slowmode delay in seconds (0 to disable)
`--nsfw` / `--no-nsfw`	no	Toggle NSFW setting

channel forum-post

Create a forum post in a forum channel.

discli channel forum-post <channel> <title> <content> [OPTIONS]

Argument / Option	Required	Description
`CHANNEL`	yes	Forum channel name or ID
`TITLE`	yes	Post title
`CONTENT`	yes	Post body content
`--file PATH`	no	File to attach (repeatable)

channel set-permissions

Set permission overwrites for a channel.

discli channel set-permissions <channel> <target> [OPTIONS]

Argument / Option	Required	Description
`CHANNEL`	yes	Channel name or ID
`TARGET`	yes	Role or member name/ID
`--allow TEXT`	no	Comma-separated permissions to allow
`--deny TEXT`	no	Comma-separated permissions to deny
`--target-type CHOICE`	no	Target type: `role` or `member` (default: `role`)

thread

Create, list, and send messages in threads.

thread create

Create a thread from a message.

discli thread create <channel> <message_id> <name>

Argument	Required	Description
`CHANNEL`	yes	Parent channel name or ID
`MESSAGE_ID`	yes	Message to create thread from
`NAME`	yes	Thread name

thread list

List active threads in a channel.

discli thread list <channel>

Argument	Required	Description
`CHANNEL`	yes	Channel name or ID

thread send

Send a message to a thread.

discli thread send <thread> <text> [OPTIONS]

Argument / Option	Required	Description
`THREAD`	yes	Thread name or ID
`TEXT`	yes	Message content
`--file PATH`	no	File to attach (repeatable)

thread archive

Archive a thread.

discli thread archive <thread>

Argument	Required	Description
`THREAD`	yes	Thread name or ID

thread unarchive

Unarchive a thread.

discli thread unarchive <thread>

Argument	Required	Description
`THREAD`	yes	Thread name or ID

thread rename

Rename a thread.

discli thread rename <thread> <new_name>

Argument	Required	Description
`THREAD`	yes	Thread name or ID
`NEW_NAME`	yes	New thread name

thread add-member

Add a member to a thread.

discli thread add-member <thread> <member_id>

Argument	Required	Description
`THREAD`	yes	Thread name or ID
`MEMBER_ID`	yes	Member user ID

thread remove-member

Remove a member from a thread.

discli thread remove-member <thread> <member_id>

Argument	Required	Description
`THREAD`	yes	Thread name or ID
`MEMBER_ID`	yes	Member user ID

server

List and inspect servers.

server list

List servers the bot is in.

discli server list

No arguments or options.

server info

Show server details.

discli server info <server>

Argument	Required	Description
`SERVER`	yes	Server name or ID

role

Manage server roles.

role list

List roles in a server.

discli role list <server>

Argument	Required	Description
`SERVER`	yes	Server name or ID

role create

Create a role.

discli role create <server> <name> [OPTIONS]

Argument / Option	Required	Description
`SERVER`	yes	Server name or ID
`NAME`	yes	Role name
`--color HEX`	no	Hex color (e.g. `ff0000`)
`--permissions INT`	no	Permission integer

role delete

Delete a role. Requires confirmation (use --yes to skip).

discli role delete <server> <role>

Argument	Required	Description
`SERVER`	yes	Server name or ID
`ROLE`	yes	Role name or ID

role assign

Assign a role to a member.

discli role assign <server> <member> <role>

Argument	Required	Description
`SERVER`	yes	Server name or ID
`MEMBER`	yes	Member name or ID
`ROLE`	yes	Role name or ID

role remove

Remove a role from a member.

discli role remove <server> <member> <role>

Argument	Required	Description
`SERVER`	yes	Server name or ID
`MEMBER`	yes	Member name or ID
`ROLE`	yes	Role name or ID

role edit

Edit a role’s settings.

discli role edit <server> <role> [OPTIONS]

Argument / Option	Required	Description
`SERVER`	yes	Server name or ID
`ROLE`	yes	Role name or ID
`--name TEXT`	no	New role name
`--color HEX`	no	Hex color (e.g. `ff0000`)
`--hoist` / `--no-hoist`	no	Toggle displaying role separately in sidebar
`--mentionable` / `--no-mentionable`	no	Toggle whether role can be @-mentioned

member

List, inspect, kick, ban, and unban members.

member list

List members of a server.

discli member list <server> [OPTIONS]

Argument / Option	Required	Default	Description
`SERVER`	yes		Server name or ID
`--limit N`	no	50	Max members to list

member info

Show member details.

discli member info <server> <member>

Argument	Required	Description
`SERVER`	yes	Server name or ID
`MEMBER`	yes	Member name or ID

member kick

Kick a member from the server. Requires confirmation (use --yes to skip).

discli member kick <server> <member> [OPTIONS]

Argument / Option	Required	Description
`SERVER`	yes	Server name or ID
`MEMBER`	yes	Member name or ID
`--reason TEXT`	no	Reason for kick
`--triggered-by TEXT`	no	User ID who triggered this action (for permission check)

member ban

Ban a member from the server. Requires confirmation (use --yes to skip).

discli member ban <server> <member> [OPTIONS]

Argument / Option	Required	Description
`SERVER`	yes	Server name or ID
`MEMBER`	yes	Member name or ID
`--reason TEXT`	no	Reason for ban
`--triggered-by TEXT`	no	User ID who triggered this action (for permission check)

member unban

Unban a member from the server. Requires confirmation (use --yes to skip).

discli member unban <server> <member> [OPTIONS]

Argument / Option	Required	Description
`SERVER`	yes	Server name or ID
`MEMBER`	yes	Member name or ID (username or user ID)
`--triggered-by TEXT`	no	User ID who triggered this action (for permission check)

member timeout

Timeout a member, preventing them from sending messages or joining voice. Requires confirmation (use --yes to skip).

discli member timeout <server> <member> <duration> [OPTIONS]

Argument / Option	Required	Description
`SERVER`	yes	Server name or ID
`MEMBER`	yes	Member name or ID
`DURATION`	yes	Timeout duration in seconds (0 to remove timeout)
`--reason TEXT`	no	Reason for timeout
`--triggered-by TEXT`	no	User ID who triggered this action (for permission check)

poll

Create and manage polls.

poll create

Create a poll in a channel.

discli poll create <channel> <question> <answers...> [OPTIONS]

Argument / Option	Required	Default	Description
`CHANNEL`	yes		Channel name or ID
`QUESTION`	yes		Poll question
`ANSWERS`	yes		Two or more poll options (space-separated)
`--duration N`	no	24	Poll duration in hours
`--multiple`	no	false	Allow multiple selections
`--emoji`, `-e`	no		Emoji for each answer (in order, repeatable)

Example:

discli poll create #general "Favorite AI?" Claude Gemini ChatGPT
discli poll create #general "Best?" A B C -e a_emoji -e b_emoji -e c_emoji
discli poll create #general "Vote!" Yes No --multiple -e ok -e x

poll results

View results of a poll.

discli poll results <channel> <message_id>

Argument	Required	Description
`CHANNEL`	yes	Channel name or ID
`MESSAGE_ID`	yes	Message snowflake ID of the poll

poll end

End a poll early.

discli poll end <channel> <message_id>

Argument	Required	Description
`CHANNEL`	yes	Channel name or ID
`MESSAGE_ID`	yes	Message snowflake ID of the poll

typing

Show typing indicator in a channel.

discli typing <channel> [OPTIONS]

Argument / Option	Required	Default	Description
`CHANNEL`	yes		Channel name or ID
`--duration N`	no	5	Seconds to show typing indicator

listen

Listen for real-time Discord events. Outputs events to stdout. Press Ctrl+C to stop.

discli listen [OPTIONS]

Option	Required	Default	Description
`--server TEXT`	no		Filter by server name or ID
`--channel TEXT`	no		Filter by channel name or ID
`--events TEXT`	no	all	Comma-separated event types: `messages`, `reactions`, `members`, `edits`, `deletes`, `voice`
`--ignore-bots` / `--include-bots`	no	`--ignore-bots`	Ignore messages from bots

serve

Start a persistent bot process with bidirectional JSONL communication. Events are emitted on stdout; commands are read from stdin.

discli serve [OPTIONS]

Option	Required	Default	Description
`--server TEXT`	no		Filter events by server name or ID
`--channel TEXT`	no		Filter events by channel name or ID
`--events TEXT`	no	all	Comma-separated event types: `messages`, `reactions`, `members`, `edits`, `deletes`, `voice`
`--include-self` / `--no-include-self`	no	`--include-self`	Include bot’s own messages in events
`--slash-commands PATH`	no		JSON file defining slash commands to register
`--status CHOICE`	no	`online`	Bot status: `online`, `idle`, `dnd`, `invisible`
`--activity TEXT`	no		Activity type: `playing`, `watching`, `listening`, `competing`
`--activity-text TEXT`	no		Activity display text

See Serve Actions and Serve Events for the full JSONL protocol.

webhook

Manage channel webhooks.

webhook list

List webhooks for a channel.

discli webhook list <channel>

Argument	Required	Description
`CHANNEL`	yes	Channel name or ID

webhook create

Create a webhook for a channel.

discli webhook create <channel> <name>

Argument	Required	Description
`CHANNEL`	yes	Channel name or ID
`NAME`	yes	Webhook name

webhook delete

Delete a webhook. Requires confirmation (use --yes to skip).

discli webhook delete <channel> <webhook_id>

Argument	Required	Description
`CHANNEL`	yes	Channel name or ID
`WEBHOOK_ID`	yes	Webhook snowflake ID

event

Manage scheduled server events.

event list

List scheduled events for a server.

discli event list <server>

Argument	Required	Description
`SERVER`	yes	Server name or ID

event create

Create a scheduled event.

discli event create <server> <name> <start_time> [OPTIONS]

Argument / Option	Required	Description
`SERVER`	yes	Server name or ID
`NAME`	yes	Event name
`START_TIME`	yes	Start time (ISO 8601 format)
`--end-time TEXT`	no	End time (ISO 8601 format)
`--location TEXT`	no	Event location (for external events)
`--channel TEXT`	no	Voice/stage channel for the event
`--description TEXT`	no	Event description

event delete

Delete a scheduled event. Requires confirmation (use --yes to skip).

discli event delete <server> <event_id>

Argument	Required	Description
`SERVER`	yes	Server name or ID
`EVENT_ID`	yes	Event snowflake ID

config

Manage discli configuration. Configuration is stored in ~/.discli/config.json.

config set

Set a config value.

discli config set <key> <value>

Argument	Required	Description
`KEY`	yes	Config key (e.g. `token`)
`VALUE`	yes	Config value

config show

Show current configuration. Token values are truncated in plain-text output.

discli config show

permission

Manage permission profiles for command access control.

permission show

Show the active permission profile, including allowed and denied command patterns.

discli permission show

permission set

Set the active permission profile.

discli permission set <profile>

Argument	Required	Description
`PROFILE`	yes	One of `full`, `chat`, `readonly`, `moderation`

permission profiles

List all available permission profiles.

discli permission profiles

See Permission Profiles for details on each profile.

audit

View the audit log. Destructive actions are logged to ~/.discli/audit.log.

audit show

Show recent audit log entries.

discli audit show [OPTIONS]

Option	Required	Default	Description
`--limit N`	no	20	Number of entries to show

audit clear

Clear the audit log.

discli audit clear

Last updated: March 22, 2026

7 min read

Edit this page