Skip to content

v0.20.0

Choose a tag to compare

@github-actions github-actions released this 20 Mar 06:37
· 104 commits to main since this release

gh CLI Compatible Output

This release aligns actrun's CLI output format with GitHub's gh CLI, making it easy to reuse scripts and workflows between local and remote CI.

JSON Output

  • --json <fields> on all commands: run view, run list, workflow list, cache list, artifact list
  • gh-compatible field names: workflowName, headBranch, headSha, event, number, attempt, startedAt, completedAt (ISO 8601)
  • status / conclusion fields at top-level and per-job (matching gh semantics: status=completed, conclusion=success|failure)
  • Job records now include name, conclusion, and embedded steps array
# Works just like gh:
actrun run view run-1 --json status,conclusion,jobs
actrun run list --json workflowName,event,startedAt --limit 5

run view Enhancements

  • -v / --verbose: Show job steps (like gh run view -v)
  • --log: Show full logs (like gh run view --log)
  • --log-failed: Show only failed step logs (like gh run view --log-failed)
  • -j / --job <id>: Filter by job ID
  • --exit-status: Exit with non-zero status if run failed
X ci (run-1) success in 2s

JOBS
  X build (success)
    X Checkout (success)
    X Test (success)

run list Filters

  • -s / --status <status>: Filter by status/conclusion
  • -w / --workflow <name>: Filter by workflow name
  • -b / --branch <name>: Filter by branch
  • -e / --event <type>: Filter by event type
  • -L / --limit <n>: Limit results
actrun run list --status failure --workflow ci --limit 5

New Commands

  • run delete <run-id>: Delete a workflow run

Other

  • cache list now supports --limit / -L and --json <fields>
  • run list text output now shows status, conclusion, workflow, mode, elapsed time
  • Updated cheatsheets with all new features
  • 615 tests passing