ReferenceCLI Reference
Tracking External (Non-Weco) Runs
Track experiments from your own optimization loop in the Weco dashboard.
Track experiments from your own optimization loop (LLM agents, custom scripts, manual experiments) in the Weco dashboard.
# Initialize a run (prints run ID to stdout)
WECO_RUN_ID=$(weco observe init --name "my-experiment" --metric val_bpb --goal min --source train.py)
# Log experiment results
weco observe log --run-id "$WECO_RUN_ID" --step 0 --description "baseline" --metrics '{"val_bpb": 2.36}' --source train.py
weco observe log --run-id "$WECO_RUN_ID" --step 1 --description "increase batch size" --metrics '{"val_bpb": 2.26}' --source train.py
weco observe log --run-id "$WECO_RUN_ID" --step 2 --status failed --description "OOM" --metrics '{"val_bpb": 0.0}' --source train.pyAll observe commands are fire-and-forget — they always exit 0 and never crash your agent's loop. For full documentation, see Weco Observe.