---
title: Dashboard
description: Source-backed tour of the agent-qa dashboard routes for runs, tests, hooks, suites, memory, insights, config, and queue-aware workflows.
---























The dashboard is the local web UI for inspecting agent-qa runs, editing test assets, reviewing memory, and managing the workspace surfaces that back CLI execution.

Launch it with:

<CommandSnippet command="agent-qa dashboard --port 3470 --open" />

The dashboard command also supports `--db <path>` for the dashboard database and `--open` to open the browser after startup. The `serve` command starts the same dashboard-backed local services from configuration.

## Navigation [#navigation]

The current dashboard sidebar exposes these labels: Runs, Tests, Hooks, Suites, Memory, Insights, and Config.

<img alt="agent-qa dashboard sidebar showing Runs, Tests, Hooks, Suites, Memory, Insights, and Config" src="__img0" />

## Runs [#runs]

Runs open at `/runs`. A run detail page uses `/runs/:id`, and live in-progress execution uses `/runs/:id/live`. The route helper sends active runs to live view when the status should be watched in real time.

Use Runs when you need to inspect recent execution, jump into a specific run, or follow a live run while an agent is acting.

<img alt="Runs table with search, filters, queue slots, statuses, targets, attributes, duration, and start time" src="__img1" />

Run details keep the step timeline next to the captured browser state, tabs for Overview, Variables, Network, Console, ARIA Tree, and A11y, and per-action timing and model usage metadata.

<img alt="Run detail view showing setup hooks, passed steps, browser screenshot, and action breakdown panels" src="__img2" />

Live execution uses the same split-view model while the run is active. The progress bar, cancel control, elapsed timer, current step selection, and verifier/action feedback update as the agent works.

<img alt="Live execution view showing active run progress, step timeline, and action feedback panels" src="__img3" />

## Tests [#tests]

Tests open at `/tests`. New tests use `/tests/new`. Existing tests can be viewed at `/test/:testId`, edited at `/test/:testId/edit`, and opened in live editing mode with `/test/:testId/edit?live=1`.

Use Tests when you are authoring YAML journeys, reviewing generated test ids, or switching between view and edit modes for a test.

The test builder includes Builder, YAML, and Memory tabs. From the builder you can edit the test name, target, context, setup or teardown hooks, and ordered steps, then validate, save, run, or connect a live session.

<img alt="Test builder showing target selection, setup hooks, ordered steps, validate, save, run, and live session controls" src="__img4" />

### Live Mode [#live-mode]

Live Mode connects the editor to a real browser session. The left side stays focused on test structure and step status, while the right side shows the browser surface plus inspection tabs such as Reasoning, Env, Network, Console, and ARIA Tree.

<img alt="Live test editor showing a connected browser session, step status, and the network inspection panel" src="__img5" />

## Hooks [#hooks]

Hooks open at `/hooks`. New hooks use `/hooks/new`. Existing hooks can be viewed at `/hook/:hookId` and edited at `/hook/:hookId/edit`.

Use Hooks to review setup and teardown automation that agent-qa can call before or after a run.

Hook references also appear inside test and suite builders. Setup and teardown hook cards show the stable hook id that is saved back to YAML, so a dashboard edit remains reviewable in source control.

## Suites [#suites]

Suites open at `/suites`. New suites use `/suites/new`. Existing suites can be viewed at `/suite/:suiteId` and edited at `/suite/:suiteId/edit`.

Use Suites to collect related tests into repeatable workflows and review suite-level setup, teardown, targets, and test references.

<img alt="Suite builder showing target selection, setup and teardown hooks, included tests, run suite, and live session controls" src="__img6" />

## Memory [#memory]

Memory opens at `/memory`. Product-specific memory opens at `/memory/:product`. Test-level memory observation panels show observations, invalid memory files, refresh, delete, and empty states such as "No observations yet."

Use Memory to inspect what the agent has learned about products, suites, and tests before trusting future runs that use runtime memory injection.

<img alt="Memory detail page showing product observations, suite and test sections, filters, and copy page control" src="__img7" />

## Insights [#insights]

Insights opens at `/insights`. The dashboard also redirects older `/analytics` and `/trends` routes into Insights.

Use Insights to review chart-oriented views that summarize run and quality signals.

<img alt="Insights dashboard showing pass rate, duration, token usage, memory curator, and observation charts" src="__img8" />

## Config [#config]

Config opens at `/config`. Item-focused config links use `/config?bucket=...&item=...`. The dashboard configuration section includes Dashboard settings for Port, Database Path, Artifacts Directory, and Save Changes.

Use Config to inspect and edit workspace-backed settings for dashboard services and other agent-qa configuration buckets.

<img alt="Configuration page showing execution defaults, default LLM selection, parallel execution, and save runtime defaults" src="__img9" />

## Queue and run management [#queue-and-run-management]

Queue management is source-backed through the CLI rather than a separate sidebar view. Use `agent-qa queue list --server http://localhost:3470` to inspect pending, running, and optionally completed jobs, and `agent-qa queue cancel <runId> --server http://localhost:3470` to cancel a pending or running job.

Use this with Runs and live run routes when you need to decide whether to watch, inspect, or cancel work that is already in progress.