checks
On the Starter plan, shows how many of today's 500 checks are used and how many are left. It runs nothing and uses no check.
Synopsis
catcli checks [-l <level>] [-q]
Options
| Short | Long | Value | Meaning |
|---|---|---|---|
-l |
--loggingLevel |
level | Error (default), Information, Debug, … — see 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), then reads the count of the Starter plan’s checks per day. 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 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.
Examples
# on the Starter plan: how many checks are left today?
catcli checks