> For the complete documentation index, see [llms.txt](https://docs.computesdk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.computesdk.com/interfaces/quick-start.md).

# CLI

[Install the CLI](https://docs.computesdk.com/start-here/installation.md#cli), then create a sandbox and run a command:

```bash
compute new
compute exec echo hello
```

The CLI guides setup and selects the new sandbox for this directory and organization. `exec` uses that selection, so you do not need to copy an ID. ComputeSDK handles provider setup and routing.

## Destroy the sandbox

```bash
compute destroy
```

A sandbox keeps running and billing until destroyed or its lifetime expires. Closing your terminal does not stop it. Use `compute list` to check for running sandboxes and retry cleanup if needed.

For a single command with automatic cleanup:

```bash
compute run echo hello
```

`run` creates a sandbox, executes the command, then attempts teardown. `--keep` and `--detach` leave compute running.

## Choose a provider

Already know where you want to run? Use a [provider starter](https://docs.computesdk.com/platform/providers.md):

```bash
npm create modal
```

Or, with the CLI installed:

```bash
compute new modal
```

Omit the provider to follow your organization's saved router. See [routing](https://docs.computesdk.com/platform/routing.md) for preferences and fallback.

## Next steps

* [Run commands and follow output](https://docs.computesdk.com/sandboxes/commands.md)
* [Work with files](https://docs.computesdk.com/sandboxes/files.md) or [sync a project](https://docs.computesdk.com/interfaces/quick-start/project-sync.md)
* [Preview an application](https://docs.computesdk.com/sandboxes/previews.md)
* [Reconnect and manage sandbox lifetime](https://docs.computesdk.com/sandboxes/lifecycle.md)
* [Use JSON output in scripts and agents](https://docs.computesdk.com/interfaces/quick-start/automation.md)
* [CLI command reference](https://docs.computesdk.com/platform/cli.md)

If creation cannot be placed, inspect `compute sandboxes options` and `compute sandboxes route`. See [billing](https://docs.computesdk.com/platform/billing.md) for credits or [authentication](https://docs.computesdk.com/platform/authentication.md) for noninteractive access.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.computesdk.com/interfaces/quick-start.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
