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

# Use the CLI, MCP, and REPL

> Install the Aside CLI and connect browser automation tools.

# Use developer tools

Aside includes a command-line interface (CLI), Model Context Protocol (MCP) support, and a browser automation REPL.

## Install the CLI

The developer settings page shows this install command:

```bash theme={null}
curl -fsSL https://releases.aside.com/install.sh | bash
```

The settings page can also install, update, or reinstall the CLI directly.

## Run a browser task

Use `aside` to start a browser agent session from the terminal:

```bash theme={null}
aside "Open localhost:3000 and run a smoke test"
```

Use `--session` to continue an existing session:

```bash theme={null}
aside --session <session-id> "Continue"
```

## Manage accounts

If you are signed in to more than one Aside account, each CLI command runs under one selected account. Use the `account` commands to inspect, switch, or target accounts from the terminal.

List the accounts available on this device. The current account is marked with `*`:

```bash theme={null}
aside account list
```

Show the current account, or check a specific one by ID:

```bash theme={null}
aside account status
aside account status u1
```

Set the default account for future commands:

```bash theme={null}
aside account use u1
```

Target a single run at a specific account with the `--account` flag. It works on `aside` and on `aside exec`:

```bash theme={null}
aside --account u1 "Summarize the current page"
aside exec --account u1 -m openai-codex/gpt-5.5 "Plan this workflow"
```

If the selected account is signed out, the CLI prints a warning explaining how to recover. Your own provider keys (OpenAI, Anthropic) keep working, but built-in Aside models require an active sign-in. Sign in again from **Aside Settings > Account**, or switch to a signed-in account with `aside account use <id>` or `--account <id>`.

## Use MCP

Use `aside mcp` to connect Aside to another agent or coding tool as a Model Context Protocol server.

```bash theme={null}
aside mcp
```

For clients that support `mcp.json`, add:

```json theme={null}
{
  "mcpServers": {
    "aside": {
      "command": "aside",
      "args": ["mcp"]
    }
  }
}
```

If Developer settings found a concrete CLI path, use that path for `command`.

Aside can install browser automation setup for supported coding tools. Developer settings also describe MCP setup for tools that support `mcp.json`.

## Use the REPL

Use `aside repl` for browser automation REPL tasks:

```bash theme={null}
aside repl "const p = await openTab('https://example.com')"
```

Use the REPL when you need direct page inspection, screenshots, downloads, or deterministic browser steps.

## Related

* [Run tasks](/help/tasks)