Understanding Your Agent's Task Count
Table of Contents
Your agent card in the dashboard now shows a task count, like "47 tasks today" or "12 tasks this week." This guide explains what that number means and how to use it.
What Counts as a Task
A task is one complete turn: you (or a channel like Telegram) send a message, and your agent responds. Each turn counts as one task regardless of how complex the response is.
If your agent makes five tool calls while answering a single question, that still counts as one task. Tasks measure completed interactions, not individual steps within an interaction.
Where the Number Appears
The task count appears on your agent card in the main dashboard, right after the context percentage:
Status: running . Claude Opus . Context: 12.3% . 47 tasks today
The count only appears for agents that have activity data. New agents without any completed tasks won't show the metric.
Adaptive Time Windows
The dashboard picks the most relevant time window automatically:
- Tasks today: Shows if the agent completed at least one task in the last 24 hours
- Tasks this week: Falls back to this if today's count is zero
- Tasks this month: Falls back to this if the week count is also zero
This prevents showing "0 tasks today" for agents that only run on a schedule, like a weekly report generator.
Using Task Counts
Spot silent agents
If a running agent shows "0 tasks this week" when it normally processes messages daily, something may be wrong. Check its logs for errors.
Verify cron schedules
If you set up a daily briefing agent, the task count confirms it is actually running. "7 tasks this week" for a daily agent means it hasn't missed a day.
Compare agent workloads
If you have multiple agents, task counts help you see which ones are doing the most work. This can inform decisions about resource allocation or whether to split a busy agent into two.
Frequently Asked Questions
Why is my task count lower than expected?
Task counting was just added. Only turns that happen after the update are counted. Historical turns from before the feature was deployed are not included.
Does the count reset when I restart my agent?
No. Task counts are stored in a file inside your agent's persistent storage. Restarting the agent, updating the image, or even recreating the container preserves the count.
Are failed turns counted?
Yes, failed turns (where the LLM returned an error) are counted as tasks. They also increment a separate error counter, though this is not yet visible in the dashboard.