Task System Overview

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.

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.

Core Concepts

Task Structure

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.

Creating Tasks — How to create and manage tasks
Task Flow — The full task lifecycle
Tasks UI — Dashboard task management interface

Web UI

Dashboard

Tasks

Gateway & Ops

Intent & Safety

Security

Overview

Core Concepts

Task Structure

Priority Queue

Sources

Agent Tools

Storage

​Overview

​Core Concepts

​Task Structure

​Priority Queue

​Sources

​Agent Tools

​Storage

​Related Pages

Overview

Core Concepts

Task Structure

Priority Queue

Sources

Agent Tools

Storage

Related Pages