Creating Tasks

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.

Via Chat

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"
  }
}

Via Dashboard

1. Open the dashboard at http://localhost:3141
2. Navigate to the Tasks section
3. Click + New Task
4. Fill in title, description, and priority
5. Click Create

Via Slash Command

/task Update the server firewall rules

This creates a task with default priority (normal) and the provided title.

Via CLI

argent tasks add "Update the server firewall rules" --priority high

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

Listing Tasks

Via Chat

What tasks do I have?
Show me urgent tasks

Via Slash Command

/tasks

Via CLI

argent tasks list
argent tasks list --status pending --priority high

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.