> ## Documentation Index
> Fetch the complete documentation index at: https://docs.argentos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating Tasks

> How to create and manage tasks via chat, dashboard, CLI, and agent tools.

## 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

<Tabs>
  <Tab title="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:

    ```json theme={null}
    {
      "tool": "tasks_add",
      "input": {
        "title": "Update server firewall rules",
        "priority": "high",
        "description": "Review and update iptables rules on the Dell R750"
      }
    }
    ```
  </Tab>

  <Tab title="Via Dashboard">
    <Steps>
      <Step title="Open the dashboard at http://localhost:3141" />

      <Step title="Navigate to the Tasks section" />

      <Step title="Click + New Task" />

      <Step title="Fill in title, description, and priority" />

      <Step title="Click Create" />
    </Steps>
  </Tab>

  <Tab title="Via Slash Command">
    ```
    /task Update the server firewall rules
    ```

    This creates a task with default priority (normal) and the provided title.
  </Tab>

  <Tab title="Via CLI">
    ```bash theme={null}
    argent tasks add "Update the server firewall rules" --priority high
    ```
  </Tab>
</Tabs>

## 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

| Field         | Required | Default  | Description                                |
| ------------- | -------- | -------- | ------------------------------------------ |
| `title`       | Yes      | --       | Short description of the task              |
| `description` | No       | --       | Detailed description                       |
| `priority`    | No       | `normal` | urgent, high, normal, low, background      |
| `source`      | Auto     | --       | Set automatically based on creation method |

## Listing Tasks

<Tabs>
  <Tab title="Via Chat">
    ```
    What tasks do I have?
    Show me urgent tasks
    ```
  </Tab>

  <Tab title="Via Slash Command">
    ```
    /tasks
    ```
  </Tab>

  <Tab title="Via CLI">
    ```bash theme={null}
    argent tasks list
    argent tasks list --status pending --priority high
    ```
  </Tab>
</Tabs>

## 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.