Quickstart

Get Runless set up in under 5 minutes. No workflow changes required.

Step 1: Sign In with GitHub

Go to runless.dev (opens in a new tab) and click Sign in with GitHub. We'll ask for permission to:

Read your profile (to create your account)
Read organization membership (to set up teams)

We never ask for write access to your code.

Step 2: Install the GitHub App

After signing in, you'll be prompted to install the Runless GitHub App. You can install it on:

All repositories in an organization
Select repositories if you want to start small

The app will request these permissions:

actions: read - To receive workflow run events
metadata: read - To list repositories and workflows

💡

Alternative: Want to try Runless without installing the app? You can add public repositories instead. Great for evaluating Runless on open source projects.

Step 3: Wait for Data Sync

Once installed, Runless will:

Start receiving webhook events for new runs immediately
Fetch historical run data from the last 30 days
Process and analyze the data

This usually takes 2-5 minutes depending on how many runs you have.

You'll see a progress indicator on the importing page. You can navigate away — the sync continues in the background.

Step 4: Explore Your Dashboard

Once data is synced, you'll land on the Overview dashboard showing:

KPIs: Total runs, success rate, failure rate, re-run rate, duration p50/p95
Trend Charts: Duration over time, re-run rate, run outcomes
Detections: Automatically identified issues with your CI
Workflow Rankings: Most expensive, most re-runs, most failures

What's Next?

Introduction Installation