Skip to main content

Overview

Tasks can be created through multiple interfaces. Regardless of how they are created, they end up in the same SQLite database and are visible everywhere.

Creating Tasks

Tell your agent to create a task in natural language:
Create a task to update the server firewall rules
The agent calls tasks_add and confirms the task was created:
{
  "tool": "tasks_add",
  "input": {
    "title": "Update server firewall rules",
    "priority": "high",
    "description": "Review and update iptables rules on the Dell R750"
  }
}

Agent-Created Tasks

The agent can proactively create tasks when it identifies work to be done:
Agent: I noticed the SSL certificate for argentos.ai expires in 14 days.
       I've created a task to renew it.

[tasks_add: "Renew SSL certificate for argentos.ai" (priority: high)]

Task Fields

FieldRequiredDefaultDescription
titleYesShort description of the task
descriptionNoDetailed description
priorityNonormalurgent, high, normal, low, background
sourceAutoSet automatically based on creation method

Listing Tasks

What tasks do I have?
Show me urgent tasks

Updating Tasks

Completing

Mark the firewall task as done
Or via the dashboard’s complete button.

Blocking

Block the SSL renewal task — waiting on domain registrar response
The agent calls tasks_block with the reason.

Deleting

Tasks can be deleted from the dashboard or CLI. Completed tasks are retained for history.