Coding-agent workflow

RLViz exposes structured CLI commands so an agent can inspect data and compose the GUI without scraping terminal output or automating browser clicks.

Find relevant trajectories

rlviz trajectories TRACE --query checkout --failed --group-by trial --json

The query operates on canonical indexed data. Unsupported sources need a reviewed adapter first.

Open and update the GUI

rlviz workspace open TRACE --group trials --trajectory rollout-01 --detail rollout-02 --json
rlviz workspace add WORKSPACE_ID --trajectory rollout-07 --json
rlviz workspace group WORKSPACE_ID --by rollouts --json
rlviz workspace detail WORKSPACE_ID --trajectory rollout-07 --json
rlviz workspace show WORKSPACE_ID --json

workspace open returns an authenticated local URL and workspace ID. Later commands update the already-open GUI. GUI changes are written back, so agent commands operate on the current logical workspace.

Safety