Skip to main content
← Back to list
01Issue
FeatureShippedSwamp CLIPublicTeam
Assigneesstack72

Relationships

#1826 swamp workflow history search: add --workflow filter flag

Opened by aaronge · 8/25/2026· Shipped 8/25/2026

Problem

`swamp workflow history search` has no way to filter results to a single workflow's runs by name. Every other run-listing surface that supports scoping to a workflow uses a first-class `--workflow ` flag (e.g. `swamp data list --workflow `), but `history search` doesn't follow that pattern.

Concretely: I built a small `apt-status` dashboard script wrapping `swamp workflow history search --json` to show recent runs of one specific workflow (`apt-report`) among potentially many workflows in a repo. Without a `--workflow` flag, I had to fetch all history and filter client-side in the script, rather than letting the CLI do it.

Proposed solution

Add a `--workflow ` option to `swamp workflow history search`, consistent with the `--workflow` filter already supported by `swamp data list`. Under the hood this could map to the same predicate as `swamp data list --workflow ` (i.e. `workflowName == ""`).

Alternatives considered

  • Client-side filtering of the full `--json` output (what I'm doing now) — works, but pushes an obvious CLI-level filtering concern into every caller's own script instead of the CLI itself.
  • Using `swamp data list --workflow ` instead of `history search` — doesn't give the same run-level fields (status, failedStep, failureReason, triggerSource) that `history search` returns, so it's not a substitute for this use case.
02Bog Flow
OPENTRIAGEDIN PROGRESSSHIPPED+ 1 MOREASSIGNED+ 2 MOREREVIEW+ 9 MOREPR_MERGED+ 2 MORESESSION_SUMMARIZED

Shipped

8/25/2026, 11:43:00 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack728/25/2026, 11:06:43 PM
Editable. Press Enter to edit.

stack72 commented 8/25/2026, 11:43:09 PM

Thanks @aaronge for reporting this! The fix has been merged and a release is on its way. We appreciate your contribution to swamp.

Sign in to post a ripple.