Discord Commands

Discord Commands

All commands use the ! prefix. Only users listed in DISCORD_ALLOWED_USERS environment variable can execute commands.

Non-command messages from allowed users are treated as chat — the bot responds using Claude with per-channel conversation history and long-term memory lookup.

---

Task Dispatch

Command	Description
!dev <repo> "<task>"	Run a Claude Code task on a repository
!dev list	List known repositories
!dev scan	Scan for available repositories
!repos	List all known repos (available / unavailable)
!tasks	List currently running dev tasks
!cancel <taskId>	Cancel a running task

Example

!dev my-project "Fix the login form validation"

The bot streams progress updates every 10 seconds while the task runs.

---

Agent Management

Command	Description
!status [session]	Show agent states, current issue, last heartbeat
!pause <session>	Pause autonomous work for an agent
!resume <session>	Resume autonomous work
!limits	Show daily Linear issue creation quota (10/day)

---

Linear Integration

Command	Description
!issues [session]	List Linear issues (paginated, 10 per embed)
!issue <ID>	View issue details

---

Autonomous Execution

Command	Description
!auto	Show autonomous execution status
!auto start [cron] [--pair]	Start autonomous mode with optional cron schedule
!auto stop	Stop autonomous mode
!auto run	Trigger an immediate heartbeat
!auto approve on/off	Toggle auto-approval of tasks
!approve	Approve a pending autonomous task
!reject	Reject a pending autonomous task
!turbo [on|off|status]	Toggle turbo mode (5-min heartbeat, 20 daily cap, 4h auto-expire)

---

Worker/Reviewer Pair Sessions

Command	Description
!pair	Show pair session status
!pair start [taskId]	Start a pair session
!pair run <taskId> [project]	Run a pair pipeline directly
!pair stop [sessionId]	Stop a pair session
!pair history [n]	View session history (default: last 5)
!pair stats	View pair session statistics

---

Scheduling

Command	Description
!schedule	List all scheduled jobs
!schedule run <name>	Run a scheduled job immediately
!schedule toggle <name>	Enable/disable a schedule
!schedule add <name> <path> <interval> "<prompt>"	Add a new schedule
!schedule remove <name>	Remove a schedule

Example

!schedule add nightly-tests ~/dev/project "0 2 * * *" "Run full test suite"

---

CI & GitHub

Command	Description
!ci	Check GitHub CI status across all configured repos
!notifications / !notif	Check GitHub notifications

---

Other

Command	Description
!provider <claude|codex|gpt|local>	Switch CLI adapter at runtime
!codex [list|save|path]	Session record management
!memory search "<query>"	Search cognitive memory
!help	Full command reference

---

Access Control

Set DISCORD_ALLOWED_USERS in your .env file:

DISCORD_ALLOWED_USERS=123456789012345678,987654321098765432

This is a comma-separated list of Discord user IDs. If not set, all commands are denied (fail-closed).