# alineo stop
URL: /docs/cli/commands/stop

Stop a sandbox by ID.



```bash
bunx alineo-cli stop <sandbox-id>
```

## Arguments [#arguments]

| Argument     | Description                                                                                        |
| ------------ | -------------------------------------------------------------------------------------------------- |
| `sandbox-id` | The sandbox ID, as shown by `alineo agents` or printed by `alineo start`/`alineo spawn`. Required. |

## What it does [#what-it-does]

Connects to the sandbox via a live control-plane check (the same authoritative liveness check `alineo prompt` uses — see [Why sandbox ID, not name](/docs/cli/commands/prompt#why-sandbox-id-not-name)) and closes it, deleting the container and releasing its resources.

## Example [#example]

```bash
bunx alineo-cli stop 4af65c3b-24a2-4fd1-999d-918faa9b97fd
```

```
Stopped sandbox 4af65c3b-24a2-4fd1-999d-918faa9b97fd
```

## Notes [#notes]

* `stop` only stops the sandbox it's given — it does not recursively stop any children that sandbox may have created via `alineo spawn`. Stop each one individually, or check `alineo agents` for the full list including untracked (agent-spawned) sandboxes.
* If the sandbox is already stopped or never existed, the underlying live check fails and `stop` errors out rather than silently succeeding.