Weco DocsReferenceCLI Reference
Monitoring Weco Runs
Inspect progress, results, and code, and share runs.
Inspect & manage runs
Inspect progress, results, and code for any run from another terminal — useful for scripting and for LLM agents driving Weco headlessly. Commands print JSON unless noted otherwise.
# Show run status and progress
weco run status <run_id>
# Show all results sorted by metric
weco run results <run_id> --top 5
# Show details for a specific step ('best' or a step number)
weco run show <run_id> --step best
# Show a code diff between steps
weco run diff <run_id> --step best --against baseline
# Update additional instructions for an active run
weco run instruct <run_id> "Focus on memory efficiency instead of speed"
# Terminate a running optimization
weco run stop <run_id>| Command | Description | Key options |
|---|---|---|
weco run status | Run status and progress: current step, best metric and step, model, and any pending nodes. | — |
weco run results | All results sorted by metric. | --top N, --format json|table|csv, --plot (ASCII metric trajectory), --include-code |
weco run show | Details for one step: plan, code, metric, and status. | --step <N|best> (required) |
weco run diff | Per-file unified code diff between two steps. | --step <N|best> (required), --against <baseline|parent|N> (default baseline) |
weco run instruct | Update the additional instructions of an active run. | — |
weco run stop | Terminate a running optimization. The solution tree is preserved, so you can pick it up again with weco resume. | — |
Sharing runs
Create a public share link for a run — anyone with the link can view the run's optimization progress and results in the dashboard.
weco share <run_id>
# Machine-readable output (prints the bare URL only)
weco share <run_id> --output plainThe link looks like https://dashboard.weco.ai/share/<share_id>.
Sharing requires CLI sharing to be enabled in your account settings on the dashboard. To revoke a share link, use the dashboard.