Help
Task Manager
Tasks

Tasks

A task has several arguments. It contains a text describing what the assigned users or roles should do, it contains an ID which is used to identify the task in any command, and it has one of three states. It can optionally contain a deadline.

Task Data

  • ID*
  • Text
  • State
  • Creator*
  • Creation Date*
  • Deletion Date**
  • Deadline
  • Priority
  • Repeat interval
  • Next repeat date
  • Repeat end date
  • Assigned User(s)
  • Assigned Role(s)

*The ID, creator and creation date are fixed values that can't be changed.

**The deletion date is set when the task is marked as deleted by executing the task delete command.

States

Each task is located in one of the states:

  • Todo - The state with which each task starts. It means that no one has started working on the task.
  • In Progress - This state means that someone has started working on the task.
  • Done - The last state means that the task has been completed.

Deadline

The deadline is set by executing the task deadline command.

Deadline reminders

When a deadline is set and due in less than 12 hours and the task is not done, the bot will send a reminder to every assigned user (not to assigned roles) and a logging message, if logging is configured. A follow-up reminder will be sent up to 12 hours after the deadline has passed, if the task is still not done and the priority is higher than "low". If the priority is set to "high" or "urgent", another follow-up reminder will be sent 36-48 hours after the deadline has passed, if the task is still not done.

Deadlines in calendar

When using the Calendar Manager (opens in a new tab) you can see all tasks with a deadline in the calendar.

Subtasks

A task can hold multiple subtasks in it. Other than the normal tasks, they don't have three states as they just can be completed or not completed. All subtasks can be viewed by using the /task info command.

Repeating Tasks

Tasks can be set to be repeated. This means the task will be moved to the Todo state after it has been completed and the interval has passed. The interval can be set to a specific amount of dates, between 1 and 365.

Once the interval is reached, the task will be checked if it has been completed. If it has, it will be moved to the Todo state. If it hasn't, the task will not be moved, but the next check will happen after the set interval. This process will repeat until the repeat end date is reached. If no repeat end date is set, the task will repeat forever.

In all lists, a repeating task will be marked with a 🔁 symbol.

Auto priority

With the auto priority feature enabled, the bot will use AI to determine the priority of a task based on the text of the task. This feature is disabled by default and has to be enabled manually.

Task Commands

/task create
text
My task text
assignee
@User
project
default
deadline
10/30/2023 09:00
repeat_days
10
label
My label
This command creates a new task. The task will get a random id and the given text will be linked to it.

Command Options

RequiredNameDescription
YestextThe text of the task
NoassigneeA user or role from the server that should get assigned to the task
NoprojectThe project the task should be created in
NodeadlineThe deadline of the task. Can be set to a date with time or as a relative date (e.g. 1w2d)
Norepeat_daysThe interval in days the task should be repeated
NolabelA label that will be added to the task
Required permission: MANAGE_TASKS
/task assign
task_id
12345
assignee
@User
This command adds a new assignee to the specified task. Roles and users can get assigned to a task. There can be a maximum of 15 assignees per task, counting users and roles.

Command Options

RequiredNameDescription
Yestask_idThe id of the task (can be found in the task list or when creating a task)
YesassigneeA user or role from the server that should get assigned to the task
Required permission: MANAGE_TASKS
/task unassign
task_id
12345
assignee
@User
This command removes an assignee from a task.

Command Options

RequiredNameDescription
Yestask_idThe id of the task (can be found in the task list or when creating a task)
YesassigneeA user or role from the server that should get removed from the task
Required permission: MANAGE_TASKS
/task info
task_id
12345
show
FALSE
Provides detailed information about the task.

Command Options

RequiredNameDescription
Yestask_idThe id of the task (can be found in the task list or when creating a task)
NoshowWhether the response should be shown to everyone, or only to the command executor
/task todo
task_id
12345
Sets the status of the task with the given id to todo.

Command Options

RequiredNameDescription
Yestask_idThe id of the task (can be found in the task list or when creating a task)
/task inprogress
task_id
12345
Sets the status of the task with the given id to inprogress.

Command Options

RequiredNameDescription
Yestask_idThe id of the task (can be found in the task list or when creating a task)
/task done
task_id
12345
Sets the status of the task with the given id to done.

Command Options

