Skip to main content
Run history is where you debug and audit what agents and workflows did. Use it to see whether a run finished, what started it, which tools or models it used, what it cost, and where it failed. Open the History tab in the web app (in main sidebar) to see runs across the projects you can access in the active organization.

​
What appears in History

History includes two run types: The table shows each run’s name, type, start time, actor, status, trigger, duration, and project. Additional columns are available for run ID, queue time, finish time, models used, other services used, billed amount, message count, step count, and raw trigger value. You can search runs, filter by fields like status, type, project, trigger, actor, model, service, cost, messages, and steps, or use the saved views for failed and running runs.

​
Statuses

Runs can have these statuses: Active runs update automatically while they are queued, running, sleeping, or waiting on a hook.

​
Inspect a run

Select a row in History to open the detail panel. The panel has three tabs: Agent runs show the recorded conversation in the Overview tab. Workflow runs show input and output payloads, or an error payload when the run failed. The Trace tab is the lowest-level view. Spans nest to mirror what actually ran: a trigger run wraps the workflow run, which wraps each action, agent, and model step, which in turn wrap nested tool calls. Reading the spans shows what ran, in what order, and where time and errors went.

​
Use the CLI

Use keystroke history when you want organization-level cloud history from the terminal:
keystroke history list uses the active cloud organization and can filter by project ID, status, and kind. Owners and admins can pass --admin to list all organization resources. For resource-specific inspection, use the agent and workflow run commands:
Those commands inspect runs on your deployed cloud project. See project targeting and the CLI reference.

​
Next steps

Agent runs

Inspect agent sessions, conversations, tool calls, and traces.

Workflow runs

Inspect workflow input, output, errors, steps, and traces.

Run agents

Start agent sessions and inspect their results.

Run workflows

Start workflow runs and review their output.