# OpenChamber

> OpenChamber is a control room for AI coding — a rich interface around [OpenCode](https://opencode.ai) that runs on desktop, browser, phone (PWA), and VS Code. Watch agents work, review diffs and tool output in context, branch and rewind sessions, manage terminals/files/Git/GitHub, and move between local and remote machines without losing the thread.

Prerequisite: the [OpenCode CLI](https://opencode.ai) must be installed. OpenChamber is free and open source.

## Install

- **Desktop (macOS + Windows):** download from [GitHub Releases](https://github.com/openchamber/openchamber/releases) or the [Download page](https://openchamber.dev/download).
- **VS Code:** install "OpenChamber" from the [Marketplace](https://marketplace.visualstudio.com/items?itemName=fedaykindev.openchamber), or search "OpenChamber" in the Extensions panel.
- **CLI (Web + PWA, requires Node.js 22+):**
  ```bash
  curl -fsSL https://raw.githubusercontent.com/openchamber/openchamber/main/scripts/install.sh | bash
  openchamber --ui-password choose-a-password
  ```

## Quick configuration

Common flags for the CLI server:

```bash
openchamber --port 8080                 # custom port
openchamber --lan --port 3000           # listen on the LAN (0.0.0.0)
openchamber --ui-password secret        # password-protect the browser UI
openchamber startup enable              # run at login as a native service
openchamber update                      # update to the latest version
openchamber stop                        # stop the server
openchamber logs                        # follow the current instance logs
```

Connect to an existing OpenCode server instead of letting OpenChamber manage one:

```bash
OPENCODE_PORT=4096 OPENCODE_SKIP_START=true openchamber
OPENCODE_HOST=https://myhost:4096 OPENCODE_SKIP_START=true openchamber
```

Add a running server to the Desktop app (generates an `openchamber://connect?...` link, optionally as a QR code):

```bash
openchamber connect-url --port 3000 --qr
```

Remote access (VPN/LAN) without a tunnel: run OpenCode and OpenChamber as separate persistent services, binding OpenCode to localhost and exposing OpenChamber with `--lan`. Tunnels are also supported via `openchamber tunnel ...` (Cloudflare quick, managed-local, and managed-remote modes).

## Links

- [Website](https://openchamber.dev)
- [Documentation](https://openchamber.dev/docs)
- [Install guide](https://openchamber.dev/docs/install)
- [Download](https://openchamber.dev/download)
- [GitHub](https://github.com/openchamber/openchamber)
- [Discord](https://discord.gg/ZYRSdnwwKA)