# CLI overview

Use the purrkey executable to discover tools, make account-balance calls and recover results.

## Commands

> Use purrkey --help and purrkey <command> --help for your installed version. There are no CLI runs list or keys activate commands in this interface.

| Command | Purpose |
| --- | --- |
| purrkey version | Print the installed version. |
| purrkey keys add | Verify and save an API key. |
| purrkey config | Configure credentials using hidden input or stdin. |
| purrkey tools | Read the accessible tool directory. |
| purrkey discover | Find candidate tools by capability. |
| purrkey inspect | Read a tool's schema, price and limitations. |
| purrkey balance | Read available funds and reservations. |
| purrkey run | Submit or recover a saved request. |
| purrkey get-run | Retrieve an original Run. |
| purrkey cancel-run | Request cancellation of an original Run. |

## JSON output

Tool commands print JSON and preserve exact integer values. Use --output <file> to save the full response locally. On macOS and Linux the file uses owner-only permissions; on Windows, access depends on the directory permissions because the CLI does not configure a private Windows ACL. Read result.status and billing before interpreting output.

```
purrkey balance --output balance.json
purrkey tools --output tools.json
```

## Choose a reference

- [Configuration](/docs/cli/configuration): API keys, environment variables and origin selection.
- [Discover and inspect](/docs/cli/discover): Tool selection commands and flags.
- [Run a tool](/docs/cli/run): Request files, waits and output.
- [Retrieve and cancel](/docs/cli/results): Work with the original Run ID.