Tasks

Tasks are a personal task board for tracking work items through your AI. Unlike skills and memories, tasks are ephemeral work trackers — they help you organize what you're doing right now, and when completed, they automatically save as memories for future reference.

What are Tasks?

Tasks let you track work items directly through your AI conversations. Each task has a title, status, priority, and domain. As you work through tasks, you update their status. When a task is completed, the result is automatically saved as a memory, making it discoverable in future sessions.

Creating Tasks

"create a task to update the billing integration docs"

task(action="create",
  title="Update billing integration docs",
  description="Add new Stripe webhook endpoints and error handling examples",
  domain="documentation",
  priority="high",
  tags=["billing", "docs"])

Tasks start with open status by default.

Updating Tasks

Progress tasks through their lifecycle:

task(action="update", task_id="task_abc123", status="in_progress")

Status Flow

open → in_progress → completed
                   → cancelled

• open — not yet started
• in_progress — actively being worked on
• completed — finished, result saved as memory
• cancelled — abandoned, no memory created

Completing Tasks

When you finish a task, mark it complete with a result summary:

"mark the billing docs task as done — added webhook endpoints and error examples"

task(action="update",
  task_id="task_abc123",
  status="completed",
  result={summary: "Added Stripe webhook endpoint docs and error handling examples to the billing integration guide"})

Completed tasks automatically save as memories. This means the work you track today becomes discoverable context tomorrow — your AI can find it via session(action="apply") or memory(action="recall") in future conversations.

Listing and Filtering

View your tasks:

task(action="list")

Filter by status, domain, or search query:

task(action="list", status="open")
task(action="list", domain="documentation")
task(action="list", query="billing", limit=10)

Or through conversation:

"show my open tasks"
"what tasks do I have for documentation?"

API Reference

For the full technical reference including all parameters and options, see task Tool Reference.