> ## Documentation Index > Fetch the complete documentation index at: https://docs.duvo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Starting Runs (CLI) > Start Runs, check status, stream messages, respond to human-in-the-loop requests, and stop active Runs with the Duvo CLI. A Run is one execution of an Agent. Use `duvo runs` to start Runs, check status, stream messages, respond to human-in-the-loop requests, and stop active Runs. ## Starting and inspecting Runs ```bash theme={"dark"} duvo runs start --agent # start a Run duvo runs list --agent # list Runs for an Agent duvo runs get # get Run status duvo runs messages # list conversation messages duvo runs stop # stop a running Run ``` For teams using Automations, use `--automation ` to list only Runs whose Agent belongs to that automation. ```bash theme={"dark"} duvo runs list --automation ``` Use `--since` and `--until` to list Runs that completed in a fixed window. The `--since` bound is inclusive, and the `--until` bound is exclusive. ```bash theme={"dark"} duvo runs list --agent \ --since 2026-08-01T00:00:00Z \ --until 2026-08-02T00:00:00Z ``` Add `--json` to any command for machine-readable output suitable for scripting. Add `--count-only` when you need the matching total without Run rows. All Run filters still apply. ```bash theme={"dark"} duvo runs list --agent --status completed --count-only # Total Runs: 42 ``` ## Streaming a Run live Add `--follow` to watch messages stream in real time instead of polling `duvo runs get`. It works two ways: ```bash theme={"dark"} duvo runs start --agent --follow # start a Run and stream its messages duvo runs messages --follow # attach to a running Run and follow new messages ``` `--follow` keeps printing new messages until the Run completes, then exits. ## Mid-run interaction Send a message to a Run in progress (for example, to add clarifying instructions): ```bash theme={"dark"} duvo runs send-message \ --message "Please also check the backup." ``` ## Responding to human-in-the-loop requests When an Agent pauses to ask a human a question or request approval, you can respond from the CLI: ```bash theme={"dark"} duvo runs respond --approve # approve a human request duvo runs respond --deny # deny a human request duvo runs respond \ --answer "=" # answer a pending question ``` The `--answer` flag takes a `=` pair. Find the `` by running `duvo runs messages ` and looking at the pending human request. ## Scripting examples ### Start a Run and wait for it to finish ```bash theme={"dark"} RUN_ID=$(duvo runs start --agent "$AGENT_ID" --json | jq -r '.run.id') while true; do STATUS=$(duvo runs get "$RUN_ID" --json | jq -r '.run.status') case "$STATUS" in completed|failed|stopped) break ;; esac sleep 5 done echo "Run $RUN_ID finished with status: $STATUS" ``` ### Auto-approve any pending human requests on a Run Useful in trusted batch pipelines where every approval is expected to pass: ```bash theme={"dark"} duvo runs messages "$RUN_ID" --json \ | jq -r '.messages[] | select(.type=="human_request" and .status=="pending") | .id' \ | xargs -I {} duvo runs respond "$RUN_ID" --approve ``` ### Forward Run output to a script ```bash theme={"dark"} duvo runs messages "$RUN_ID" --json \ | jq -r '.messages[] | select(.role=="assistant") | .content' \ > run-output.log ``` ## Related List and configure the Agents you can start When Runs are kicked off by Cases on a Queue This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.