Audit Trail Plugin for Agent Zero

If you're running Agent Zero for real work, you have no idea what it's actually costing you. You fire off tasks, agents call tools, sub-agents spin up — and at the end of the day you have no record of what happened, how long it took, or what you spent.

This plugin fixes that.

What it does

Every time an agent starts a task, the plugin opens a ticket. When the task finishes, it closes the ticket and records:

• What the input was and what the agent responded
• Every tool call the agent made during the task
• How many tokens were used (prompt + completion)
• Estimated cost in USD based on your model's pricing
• Duration, status (completed / failed / timeout), and which agent profile ran it
• Parent-child relationships when sub-agents are involved

All of this is stored per-project in a local SQLite database (.a0proj/audit.db) and surfaced through a dashboard you can open from the sidebar.

Why you'd want this

You're spending money and don't know how much. LLM API calls cost real money. Without tracking, you can't tell if a task cost $0.002 or $0.20, or whether your agents are burning tokens on unnecessary tool calls. The dashboard shows daily, weekly, and monthly cost breakdowns so you can spot trends before your bill surprises you.

You need to know what your agents actually did. Chat history shows you the conversation, but not the full picture — which tools were called, in what order, with what parameters. The audit trail records every tool call with timestamps, so you can reconstruct exactly what happened during any task.

Tasks fail silently and you don't notice. Agents sometimes time out, hit errors, or produce empty responses. The plugin flags these as FAILED or TIMEOUT so you can review what went wrong instead of assuming everything worked.

You're running multiple agents and projects. The plugin tracks per-project, per-agent-profile. If you have different agents handling different workloads, you can see which agent is doing what and how much each project costs.

You want accountability over time. The export feature (CSV / JSON) lets you pull data into spreadsheets or other tools for reporting, budgeting, or compliance.

Installation

Clone or copy this plugin into your Agent Zero plugins directory:

plugins/ciq_audit_trail/

Restart Agent Zero. The plugin will appear in your settings where you can enable it per project.

Dashboard

Open the dashboard from the sidebar button or the quick-actions dropdown. It shows:

• Summary cards — total tasks, total cost, average duration
• Cost chart — daily, weekly, or monthly breakdown with task counts per period
• Ticket list — filterable by status, agent profile, search text, and tags
• Ticket detail — full input/output, tool call log, token counts, cost, timestamps

Cost tracking

The plugin tries to extract real token counts from the agent's log entries. If the LLM provider returns usage data, it uses that. Otherwise it estimates tokens from text length and applies pricing from the bundled cost models.

Included models (all under $3/1M output, OpenRouter-compatible):

Set default_cost_model in the plugin config to match the model your agents actually use.

Settings

Tests

pytest

License

MIT — Animus Systems SL