RequiredNameDescription
Yestask_idThe id of the task (can be found in the task list or when creating a task)
/task edit
task_id
12345
text
My new task text
Allows the command author to change the task text.

Command Options

RequiredNameDescription
Yestask_idThe id of the task (can be found in the task list or when creating a task)
YestextThe new text of the task
Required permission: MANAGE_TASKS
/task list
project
default
assignee
@User
filter
IN_PROGRESS
show
FALSE
Displays all tasks assigned to the specified assignee.

Command Options

RequiredNameDescription
NoprojectThe project the tasks have to be in. If not specified, the currently selected project will be used.
NoassigneeA user or role from the server that should be assigned to the task. If not specified, the command will list all tasks assigned to the command executor.
NofilterThe status the tasks have to be in
NoshowWhether the response should be shown to everyone, or only to the command executor
/task project
project
default
filter
IN_PROGRESS
label
My label
show
FALSE
Displays all tasks inside a selected project.

Command Options

RequiredNameDescription
NoprojectThe project the tasks have to be in. If not specified, the currently selected project will be used.
NofilterThe status the tasks have to be in
NolabelA label the tasks should have
NoshowWhether the response should be shown to everyone, or only to the command executor
/task move
task_id
12345
project
default
Moves a task to a different project.

Command Options

RequiredNameDescription
Yestask_idThe id of the task (can be found in the task list or when creating a task)
YesprojectThe new project the task should be moved to.
Required permission: MANAGE_TASKS
/task deadline
task_id
12345
deadline
12/31/2024 23:59
Sets the deadline of a task.

Command Options

RequiredNameDescription
Yestask_idThe id of the task (can be found in the task list or when creating a task)
NodeadlineThe new deadline of a task in the dateformat selected by a server admin or as a relative date (e.g. 1 day 2 hours) or in a relative short form (1w2d). If no deadline is set the deadline will be removed from the task.
Required permission: MANAGE_TASKS
/task delete
task_id
12345
Move task to recycle bin. Tasks moved to the recycle bin are permanently deleted after 30 days.

Command Options

RequiredNameDescription
Yestask_idThe id of the task (can be found in the task list or when creating a task)
Required permission: MANAGE_TASKS
/task restore
task_id
12345
Restores a deleted task that was previously moved to the Recycle Bin.

Command Options

RequiredNameDescription
Yestask_idThe id of the task (can be found in the task list or when creating a task)
Required permission: MANAGE_TASKS
/task repeat
task_id
12345
repeat_days
7
repeat_end
5 weeks
Makes the task repeatable. If the repeat_days option is set, the task will be repeated every x days. This means the task will be moved back into the todo state when it reached the done state after the repeat interval is reached.

Command Options

RequiredNameDescription
Yestask_idThe id of the task (can be found in the task list or when creating a task)
Norepeat_daysThe interval in days the task should be repeated
Norepeat_endThe date the task should be repeated until. The date can be set as a relative date (e.g. 1w2d) or in a relative short form (1w2d). If no repeat_end is set the task will be repeated indefinitely. If repeat_end is set to a date in the past, the task will not be repeated.
Required permission: MANAGE_TASKS
/task history
task_id
12345
Displays the history of a task. The history contains all changes made to the task.

Command Options

RequiredNameDescription
Yestask_idThe id of the task (can be found in the task list or when creating a task)
Required permission: VIEW_TASKS
/task priority
task_id
12345
priority
high
Changes the priority of a task. The default priority is normal.

Command Options

RequiredNameDescription
Yestask_idThe id of the task (can be found in the task list or when creating a task)
YespriorityThe priority of the task. Can be set to low, normal, high and urgent.
Required permission: MANAGE_TASKS
/task subtasks
task_id
12345
action
add
text
Remove the test button
number
1
Manages subtasks of a task. Subtasks are tasks that are linked to a parent task. They can be used to split a task into smaller tasks.

Command Options

RequiredNameDescription
Yestask_idThe id of the task (can be found in the task list or when creating a task)
YesactionThe action that should be performed on the subtasks. Can be set to add, remove, complete or uncomplete.
NotextThe text of the subtask that should be added. Only required for the add action.
NonumberThe number of the subtask that should be removed, completed or uncompleted. Only required for the remove, complete and uncomplete action.
Required permission: MANAGE_TASKS

Social Media

Twitter

Instagram

Discord

GitHub

YouTube

bnder logo