smooth-browser

# Smooth Browser

Smooth is a CLI browser for AI agents to interact with websites, authenticate, scrape data, and perform complex workflows.

## Prerequisites

!`out="$(smooth config --show 2>&1)"; echo "$out" | grep -q "No configuration found" && printf 'There is no API key configured yet. User (or you on their behalf) must set the API key with:\n\n```bash\nsmooth config --api-key YOUR_API_KEY\n```\n\nThis will save the API key for all future commands.\n' || printf 'API key is already set in the config file.\n\n%s\n\nIf you need to change it, user (or you on their behalf) can change API key with:\n\n```bash\nsmooth config --api-key YOUR_API_KEY\n```\n\nThis will save the API key for all future commands.\n' "$out"`

## Basic Workflow

### 1. Create a Profile (Optional)

Profiles are useful to persist cookies, login sessions, and browser state between sessions.

```bash
smooth create-profile --profile-id "my-profile"
```

List existing profiles:
```bash
smooth list-profiles
```

### 2. Start a Browser Session

```bash
smooth start-session --profile-id "my-profile" --url "https://example.com"
```

**Options:**
- `--profile-id` - Use a specific profile (optional, creates anonymous session if not provided)
- `--url` - Initial URL to navigate to (optional)
- `--files` - Comma-separated file IDs to make available in the session (optional)
- `--device mobile|desktop` - Device type (default: mobile)
- `--profile-read-only` - Load profile without saving changes
- `--allowed-urls` - Comma-separated URL patterns to restrict access to certain URLs only (e.g., "https://*example.com/*,https://*api.example.com/*")

**Important:** Save the session ID from the output - you'll need it for all subsequent commands.

### 3. Run Tasks in the Session

Execute tasks using natural language:

```bash
smooth run <session-id> "Go to the LocalLLM subreddit and find the top 3 posts"
```

**With structured output (for tasks requiring interaction):**
```bash
smooth run <session-id> "Search for 'wi