Files

T

Colin MollenhourandCopilot e02002bc9f feat(server): add OPENCODE_HOST env var for external OpenCode connections (#499 )

* feat(server): add OPENCODE_HOST env var for external OpenCode connections

Allows specifying a full base URL (e.g. https://hostname:4096) for external
OpenCode connections, supporting custom hostnames and HTTPS. When set,
OPENCODE_HOST overrides OPENCODE_PORT. Malformed values are fatal at startup.

* docs: document OPENCODE_HOST env var in README and AGENTS

* Fatal error when OPENCODE_HOST has path, search or hash

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Colin Mollenhour <colin@mollenhour.com>

* fix(server): use external origin when re-probing OpenCode

---------

Signed-off-by: Colin Mollenhour <colin@mollenhour.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

2026-02-25 19:42:32 +02:00

8.6 KiB

Raw Blame History

@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
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

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 Quick Tunnel for instant remote access (--try-cf-tunnel)
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

8.6 KiB Raw Blame History