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

# Open a terminal from the CLI

> Open an interactive terminal on a running project or a sandbox with brimble ssh.

`brimble ssh` opens an interactive terminal on a running project or a sandbox, in your own terminal.

```bash theme={null}
brimble ssh my-api
brimble ssh --sandbox my-sandbox
```

The session streams input and output and follows your terminal size. Web-service and worker projects have a shell. Static sites, MCP servers, and databases don't, so they can't be targeted.

## Pick a project or a sandbox

With no argument, `brimble ssh` shows a picker of your projects and sandboxes. Pass a name or ID to skip it:

```bash theme={null}
brimble ssh                       # pick from projects and sandboxes
brimble ssh my-api                # a project by name or ID
brimble ssh --sandbox my-sandbox  # a sandbox by name or ID
```

Start in a specific directory with `--cwd`:

```bash theme={null}
brimble ssh my-api --cwd /app
```

## Leave the session

Press Ctrl+D, type `exit`, or press `~.` at the start of a line. The `~` escape only applies at the start of a line, so a command like `ls ~/src` sends the tilde through unchanged. `~~` sends a literal `~`.

The session needs a real terminal. In a script or a pipe, the command exits with an error instead of running.


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