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

# CLI overview

> The lazycloud command: global flags, handler references, and command groups.

The `lazycloud` command installs with the `lazycloud-client` Python package. See
[Installation](/getting-started/installation). Sign in once with
`lazycloud login`, as described in [Sign-in and tokens](/platform/auth).

```text theme={null}
uv run lazycloud [--json] [--debug] COMMAND [ARGS]...
```

`--json` prints one JSON document to stdout for scripting. Progress goes to
stderr. An error prints one JSON error document and exits nonzero. Log-follow
commands print newline-delimited JSON, one record per event. The interactive
commands `shell`, `dev`, and `serve` reject `--json`. `--debug` shows full
tracebacks. `-h` or `--help` works on every command.

Without `--json`, output is for humans. The CLI drops styling when you redirect
output.

[Develop, test, deploy](/concepts/workflow) explains when `run`, `serve`, and
`deploy` each fit.

## Handler references

Commands that take a `HANDLER` use `module:object`, resolved from your project
root:

* `quickstart:hello` selects `hello` in `quickstart.py`.
* `myproject.api:app` selects `app` in `myproject/api.py`.

Dots separate directory names, and `.py` is omitted. A file reference such as
`quickstart.py:hello` also works and resolves to the same handler.

The object is one decorated resource or an `App`. Deploying an `App` deploys
everything it registers. Referencing one workload's Python object, for example
`page_stats:analyze`, deploys only that workload.

`deploy` also accepts a module without `:object`, such as
`uv run lazycloud deploy quickstart`, when the module contains exactly one app.
It deploys everything registered with that app. When the module has several
apps, `module:app_name` selects one.

## Command groups

| Commands                                               | Reference                                               |
| ------------------------------------------------------ | ------------------------------------------------------- |
| `deploy`, `run`, `serve`, `shell`, `dev`               | [Deploy and run](/cli/deploy-and-run)                   |
| `task`, `logs`                                         | [Tasks and logs](/cli/tasks-and-logs)                   |
| `app`, `deployment`, `container`                       | [Apps and deployments](/cli/deployments-and-containers) |
| `volume`, `ls`, `cp`, `rm`, `mv`, `secret`, `artifact` | [Storage](/cli/storage)                                 |
| `compute`, `cloud`, `machine`, `domain`                | [Compute and domains](/cli/compute)                     |
| `login`, `workspace`, `profile`, `token`               | [Sign-in](/cli/auth)                                    |
| `example`                                              | [Download projects](/cli/scaffolding)                   |