---
title: "checks"
description: "catcli checks — show how many of today's checks are used and left on the Starter plan, without running anything."
url: "https://docs.justcat.it/reference/cat-cli/checks/"
---
# checks


## Synopsis

```
catcli checks [-l <level>] [-q]
```

## Options

| Short | Long | Value | Meaning |
|-------|------|-------|---------|
| `-l` | `--loggingLevel` | level | `Error` (default), `Information`, `Debug`, … — see [Logging](https://docs.justcat.it/reference/cat-cli/introduction/#logging "Logging"). |
| `-q` | `--quiet` | | Suppress the "working offline" notice; refusals are never suppressed. |

## What it does

Signs in the way every verb does (see [Sign-in, plans and the license key](https://docs.justcat.it/reference/cat-cli/introduction/#sign-in-plans-and-the-license-key "Sign-in, plans and the license key")), then reads the count of the Starter plan's [checks per day](https://docs.justcat.it/reference/basics/checks-per-day/ "Checks per day (Starter plan)"). It needs no project and takes nothing off the count. An AI agent can ask it before a large run.

## Output

| Situation | What it prints | Exit code |
|---|---|---|
| Starter plan, CAT Portal answered | `Checks today: 380 of 500 used, 120 left. The limit resets at midnight (in 5 h 12 min).` | `0` |
| Starter plan, CAT Portal unreachable | `Checks today on this machine: 190 of 500 used, 310 left (CAT Portal could not be reached). The limit resets at midnight (in 5 h 12 min).` | `0` |
| Starter plan, CAT can reach neither CAT Portal nor its count on this computer | `CAT cannot reach CAT Portal and has no record of today's checks on this machine. Connect to the internet and run the tests again.`, on standard error | `7` |
| Starter plan, the count cannot be read at this moment | `The count of today's checks could not be read. Try again in a moment.` | `0` |
| Team and Enterprise plans | `Your plan has no daily limit of checks.` | `0` |

The line is the same one [`run`](https://docs.justcat.it/reference/cat-cli/run/ "run") prints after a run on the Starter plan.

## Exit code

`0` when the count, or the fact that there is none, was printed. `7` on the Starter plan when CAT can reach neither CAT Portal nor its count on this computer. Codes `2`–`8` from the sign-in and plan check as for every verb — see [Exit codes](https://docs.justcat.it/reference/cat-cli/introduction/#exit-codes "Exit codes").

## Examples

```
# on the Starter plan: how many checks are left today?
catcli checks
```

## Related

- [Checks per day (Starter plan)](https://docs.justcat.it/reference/basics/checks-per-day/ "Checks per day (Starter plan)").
- [run](https://docs.justcat.it/reference/cat-cli/run/ "run").