Commands

Commands

All commands are Discord slash commands registered via REST API on startup.

Room Management

These commands require the ManageChannels Discord permission.

/new name:<name> [mode:<mode>] [agent:<name>] [path:<dir>]

Creates a new room (Discord text channel).

• Channel is named claude-<name>
• Created inside the current category if one exists
• If inside a project category and no path specified, uses the project's shared workspace
• Default mode is bypassPermissions
• Default agent is the first AGENT_* defined (or claude)

/delete force:True [wipe:False]

Deletes the current room.

• Kills the tmux session
• Removes the DB row
• Optionally wipes the workspace directory (wipe:True)
• Blocked for project rooms (to protect shared workspace)
• Deletes the Discord channel

/rename name:<new>

Renames the current room to claude-<new>. Updates the Discord channel name and DB record.

/mode mode:<mode>

Changes the permission mode for the current room.

• Updates the DB
• Kills the current tmux session
• Next /enter restarts the agent with new mode flags

Mode options:

Mode	Description
default	Normal permissions (asks before edits/commands)
plan	Plan mode only
acceptEdits	Auto-accept file edits
bypassPermissions	Skip all permission prompts (default)

/agent name:<name>

Switches the agent for this room.

• Shows the new agent name and command
• Resets the tmux session — the current session is killed
• Next /enter starts the new agent
• See Multi-Agent for details

/rooms

Lists all non-archived rooms in the current guild.

Projects

See Projects for full details.

/project create name:<name> [dir:<path>] [mode:<mode>]

Creates a new project (Discord category + shared workspace).

/project list

Lists all projects in the current guild.

/project delete force:True [delete_rooms:True]

Deletes the project. Run from a channel inside the project category.

/project info

Shows project info for the current channel's category.

Messaging

/enter

Flushes the message buffer and sends it to the agent.

• Combines all buffered messages with newlines
• Appends attachment references with absolute paths
• Creates the tmux session if needed (lazy initialization)
• Sends the composed text via tmux send-keys

/cancel

Drops the current message buffer. Returns the number of discarded entries.

/buffer

Shows a snapshot of the current buffer:

• Entry count
• Total characters
• Attachment count
• Preview (truncated to 1500 chars)

/reset

Resets the session for the current channel.

• Kills the tmux session
• Clears the in-memory session state
• Next /enter starts a fresh agent instance

/status

Shows session information:

• Tmux session name
• Workspace path
• Whether tmux is alive
• Current agent and its command
• Current mode
• Registration status

Access Control

Bot owner only (auto-detected from Discord application info + BOT_OWNER_IDS env).

/acl add type:<user|role|channel> value:<id|mention>

Adds an entry to the allowlist. Writes to both DB and in-memory cache.

/acl remove type:<user|role|channel> value:<id|mention>

Removes an entry from the allowlist.

/acl list

Shows all ACL entries (users, roles, channels) and registered room count.

Help

/help

Displays a formatted help message with command descriptions and available agents.

Menu Buttons

When an agent presents interactive menus (numbered choices), the bot renders them as Discord buttons. Clicking a button sends the corresponding digit + Enter to the tmux session. Buttons are disabled after use to prevent double-sends.