Dashboard
agenticml ui # http://127.0.0.1:6006agenticml ui --open --port 6006 --host 127.0.0.1agenticml ui --read-onlyagenticml ui binds to 127.0.0.1 on port 6006 and reads straight from the local store. --dir picks a different store (otherwise AGENTICML_DIR, then ~/.agenticml).
Listing runs
Section titled “Listing runs”agenticml ls # newest firstagenticml ls --project demo --jsonls prints the run id, project, name, status, created time, and last step.
Run status
Section titled “Run status”A run stays running while its process holds the run’s lock, even if it logs rarely. If the process is gone, the run shows as crashed. On filesystems without locking, runs untouched for more than 120 seconds show as stale.
The dashboard pages do not show run notes. Launch notes (--notes / init(notes=)) are still stored with the run.
The server’s only write is the /api/runs/<id>/notes endpoint. --read-only disables it. Use it if you expose the dashboard on a non-loopback --host.
Inspecting and editing runs from the CLI
Section titled “Inspecting and editing runs from the CLI”In addition to agenticml ls, the CLI provides commands to inspect details, export data, and update finished runs.
Inspecting runs
Section titled “Inspecting runs”agenticml show RUN_IDagenticml show RUN_ID --jsonagenticml export RUN_ID -o metrics.csvagenticml export RUN_ID --key loss --key accuracy --format jsonagenticml show RUN_ID displays the run header (ID, project, name, status, task, created time, parent, and tags/group/job type/notes when present), configuration (hiding internal keys starting with _), summary, a metrics table (KEY, LAST, STEP, POINTS), an artifacts table (NAME, TYPE, VERSION, SIZE, PATH), and media item counts. Pass --json to output a strict JSON document; non-finite floats are output as null. LAST and STEP reflect the last written record (or the overview’s largest step and last finite value for series pruned by sync --prune). Missing runs, bad IDs, or corrupt metadata print an error on stderr and exit 1.
agenticml export RUN_ID dumps raw metric series. Default format is CSV (key,step,value in write order, float32 formatted exactly, non-finite values as nan, inf, -inf). --format json outputs {"run_id": ..., "series": {key: [[step, value], ...]}} with non-finite values as null. Filter series with repeatable --key K. Use -o PATH to write to a file. Unknown keys fail before writing (exit 1). Pruned series are skipped with a warning; if all chosen series were pruned, export exits 1.
Editing ended runs
Section titled “Editing ended runs”Ended runs can be updated directly from the CLI. edit, artifact add, and finish refuse live runs whose lock is held (exit 1). They do not mark runs as running and do not refresh heartbeats. Changes made with edit, artifact add, and finish are uploaded by the next agenticml sync, even for runs that were already synced. Runs pruned by sync --prune cannot be edited.
agenticml edit RUN_ID --tag best --summary test_acc=0.913 --group sweep-3agenticml artifact add RUN_ID model.pt --name checkpoint --copyagenticml finish RUN_ID --status crashedagenticml note RUN_ID --set "Validation score confirmed"agenticml edit RUN_ID: Updates metadata on an ended run.--tag Tand--untag Tare repeatable (add if absent, remove every occurrence).--notes TEXTupdates the launch note (""clears it).--group NAMEand--job-type NAMEset the group and job type (cannot be cleared).--config KEY=VALUEand--summary KEY=VALUEmerge values using the same JSON/string parsing rules asrun --config.--unset-summary KEYremoves a summary key. Project, name, task, parent, and run ID cannot be changed.agenticml artifact add RUN_ID PATH: Records an artifact on an ended run (--namedefaults to file stem,--typedefaults tofile,--metadataaccepts a JSON object).--copystores file bytes in the object store; otherwise only path, size, and mtime are recorded. Version increments per name.agenticml finish RUN_ID --status finished|crashed: Finalizes a run leftrunning,stale, orcrashed(or toggles finished/crashed), writing overviews andfinished_atwhile preserving summary metrics. If the run is already in that status, exits 0.agenticml note RUN_ID: Reads or updates the run’s local Markdown note (runs/<id>/notes.md) using--set TEXT,--file PATH(-for stdin), or--clear. The notepad is local and not synced. Unlike the other commands,noteworks even while the run is live. Without flags, it prints the current note.
Note that agenticml note modifies the local note file (notes.md). To change the run’s synced launch note, use agenticml edit --notes TEXT.