Skip to content

flows status --cloud / flows logs: show running steps, add --watch and --follow #540

Description

@khaliqgant

Problem

flows status --cloud and flows logs are the user-facing way to inspect a hosted run, but they are built for finished runs.

Proposal

  1. flows status --cloud: render running, backoff, waiting and needs_human steps from Cloud's live snapshot, in the same grammar as the local flows status (↻ agent-5 (agent) running attempt 1/1 6m50s).
  2. flows status --cloud --watch: redraw on an interval until the run is terminal, then print the final page once.
  3. flows logs <run> --follow: poll and append new runner-output lines until the run is terminal. Since cloud#3918, runner output includes one line per step transition ([relayflow] ▶ agent-5 (agent) started, ✓ agent-1 … done in 5m16s · claude-opus-5 · 37 turns · $2.26 · wrote plan.md), so following it is useful even before live snapshots exist.

Acceptance

  • --follow and --watch exit 0 when the run ends in success, and non-zero otherwise, using the same exit mapping as flows run.
  • Both handle Ctrl-C cleanly and never print a partial frame.
  • Tests use fake Cloud responses for a run that transitions runningcompleted.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    garden-readyScoped and ready for an agent to pick up

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions