Skip to main content

​
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: 
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: 
aside "Open localhost:3000 and run a smoke test"
Use --session to continue an existing session: 
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 *: 
aside account list
Show the current account, or check a specific one by ID: 
aside account status
aside account status u1
Set the default account for future commands: 
aside account use u1
Target a single run at a specific account with the --account flag. It works on aside and on aside exec: 
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. 
aside mcp
For clients that support mcp.json, add: 
{
  "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: 
aside repl "const p = await openTab('https://example.com')"
Use the REPL when you need direct page inspection, screenshots, downloads, or deterministic browser steps.