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 running → completed.

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