openchamber/packages/web

@openchamber/web

Web/PWA interface for the OpenCode AI coding agent.

This package installs the openchamber CLI that runs a local web server. For the full project overview and screenshots, see the main repo:

https://github.com/btriapitsyn/openchamber

Installation

# Quick install (auto-detects your package manager)
curl -fsSL https://raw.githubusercontent.com/btriapitsyn/openchamber/main/scripts/install.sh | bash

# Or install manually
bun add -g @openchamber/web    # or npm, pnpm, yarn

Usage

openchamber                          # Start on port 3000
openchamber --port 8080              # Custom port
openchamber --daemon                 # Background mode
openchamber --ui-password secret     # Password-protect UI
openchamber --try-cf-tunnel          # Create a Cloudflare Quick Tunnel for remote access
openchamber --try-cf-tunnel --tunnel-qr              # Show QR code for easy mobile access
openchamber --try-cf-tunnel --tunnel-password-url   # Include password in URL for auto-login
OPENCODE_PORT=4096 OPENCODE_SKIP_START=true openchamber                    # Connect to external OpenCode server
OPENCODE_HOST=https://myhost:4096 OPENCODE_SKIP_START=true openchamber  # Connect via custom host/HTTPS
openchamber stop                     # Stop server
openchamber update                   # Update to latest version

Named Tunnel mode is configured in-app (Settings -> OpenChamber -> Tunnel). The CLI currently supports Quick Tunnel flags only. --tunnel <config.yml> is not supported yet.

Environment Variables

• OPENCODE_HOST - Full base URL of external OpenCode server, e.g. http://hostname:4096 or https://hostname:4096 (overrides OPENCODE_PORT)
• OPENCODE_PORT - Port of external OpenCode server to connect to (instead of starting embedded server)
• OPENCODE_SKIP_START - Skip starting embedded OpenCode server (use with OPENCODE_HOST or OPENCODE_PORT to connect to external instance)

Prerequisites

• OpenCode CLI installed (opencode)
• Node.js 20+

Features

Core UI

• Branchable chat timeline with /undo, /redo, and one-click forks from earlier turns
• Smart tool UIs for diffs, file operations, permissions, and long-running task progress
• Multi-agent runs from one prompt with isolated worktrees for safe comparisons
• Git workflows in-app: identities, commits, PR creation, checks, and merge actions
• Context visibility tools (token/cost breakdowns, raw message inspection, and activity summaries)
• Integrated terminal with per-directory sessions and stable performance on heavy output

Web / PWA

• Cloudflare tunnel access with two modes: Quick Tunnel (CLI) and Named Tunnel (in-app settings)
• One-scan onboarding with tunnel QR + password URL helpers
• Mobile-first experience: optimized chat controls, keyboard-safe layouts, and attachment-friendly UI
• Background notifications plus reliable cross-tab session activity tracking
• Built-in self-update + restart flow that keeps your server settings intact

License

MIT