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

# CLI command reference

> A compact index of the Aient CLI 0.7.0 commands and global flags.

# CLI command reference

This page indexes the commands shipped in Aient CLI 0.7.0. Use `aient COMMAND --help` for the flags supported by your installed version.

## Authentication

| Command                            | Purpose                                                   |
| ---------------------------------- | --------------------------------------------------------- |
| `aient auth login`                 | Sign in through browser OAuth.                            |
| `aient auth status`                | Verify and display the selected login.                    |
| `aient auth logout`                | Revoke and remove the selected login.                     |
| `aient auth profiles`              | List named non-secret profile metadata.                   |
| `aient auth profiles default NAME` | Set the fallback customer profile.                        |
| `aient auth export`                | Deliberately export a short-lived access-only credential. |

See [Authentication and project profiles](/ai-tools/cli/authentication).

## Sandboxes

| Command                                        | Purpose                                              |
| ---------------------------------------------- | ---------------------------------------------------- |
| `aient sandbox list`                           | List visible sandboxes.                              |
| `aient sandbox create`                         | Create a retained sandbox.                           |
| `aient sandbox status SANDBOX`                 | Show sandbox state.                                  |
| `aient sandbox wait SANDBOX`                   | Wait for readiness.                                  |
| `aient sandbox sync SANDBOX [LOCAL_WORKSPACE]` | Synchronize exact Git and selected extra-file state. |
| `aient sandbox run -- COMMAND...`              | Create, run, and clean up a disposable sandbox.      |
| `aient sandbox exec SANDBOX -- COMMAND...`     | Run a supervised command in a retained sandbox.      |
| `aient sandbox shell SANDBOX`                  | Open a new interactive shell.                        |
| `aient sandbox logs SANDBOX`                   | Read a bounded sandbox runtime log snapshot.         |
| `aient sandbox delete SANDBOX`                 | Delete a sandbox.                                    |

See [Run and synchronise workspaces](/ai-tools/cli/run-and-sync) and [Retained sandbox lifecycle](/ai-tools/cli/retained-sandboxes).

<Warning>
  In 0.7.0, an environment-bound customer sandbox can be reused only through selector-bearing `exec` and `execution` commands, found with `list --environment`, and removed by its owner with `delete`. `sync`, `files`, `shell`, `status`, `wait`, and `logs` apply only to sandboxes without an environment binding. Start a fresh `run --keep` to transfer changed customer workspace state.
</Warning>

## Environment secrets

| Command                                                        | Purpose                                          |
| -------------------------------------------------------------- | ------------------------------------------------ |
| `aient environment secrets set --environment ENV NAME --stdin` | Set or replace one encrypted environment secret. |

See [Environment secrets](/ai-tools/cli/environment-secrets). Only current organisation owners and administrators can set secrets.

## Supervised executions

| Command                                            | Purpose                                   |
| -------------------------------------------------- | ----------------------------------------- |
| `aient sandbox execution attach SANDBOX EXECUTION` | Receive new live output.                  |
| `aient sandbox execution status SANDBOX EXECUTION` | Read content-free current state.          |
| `aient sandbox execution wait SANDBOX EXECUTION`   | Wait for a content-free terminal outcome. |
| `aient sandbox execution cancel SANDBOX EXECUTION` | Cancel the exact execution.               |

See [Executions, output, and files](/ai-tools/cli/executions-and-files).

Repeat the original `--environment` and `--repository` selectors on every execution observation or cancellation of an environment-bound customer command.

## Explicit files

| Command                                                                | Purpose                       |
| ---------------------------------------------------------------------- | ----------------------------- |
| `aient sandbox files put SANDBOX LOCAL_PATH ABSOLUTE_REMOTE_DIRECTORY` | Upload one file or directory. |
| `aient sandbox files get SANDBOX ABSOLUTE_REMOTE_FILE LOCAL_PATH`      | Download one file.            |
| `aient sandbox files ls SANDBOX [ABSOLUTE_REMOTE_DIRECTORY]`           | List a directory.             |
| `aient sandbox files rm SANDBOX ABSOLUTE_REMOTE_PATH`                  | Remove a path.                |

## Utility commands

| Command                 | Purpose                                       |            |       |                            |
| ----------------------- | --------------------------------------------- | ---------- | ----- | -------------------------- |
| `aient version`         | Print version, source commit, and build time. |            |       |                            |
| \`aient completion bash | fish                                          | powershell | zsh\` | Generate shell completion. |
| `aient help [COMMAND]`  | Show help.                                    |            |       |                            |

## Global customer flags

| Flag                       | Meaning                                                                               |
| -------------------------- | ------------------------------------------------------------------------------------- |
| `--profile NAME`           | Select a named customer profile.                                                      |
| `--access-token-file PATH` | Read one mode-`0600` access-only JSON envelope.                                       |
| `--timeout DURATION`       | API request budget; for `sandbox exec`, also the remote command budget. Default `5m`. |
| `--verbose`                | Print safe request metadata and detailed progress.                                    |
| `--version`, `-v`          | Print version information.                                                            |
| `--help`, `-h`             | Show help.                                                                            |