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

# Task System Overview

> ArgentOS task system — a priority queue with accountability for your AI agent.

## Overview

The task system gives your ArgentOS agent a structured way to track work. Instead of ad-hoc requests that get lost in conversation history, tasks are persistent records with status, priority, and accountability tracking.

<Info>
  Tasks are stored in a SQLite database shared between the agent and the dashboard, so both sides have the same view of what needs to be done.
</Info>

## Core Concepts

### Task Structure

```typescript theme={null}
interface Task {
  id: string;
  title: string;
  description?: string;
  status: "pending" | "in_progress" | "blocked" | "completed" | "failed";
  priority: "urgent" | "high" | "normal" | "low" | "background";
  source: "user" | "agent" | "heartbeat" | "schedule";
  createdAt: string;
  updatedAt: string;
  completedAt?: string;
}
```

### Priority Queue

Tasks are ordered by priority:

| Priority     | When to Use                 |
| ------------ | --------------------------- |
| `urgent`     | Needs immediate attention   |
| `high`       | Important, do soon          |
| `normal`     | Standard priority (default) |
| `low`        | Do when there is free time  |
| `background` | Long-running, no deadline   |

The agent processes tasks in priority order when triggered by the heartbeat or user.

### Sources

Tasks can be created by:

* **User**: Explicitly requested via chat, dashboard, or CLI
* **Agent**: The agent creates tasks for itself based on conversations
* **Heartbeat**: Recurring tasks generated by the heartbeat system
* **Schedule**: Cron-like scheduled tasks

## Agent Tools

The agent interacts with tasks through these tools:

| Tool             | Description                                               |
| ---------------- | --------------------------------------------------------- |
| `tasks_list`     | List all tasks, optionally filtered by status or priority |
| `tasks_add`      | Create a new task                                         |
| `tasks_start`    | Mark a task as in\_progress                               |
| `tasks_complete` | Mark a task as completed                                  |
| `tasks_block`    | Mark a task as blocked with a reason                      |

## Storage

Tasks are stored in:

```
~/.argentos/data/dashboard.db
```

This database is shared between the dashboard API server and the agent runtime.

## Related Pages

* [Creating Tasks](/tasks/creating-tasks) -- How to create and manage tasks
* [Task Flow](/tasks/task-flow) -- The full task lifecycle
* [Tasks UI](/dashboard/tasks-ui) -- Dashboard task management interface