> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peak.inc/llms.txt
> Use this file to discover all available pages before exploring further.

# Check runs

> Find a Peak job, read its logs, and check runner cleanup.

## Before you start

Connect your GitHub organization.
Keep access to the private repository through the Peak GitHub App.
Run a job on Peak.

## Check from your terminal

Sign in with run history access.

```bash theme={null}
npx -y @peakinc/cli@latest login --runs
npx -y @peakinc/cli@latest runs list --json
```

Sign in again with run access if your current token only has workspace access.

Filter by a numeric GitHub repository ID, branch, status, or architecture.

```bash theme={null}
npx -y @peakinc/cli@latest runs list \
  --repository 123456789 --branch main \
  --status completed --architecture x64 --limit 25 --json
```

Use one of these status values.

```text theme={null}
in_progress
completed
```

Use one of these architecture values.

```text theme={null}
x64
arm64
```

Pass the returned cursor to read the next page with the same filters.

```text theme={null}
--after NEXT_CURSOR
```

Copy the Peak run ID from the list to read one job.

```bash theme={null}
npx -y @peakinc/cli@latest runs view PEAK_RUN_ID --json
```

## Check in the console

Open [Runs](https://app.peak.inc/app/runs).
Filter by repository, branch, status, or architecture.
Open a job to check its commit, attempt, runner, and timestamps.
Choose GitHub logs to read the job output.
Refresh the page for updated results.

Check queued jobs in GitHub Actions.
Use Peak run history for recorded Peak executions.

## Check completion and cleanup

Check the job result and Runner state separately.
After the job completes, check for Released and a release time.
Do not treat a passed job as proof that runner cleanup is done.

Read Duration as the elapsed time between the job's start and completion.
Use GitHub logs if a timestamp is missing.
Do not treat elapsed time as a bill.
Use the current pilot without usage metering or minute credits.

If a run is missing, check your filters and current GitHub access.
Reconnect GitHub in Settings if asked.
