The agent-first CLI for GitHub Actions
The CLI for StarSling Runners. Diagnose a failed job, rank your slowest workflows, and see what CI costs, without leaving the terminal.
What sling CLI does
Diagnose
- sling why
- Diagnose why a job failed, with evidence and next steps
- sling time
- Decompose CI wall-clock into runner-lifecycle phases
Cost and capacity
- sling top
- Rank the biggest time and cost hotspots, with a trend
- sling usage
- Attribute runner minutes and usage cost over a window
- sling bill
- See what you owe so far and the month-end projection
- sling bill history
- List prior finalized billed invoices
- sling labels list
- Compare runner sizes and per-minute cost for runs-on
Inspect CI
- sling runs list
- Find workflow runs by branch, status, conclusion, or trigger
- sling runs show
- See which job in a run failed, or wait for it to finish
- sling jobs list
- List jobs in a run, or across a repo
- sling jobs show
- See which step in a job failed, and how long each took
- sling logs
- Read just the log lines you need, not the whole transcript
- sling resolve
- Resolve an id or GitHub Actions URL to its target
Auth and setup
- sling login
- Sign in via the GitHub device authorization flow
- sling logout
- Sign out and clear the stored credential and preferences
- sling whoami
- View your identity, organizations and credential
- sling doctor
- Check your environment and know what is broken
- sling org switch
- Set the organization other commands use by default
Every flag, every exit code and the JSON each command emits are in the sling CLI reference.
sling is a client for StarSling's HTTP API: the same runs, jobs, logs, labels, usage and billing endpoints these commands call, generated from the OpenAPI spec. Reach for it when you want the data somewhere the terminal is not, like a dashboard or a bot of your own. HTTP API reference (opens in new tab).
Made to sit beside gh
gh is GitHub's own command-line tool for working with GitHub from a terminal, and it is already on most machines that touch GitHub Actions. sling is the layer above it: gh lists and acts on your workflows, and sling reads them and tells you what happened, what it took and what it cost. sling is the perfect companion to the GitHub CLI, which is why we bring the two together in the /sling skill.
sling reads and analyzes
StarSling's CLI
- Why a job failed, with the evidence behind the call
- Where a run's wall-clock actually went
- Which workflow to fix first, ranked with a trend
- What CI costs, attributed per repo
- Just the log lines that matter
gh lists and acts
GitHub's official CLI
- Trigger a workflow
- Re-run a job
- Cancel a run
- Enable or disable a workflow
- Download an artifact
Teach your agent when to use the CLI with /sling
The skill is one document your agent reads once. It carries the routing rule below, the command surface of both CLIs, and the checks that run before the first command.
- Live CI
- sling reads your live CI: the runs, jobs, logs and spend in your organization. ci-score, ci-speedup and ci-secure read the workflow files in your checkout.
- Preflight
- Before the first command runs, the skill confirms the CLI is installed, that you are signed in, and that the StarSling GitHub App is installed on the organization you are asking about.
- Pinned command surface
- The skill ships a capture of sling's real commands, flags and exit codes, taken from the binary, so your agent calls the commands the CLI exposes and branches on the codes it returns.
You ask your agent about CI
Does it change state?
Re-run a job, cancel a run, trigger a workflow, turn one on, pull down an artifact.
answered by gh
- gh run rerun
- gh run cancel
- gh workflow run
- gh run download
Is it one run, one job, or the spend?
Why it failed, where the wall-clock went, which workflow to fix first, what the month costs.
answered by sling
- sling why
- sling time
- sling logs --grep
- sling top
- sling usage
Is it the workflow files themselves?
Grade the configuration, rank the speed wins, close the attack paths.
answered by the CI skills
- /ci-score
- /ci-speedup
- /ci-secure
You get one terminal that answers everything, whether you are typing or your agent is.
Install it once and your agent follows this rule for every CI question you ask.
Get sling running.
The CLI for StarSling Runners. Diagnose a failed job, rank your slowest workflows, and see what CI costs, without leaving the terminal.
View docs (opens in new tab)Don’t want to run it each time? StarSling’s agents keep reviewing your workflows and open the PRs you review as your CI changes.
Get StarSlingGet the StarSling app