Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (rungrep) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

rungrep

grep for GitHub Actions runs. Find workflow runs by partial name from your terminal.

Ever scrolled through pages of workflow runs looking for that one build? rungrep lets you search by partial name, filter by branch/status/workflow, and get a direct link to open in your browser.

$ rungrep "deploy api" -r myorg/backend -l
NAME                          DATE                   URL
──────────────────────────────────────────────────────────
deploy api to production v3   2/15/2026, 8:22:45 PM  https://github.com/myorg/backend/actions/runs/22041593851

Install

npm install -g rungrep

Quick start

# Find runs matching "deploy" in a repo
rungrep "deploy" -r org/repo

# Get the latest matching run on main
rungrep "deploy" -r org/repo -b main -l

# Filter by workflow and status
rungrep "deploy" -r org/repo -a "CI" -s success

# Top 5 matching runs
rungrep "deploy" -r org/repo -t 5

# Search runs from last 30 days (default: 7d)
rungrep "deploy" -r org/repo --since 30d

# Open latest matching run in browser
rungrep "deploy" -r org/repo -l --open

# JSON output — pipe to jq, use in scripts
rungrep "deploy" -r org/repo -l --json

Auth

Uses GITHUB_TOKEN env var. Falls back to the GitHub CLI (gh auth token) if installed.

Options

rungrep <name> --repo <org/repo> [options]

Option	Description
`<name>`	Partial run name to match (required)
`-r, --repo <org/repo>`	GitHub repository (required)
`-b, --branch <branch>`	Filter by branch
`-a, --action <workflow>`	Filter by workflow name
`-s, --status <status>`	Filter by run status (see below)
`-t, --top <n>`	Return top N matching runs
`-l, --last`	Return only the latest match
`--since <duration\|date>`	Only search runs newer than duration (`7d`, `24h`, `2w`) or date (`2026-02-01`). Default: `7d`
`--open`	Open the run in browser (requires exactly one match, or combine with `-l`)
`--json`	Output as JSON
`--debug`	Show diagnostic info on stderr

Valid statuses

completed action_required cancelled failure neutral skipped stale success timed_out in_progress queued requested waiting pending

License

MIT