To-dos command reference
Create, assign and complete Discord tasks, and organize personal or channel todo lists.
A question mark after an option means it is optional.
Read as Markdown/todo add
Create a new todo with optional metadata.
Usage
/todo add todo description? due? list? status? assignee? notify_assignee? reminder? visibility?Options
todoRequired- The todo item to create, inspect, edit, complete, assign, or delete.
descriptionOptional- Optional extra details that explain the item more clearly than the short title alone.
dueOptional- An optional due date or time for the todo.
listOptional- The todo list where the task belongs, or the list you want to inspect, edit, clear, or delete.
statusOptional- Filters by status or sets the current state of an item, depending on the command. For example: active, paused, completed, pending, or skipped.
assigneeOptional- The Discord member responsible for a todo. Use this when assigning shared server tasks to a specific person.
notify_assigneeOptional- Controls whether the assigned user should be notified when the todo is created or assigned.
reminderOptional- The reminder text or the existing reminder you want to view, edit, pause, resume, or remove.
visibilityOptional- Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.
/todo show
Inspect a specific todo.
Usage
/todo show todo visibility?Options
todoRequired- The todo item to create, inspect, edit, complete, assign, or delete.
visibilityOptional- Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.
/todo edit
Edit an existing todo.
Usage
/todo edit todo visibility?Options
todoRequired- The todo item to create, inspect, edit, complete, assign, or delete.
visibilityOptional- Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.
/todo status
Change the status of a todo.
Usage
/todo status todo status visibility?Options
todoRequired- The todo item to create, inspect, edit, complete, assign, or delete.
statusRequired- Filters by status or sets the current state of an item, depending on the command. For example: active, paused, completed, pending, or skipped.
visibilityOptional- Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.
/todo assign
Assign a todo to a Discord member.
Usage
/todo assign todo assignee visibility?Options
todoRequired- The todo item to create, inspect, edit, complete, assign, or delete.
assigneeRequired- The Discord member responsible for a todo. Use this when assigning shared server tasks to a specific person.
visibilityOptional- Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.
/todo complete
Mark a todo as completed.
Usage
/todo complete todo visibility?Options
todoRequired- The todo item to create, inspect, edit, complete, assign, or delete.
visibilityOptional- Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.
/todo delete
Delete a todo.
Usage
/todo delete todo visibility?Options
todoRequired- The todo item to create, inspect, edit, complete, assign, or delete.
visibilityOptional- Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.
/todo list show
Show todos from a specific list.
Usage
/todo list show sort? status? list? assignee? visibility?Options
sortOptional- Changes the order of the returned items, such as newest first, oldest first, due date, status, or other supported sorting modes.
statusOptional- Filters by status or sets the current state of an item, depending on the command. For example: active, paused, completed, pending, or skipped.
listOptional- The todo list where the task belongs, or the list you want to inspect, edit, clear, or delete.
assigneeOptional- The Discord member responsible for a todo. Use this when assigning shared server tasks to a specific person.
visibilityOptional- Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.
/todo list browse
Browse available todo lists.
Usage
/todo list browse scope? visibility?Options
scopeOptional- Selects which personal or channel items or lists the command works with. This is separate from who can see the bot's response.
visibilityOptional- Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.
/todo list create
Create a new todo list.
Usage
/todo list create name scope? visibility?Options
nameRequired- The name of the list, project, tag, or other resource being created or updated.
scopeOptional- Selects which personal or channel items or lists the command works with. This is separate from who can see the bot's response.
visibilityOptional- Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.
/todo list edit
Rename or update a todo list.
Usage
/todo list edit list name visibility?Options
listRequired- The todo list where the task belongs, or the list you want to inspect, edit, clear, or delete.
nameRequired- The name of the list, project, tag, or other resource being created or updated.
visibilityOptional- Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.
/todo list clear
Clear todos from a list.
Usage
/todo list clear list? visibility?Options
listOptional- The todo list where the task belongs, or the list you want to inspect, edit, clear, or delete.
visibilityOptional- Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.
/todo list delete
Delete a todo list.
Usage
/todo list delete list visibility?Options
listRequired- The todo list where the task belongs, or the list you want to inspect, edit, clear, or delete.
visibilityOptional- Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.