# Cady docs

How to use the Cady CLI and the Python SDK. Each page gives the point, one example to run and what can go wrong.

The CLI is not released yet; see [Install the CLI](https://cadyworks.com/docs/install.md).

## CLI

- [Install the CLI](https://cadyworks.com/docs/install.md): One signed script puts `cady` on macOS or Linux.
- [First run: cady setup](https://cadyworks.com/docs/setup.md): Sign in, pick your company and start reporting, in one command.
- [Check this machine: cady status](https://cadyworks.com/docs/status.md): What this machine is attached to, and whether it will report.
- [Choose a company](https://cadyworks.com/docs/company.md): Set the company per project, as a default, or per command.
- [Call Cady from the shell](https://cadyworks.com/docs/commands.md): Read and write company records with commands that mirror Cady’s tools.
- [Run many calls: cady local batch](https://cadyworks.com/docs/batch.md): Run a file of calls in order and stop at the first failure.
- [Report usage: cady sync](https://cadyworks.com/docs/sync.md): One scheduled command reports this machine’s AI usage to your company.
- [Read usage locally](https://cadyworks.com/docs/local-usage.md): See plan allowance and what ran on this machine, without sending anything.
- [Run your own scripts](https://cadyworks.com/docs/scripts.md): Register a script by name, run it on a cadence and keep a journal.
- [Upload files and export CRM data](https://cadyworks.com/docs/files-and-crm.md): Send a local file to Cady Files, and write CRM data to a file.

## Python SDK

- [Python SDK: your first call](https://cadyworks.com/docs/sdk.md): Call Cady from Python with CadyClient.
- [Python SDK: errors and batches](https://cadyworks.com/docs/sdk-errors.md): Four errors tell you whether a call ran, and batch runs many.

## Concepts

- [Your AI app, approvals and companies](https://cadyworks.com/docs/ai-app.md): Connect Claude or ChatGPT, and how approvals apply to every call.
- [Troubleshooting and help](https://cadyworks.com/docs/troubleshooting.md): Exit codes, the common failures and how to reach us.