Skip to main content
← Back to list
01Issue
FeatureOpenSwamp CLI
AssigneesNone

Relationships

#1081 workflow history logs --follow for live-tailing running workflows

Opened by stack72 · 7/10/2026

Context

swamp workflow history logs currently reads the log file once and yields a single completed event. The --tail N flag shows the last N lines but does not stream.

For long-running workflows (parallel fan-outs, batch processors), users need to attach to a running workflow's log stream from any shell — the same way docker logs -f or tail -f work.

Proposed

Add a --follow / -f flag to swamp workflow history logs that:

  1. Streams log lines as they're written while the workflow run is in progress
  2. Exits cleanly when the run completes (or is cancelled)
  3. Works through --server (swamp serve) so you can tail from any machine

This should compose with --tail N — e.g. --tail 50 --follow shows the last 50 lines then continues streaming.

Why

This was the last remaining piece from #519 (persistent, queryable workflow runs). Everything else from that issue — status, cancel, history list, and one-shot log viewing — is now implemented. Live log streaming closes the loop on "terminal death loses your view" by letting users reconnect to a running workflow's output from any shell.

02Bog Flow
OPENTRIAGEDIN PROGRESSSHIPPED

Open

7/10/2026, 11:50:53 PM

No activity in this phase yet.

03Sludge Pulse

Sign in to post a ripple.