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

# Check CI jobs from the terminal

> Use the celesto CLI to list your Celesto CI jobs, see what passed or failed, read job logs, and check available runner sizes from your terminal.

Check your CI jobs without leaving your terminal. You can see which jobs passed or failed, read their logs, and see which machine sizes are available. Your coding agent can use the same commands to help you investigate a failed job.

These commands only read information. They don't change, cancel, or rerun jobs.

## Before you start

Install or upgrade the CLI and sign in with your API key:

```bash theme={null}
pip install -U celesto
celesto auth login
```

See the [CLI reference](https://celesto.ai/docs/cloud/cli.md#install-and-sign-in) for more on signing in.

## List your jobs

See your recent CI jobs:

```bash theme={null}
celesto ci jobs list
```

Narrow the list by status, repository, or workflow. For example, show only failed jobs in one repository:

```bash theme={null}
celesto ci jobs list --status failed --repo acme/api
```

## See job details

Use a job ID from the list to see its status, machine size, branch, and a link to the job on GitHub:

```bash theme={null}
celesto ci jobs show <job-id>
```

## Read job logs

Print the logs for a job:

```bash theme={null}
celesto ci logs <job-id>
```

Add `--step` to see the logs for one step only. For example, show step 4:

```bash theme={null}
celesto ci logs <job-id> --step 4
```

## Check runner sizes

See the machine sizes you can use, with their CPU, memory, and disk:

```bash theme={null}
celesto ci runners list
```

Use a size's label in your workflow's `runs-on` line. See [runner sizes](https://celesto.ai/docs/ci/runner-sizes.md) to pick the right one.

## Use the output in scripts and coding agents

Add `--json` to any of these commands to get output that a script or coding agent can read:

```bash theme={null}
celesto ci jobs list --status failed --json
```

If a job never started, use [troubleshooting](https://celesto.ai/docs/ci/troubleshooting.md) to find out what blocked it.


## Related topics

- [Cache dependencies between CI jobs](https://celesto.ai/docs/ci/caching.md)
- [CI benchmarks](https://celesto.ai/docs/ci/benchmarking.md)
- [Troubleshooting](https://celesto.ai/docs/ci/troubleshooting.md)
- [Cache Docker image layers](https://celesto.ai/docs/ci/docker-cache.md)
- [JavaScript and TypeScript](https://celesto.ai/docs/ci/languages/javascript.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.