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

# Browser profiles and sessions

> Kazzle Browser, cloud browser, and Chrome or Brave - three ways to browse.

There are three ways to browse in Kazzle: the built-in browser on your device, a dedicated cloud browser computer in your space, and your own Chrome or Brave connected via extension.

## Kazzle Browser (built-in)

The default. A full browser embedded in the desktop app. Per-space cookie isolation. Multiple tabs per session.

* The AI and you share the same tabs
* Pages can keep running in the background after you close the tab view
* No setup required

## Cloud browser

A dedicated browser computer in your space for automation and scraping, with stealth defaults and a live view URL you can watch.

* One active session per browser computer; 72-hour timeout, auto-recreated on the next tool call
* Best when you need clean sessions, stealth, or automation that keeps running without your device

## Chrome or Brave (extension)

Connect your real Chrome or Brave browser to Kazzle via the Chrome extension. The AI controls the same browser window you see.

* Your browsing is the AI session - shared view
* One session per profile (the operating system locks the profile)
* Install from the Chrome Web Store, or load unpacked in development

### Connecting

1. Go to **Settings > Computers** in your space
2. Click **Connect browser**
3. Install the Kazzle extension if prompted
4. Complete the pairing in Chrome or Brave. The AI can now navigate, click, and read your browser.

## Session lifecycle

A browser session represents one live browser connection. Sessions are created when you (or the AI) open a browser, and destroyed when closed.

| Backend        | Sessions                 | Lifecycle                                                                     |
| -------------- | ------------------------ | ----------------------------------------------------------------------------- |
| Kazzle Browser | One per device           | Per-space cookies; pages can keep running in the background                   |
| Cloud browser  | One per browser computer | 72h timeout, auto-recreated                                                   |
| Chrome / Brave | One per profile          | Survives brief extension disconnects; ends when you disconnect it in Settings |

Both you and the AI go through the same session. The AI can target a tab you opened, and you can pick up where the AI left off.
