Use the dashboard
The dashboard is a local browser workbench for browsing workflows, previewing dry runs, starting real runs, watching structured events, and handing completed artifacts to follow-up agents. It exists because long multi-agent workflows are easier to inspect as stateful runs than as terminal output alone.
Open it
nax dashboard reviewSurfaces
| Surface | What it does |
|---|---|
| Workflow list | Reads the same workflows as nax list. |
| Graph canvas | Shows steps, agents, inputs, submit mode, and run status. |
| Dry Run | Runs nax run <flow> --dry --force through the local API. |
| Run | Starts the workflow after browser confirmation. |
| Recent runs | Reads .nax/workflows and highlights resumable or completed runs. |
| Run details | Shows results, prompt source, artifacts, copy/open actions, and follow-up controls. |
Develop the dashboard UI
node src/cli/nax.js dashboard --no-open --port 53734
NAX_DASHBOARD_API_URL=http://127.0.0.1:53734 npm run dashboard:devOpen the Vite URL with the printed token:
http://127.0.0.1:5173/?token=<token>&workflow=do-next⚠️
Mutating dashboard endpoints require the token embedded in the opened URL or supplied as x-nax-token.
Follow up from a run
In Run details, choose Send to next agent. The composer requires fresh instructions, defaults to the last meaningful artifact, and lets you choose which workflow, step, runner, session, or result artifacts to include.
See also
- Run workflows for command-line equivalents.
- Configuration reference for dashboard environment variables.
- Troubleshooting for common dashboard failures.
Last updated on