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

# anona-compute

> Manage Anona Compute sandboxes from the terminal

```text
anona-compute manages Anona Compute sandboxes through the E2B-compatible API.

Configuration comes from flags, then the environment (the API key from
ANONA_COMPUTE_API_KEY, then ANONA_API_KEY when it holds an ac_ or e2b_ key,
then E2B_API_KEY; ANONA_COMPUTE_DOMAIN or E2B_DOMAIN, ANONA_COMPUTE_API_URL or
E2B_API_URL), then the profile in $XDG_CONFIG_HOME/anona-compute/config.toml.
anona-compute doctor checks the whole chain.

JSON output:
  --json (or -o json) prints JSON on stdout. A list command (list, ps,
  template list, config list) prints one array, [] when there is nothing to
  list; other commands print one object per line. Every key is
  snake_case (sandbox_id, template_id, cpu_count, api_url), as in the MCP
  server's tools; keys inside metadata, envs and log fields are yours and are
  printed as given. An error is one object on stderr:
    {"error":{"message":"...","exit_code":N,"status":404,
              "error_code":"...","request_id":"..."}}
  status, error_code and request_id appear when known; a failure with no
  HTTP answer has error_code "network_error" or "timeout".

Exit codes:
  0    success
  1    general error
  2    usage error (bad flag, argument or value)
  3    not signed in, or the credential was refused (HTTP 401/403)
  4    not found (HTTP 404)
  5    plan limit or rate limit (HTTP 429, or error_code plan_limit_exceeded)
  exec and run pass the remote command's exit status through unchanged
  (0-255; 130 after Ctrl-C) and exit 125 when anona-compute itself failed,
  for any of the reasons 1-5 above; their --json error keeps that detailed
  code in "cli_code".
```

## Usage

```text
anona-compute [flags]
anona-compute [command]
```

## Commands

| Command | Description |
| - | - |
| [`config`](/docs/cli/reference/config) | Read and write profile settings |
| [`connect`](/docs/cli/reference/connect) | Open an interactive shell in a sandbox |
| [`create`](/docs/cli/reference/create) | Create sandboxes |
| [`delete`](/docs/cli/reference/delete) | Delete sandboxes |
| [`desktop`](/docs/cli/reference/desktop) | Open a sandbox desktop |
| [`doctor`](/docs/cli/reference/doctor) | Check the configuration, credentials and connection to Anona Compute |
| [`exec`](/docs/cli/reference/exec) | Run a command in a sandbox |
| [`fork`](/docs/cli/reference/fork) | Fork a running sandbox into new sandboxes |
| [`idle-pause`](/docs/cli/reference/idle-pause) | Pause a sandbox once nothing has used it for a while |
| [`info`](/docs/cli/reference/info) | Show one sandbox |
| [`keys`](/docs/cli/reference/keys) | Manage API keys (not available yet) |
| [`limits`](/docs/cli/reference/limits) | Show plan limits and usage (not available yet) |
| [`list`](/docs/cli/reference/list) | List sandboxes |
| [`login`](/docs/cli/reference/login) | Sign in through the browser (or save an API key with --with-api-key) |
| [`logout`](/docs/cli/reference/logout) | Sign out: revoke the CLI session on the dashboard and remove local credentials |
| [`logs`](/docs/cli/reference/logs) | Show sandbox logs |
| [`mcp`](/docs/cli/reference/mcp) | Run an MCP server so AI agents can use Anona Compute |
| [`output`](/docs/cli/reference/output) | Print the output of a command started with exec --background |
| [`pause`](/docs/cli/reference/pause) | Pause a sandbox |
| [`preview`](/docs/cli/reference/preview) | Share a sandbox port with a signed preview link |
| [`ps`](/docs/cli/reference/ps) | List the processes running in a sandbox |
| [`push`](/docs/cli/reference/push) | Push a git working tree into a sandbox (not available yet) |
| [`recover`](/docs/cli/reference/recover) | Recover a sandbox from its last snapshot (not available yet) |
| [`rename`](/docs/cli/reference/rename) | Name a sandbox, or remove its name |
| [`resume`](/docs/cli/reference/resume) | Resume a paused sandbox |
| [`run`](/docs/cli/reference/run) | Create a sandbox, run one command, then delete the sandbox |
| [`sandbox`](/docs/cli/reference/sandbox) | Sandbox commands (same as the top-level create, list, info, ...) |
| [`scp`](/docs/cli/reference/scp) | Copy files to or from a sandbox over SSH |
| [`ssh`](/docs/cli/reference/ssh) | SSH into a sandbox |
| [`template`](/docs/cli/reference/template) | Build and manage templates |
| [`timeout`](/docs/cli/reference/timeout) | Set how long a sandbox lives from now |
| [`usage`](/docs/cli/reference/usage) | Show usage and cost for a billing period |
| [`vault`](/docs/cli/reference/vault) | Store credentials the sandbox never sees |
| [`version`](/docs/cli/reference/version) | Print the CLI version |
| [`view`](/docs/cli/reference/view) | Open a live view of a sandbox |
| [`whoami`](/docs/cli/reference/whoami) | Show who the CLI is signed in as |

## Flags

| Flag | Type | Description |
| - | - | - |
| `--api-key` | string | API key (env ANONA\_COMPUTE\_API\_KEY, ANONA\_API\_KEY, E2B\_API\_KEY) |
| `--api-url` | string | API URL (env ANONA\_COMPUTE\_API\_URL, E2B\_API\_URL; default [https://api.\&lt;E2B\_DOMAIN](https://api.\&lt;E2B_DOMAIN)>) |
| `--help`, `-h` | | help for anona-compute |
| `--json` | | JSON output on stdout (same as -o json) |
| `--output`, `-o` | string | output format: text or json (default "text") |
| `--profile` | string | config profile to use (env ANONA\_COMPUTE\_PROFILE; default "default") |
| `--request-timeout` | duration | timeout for each API request (0 = none) |
| `--verbose`, `-v` | | verbose output on stderr |
| `--version` | | print the CLI version (same as the version command) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.