Tasks Tool

Persistent task database shared across sessions.

Overview

The tasks tool provides a persistent task database that survives across agent sessions. Unlike the Todo tool, which maintains an in-memory task list for the current session only, the tasks tool stores tasks in a SQLite database so they can be accessed and updated across multiple sessions.

Configuration

toolsets:
  - type: tasks
    path: ~/.cagent/tasks.db  # Optional: custom database path

Options

Property	Type	Default	Description
`path`	string	`~/.cagent/tasks.db`	Path to the SQLite task database

Available Tools

The tasks toolset exposes these tools:

Tool Name	Description
`add_task`	Add a new task to the database
`list_tasks`	List all tasks, optionally filtered by status
`update_task`	Update a task’s title, description, or status
`delete_task`	Remove a task from the database

Example

agents:
  root:
    model: openai/gpt-4o
    toolsets:
      - type: tasks
        path: ./project-tasks.db

💡 Tasks vs. Todo

Use the tasks tool when you need persistence across sessions (e.g., long-running projects, recurring work). Use the todo tool for ephemeral, session-scoped task lists.