openchamber/README.md

OpenChamber

OpenCode, everywhere. Desktop. Browser. Phone.

A rich interface for OpenCode. Review diffs, manage agents, run dev servers, and keep the big picture while your AI codes.

More screenshots

Why use OpenChamber?

• Cross-device continuity: Start in TUI, continue on tablet/phone, return to terminal - same session
• Remote access: Use OpenCode from anywhere via browser
• Familiarity: A visual alternative for developers who prefer GUI workflows

Features

Core (all app versions)

• 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
• Voice mode with speech input and read-aloud responses for hands-free workflows
• Multi-agent runs from one prompt with isolated worktrees for safe side-by-side comparisons
• Git workflows in-app: identities, commits, PR creation, checks, and merge actions
• GitHub-native workflows: start sessions from issues and pull requests with context already attached
• Plan/Build mode with a dedicated plan view for drafting and iterating implementation steps
• Inline comment drafts on diffs, files, and plans that can be sent back to the agent
• Context visibility tools (token/cost breakdowns, raw message inspection, and activity summaries)
• Integrated terminal with per-directory sessions and stable performance on heavy output
• Built-in skills catalog and local skill management for reusable automation workflows

Web / PWA

• Provider-aware tunnel access model with Cloudflare quick, managed-remote, and managed-local modes
• 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

Desktop (macOS)

• Native macOS menu integration with polished app actions and deep-link handling
• Multi-window support for parallel project/session workflows
• "Open In" shortcuts for Finder, Terminal, and your preferred editor
• Fast switching between local and remote instances
• Workspace-first startup flow with directory picker and steadier window restore behavior

VS Code Extension

• Editor-native workflow: open files directly from tool output and keep sessions beside your code
• Agent Manager for parallel multi-model runs from a single prompt
• Right-click actions to add context, explain selections, and improve code in-place
• In-extension settings, responsive layout, and theme mapping that matches your editor
• Hardened runtime lifecycle and health checks for faster startup and fewer stuck reconnect states

Custom Themes

• Use it from anywhere - Cloudflare tunnel with QR code onboarding. Scan, connect, code from your couch.
• Branchable chat timeline - Undo, redo, fork from any turn. Explore different approaches without losing your place.
• GitHub-native workflows - Start sessions from issues and PRs with context already attached. Review checks, merge - all in-app.
• Project Actions - Run dev servers, configure SSH port forwarding, open remote URLs locally. Your project commands, one click away.
• Connect to remote machines - Desktop app connects to remote OpenChamber instances over SSH, with dedicated lifecycle and UX flows.

Quick Start

Prerequisite: OpenCode CLI installed.

Desktop (macOS)

Download from Releases.

VS Code

Install from Marketplace or search "OpenChamber" in Extensions.

CLI (Web + PWA)

requires Node.js 20+

curl -fsSL https://raw.githubusercontent.com/btriapitsyn/openchamber/main/scripts/install.sh | bash
openchamber --ui-password be-creative-here --daemon

Advanced CLI options

openchamber --port 8080              # Custom port
openchamber --ui-password secret     # Password-protect UI
openchamber tunnel help              # Tunnel lifecycle commands
openchamber tunnel providers         # Show provider capabilities
openchamber tunnel profile add --provider cloudflare --mode managed-remote --name prod-main --hostname app.example.com --token <token>
openchamber tunnel start --profile prod-main
openchamber tunnel start --provider cloudflare --mode quick --qr
openchamber tunnel start --provider cloudflare --mode managed-local --config ~/.cloudflared/config.yml
openchamber tunnel status --all      # Show tunnel state across instances
openchamber tunnel stop --port 3000  # Stop tunnel only (server stays running)
openchamber logs                     # Follow latest instance logs
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

Connect to an existing OpenCode server:

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

Docker

docker compose up -d

Available at http://localhost:3000.

UI Password:

environment:
  UI_PASSWORD: your_secure_password

Cloudflare Tunnel:

environment:
  CF_TUNNEL: "true" # Options: true, qr, password

Value	Description
true	Enable tunnel only
qr	Enable tunnel + QR code
password	Enable tunnel + password in URL

Managed Cloudflare Tunnel (persistent hostname)

OpenChamber also supports managed-remote mode for more reliable long-lived access with your Cloudflare account and custom hostname.

• Configure it in-app at Settings -> OpenChamber -> Tunnel and switch mode to Managed Remote Tunnel.
• Managed-remote tunnels require a domain in your Cloudflare account.
• Cloudflare setup guide: https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/get-started/create-remote-tunnel/
• Managed-local mode uses your local cloudflared config, for example:
  • openchamber tunnel start --provider cloudflare --mode managed-local --config ~/.cloudflared/config.yml

Tunnel behavior notes

• OpenChamber supports one active tunnel per running instance (port).
• Starting a tunnel with a different mode/provider on the same instance replaces the current tunnel.
• Replacing or stopping a tunnel revokes existing connect links and invalidates remote tunnel sessions for that instance.
• Connect links are one-time tokens; generating a new link revokes the previous unused link.

Data Directory Permission Note: The data/ directory is mounted into the container for persistent storage (config, sessions, SSH keys, workspaces). Before running, ensure the directory exists and has proper permissions:

mkdir -p data/openchamber data/opencode/share data/opencode/config data/ssh
chown -R 1000:1000 data/

SSH/Git: If git push/pull fails, run ssh -T git@github.com in terminal.

Named Cloudflare Tunnel (persistent hostname)

• OpenCode CLI installed

• Node.js 20+ (for web version)

• cloudflared (required for Cloudflare tunnel modes) For reliable long-lived access with a custom hostname from your Cloudflare account:

• Configure in-app at Settings > OpenChamber > Tunnel, switch to Named mode.

• Requires a domain in your Cloudflare account.

• Cloudflare setup guide

• CLI --tunnel <config.yml> support is coming very soon.

Features

Chat & Interaction

• Branchable chat timeline with /undo, /redo, and one-click forks from any turn
• Multi-agent runs from one prompt with isolated worktrees for safe side-by-side comparisons
• Voice mode with speech input and read-aloud responses for hands-free workflows
• Plan/Build mode with a dedicated plan view for drafting and iterating steps
• Inline comment drafts on diffs, files, and plans - send feedback back to the agent
• Shell mode via leading ! with inline output
• Share messages as images
• Mermaid diagrams render inline with copy/download actions
• Smart tool UIs for diffs, file operations, permissions, and task progress

Git & GitHub

• Full Git sidebar with staging, commits, push/pull, branch management, and rebase/merge flows
• PR creation with AI-generated descriptions, status checks, and merge actions
• Start sessions from GitHub issues and pull requests with context baked in
• Multi-remote push and fork-aware PR creation
• Worktree integration: isolated sessions per branch, merge back with conflict handling
• Git identities, gitmoji support, and multi-account GitHub auth

Files, Diff & Terminal

• Workspace file browser with inline editing, syntax highlighting, and markdown preview
• Beautiful diff viewer with stacked/inline modes, lazy loading for large changesets
• Integrated terminal with per-directory sessions, tabbed interface, and stable heavy-output performance
• Clickable file paths in messages - jump to exact line locations
• File-type icons across all views for faster visual scanning

Web / PWA

• Cloudflare tunnel with Quick and Named modes, secure one-time connect links, and QR onboarding
• Mobile-first: optimized chat controls, keyboard-safe layouts, drag-to-reorder projects
• Background notifications and cross-tab session tracking
• Self-update + restart flow that keeps your server settings intact
• Installable as PWA with project-aware naming

Desktop (macOS)

• Connect to remote OpenChamber instances over SSH with dedicated lifecycle flows
• Project Actions: run dev servers, SSH port forwarding, open remote URLs locally
• Multi-window support for parallel project workflows
• "Open In" shortcuts for Finder, Terminal, and your preferred editor
• Fast switching between local and remote instances
• Native macOS menu, deep-link handling, and polished startup

VS Code Extension

• Editor-native: open files from tool output, keep sessions beside your code
• Agent Manager for parallel multi-model runs from a single prompt
• Right-click actions: add context, explain selections, improve code in-place
• Session editor panel, responsive layout, and theme mapping to your editor
• Edit-style tool results open directly in focused diff views

Customization

• 18+ built-in themes with light/dark variants
• Custom themes via JSON files in ~/.config/openchamber/themes/ - hot reload, no restart
• Configurable keyboard shortcuts for chat, panels, and services
• Font size, spacing, corner radius, and layout controls
• Customizable project icons with upload and automatic favicon discovery
• Skills catalog and local skill management for reusable automation

Read the Guide: Custom Themes

Context & Productivity

• Token usage, cost breakdowns, and raw message inspection panel
• Usage quota tracking across multiple providers with pace/prediction indicators
• Favorite model cycling via keyboard shortcuts
• Session folders and subfolders with drag-to-reorder
• Persistent project notes and todos per project
• Draft persistence per session with expanded focus mode for longer prompts

Roadmap

Active development. Here's what's being worked on or planned:

• Windows and Linux desktop apps
• Mobile app with remote instance and laptop connectivity
• More built-in tunneling options
• Kanban board for multi-agent management - keeping the human in the loop and in control
• Custom OpenCode plugins/tools built-in catalog
• Linear integration
• Built-in browser for running dev apps with agent integration

Acknowledgments

Independent project, not affiliated with the OpenCode team.

Special thanks to:

• OpenCode - For the excellent API and extensible architecture.
• Flexoki - Beautiful color scheme by Steph Ango.
• Pierre - Fast, beautiful diff viewer with syntax highlighting.
• Tauri - Desktop application framework.
• Ghostty-web - Great implementation of a Ghostty web renderer.
• David Hill - Who inspired me to release this without overthinking.
• My wife, who - with zero AI background - sat down with the app for the first time and built the firework celebration that plays on every successful push.
• Every contributor who shaped this project with their PRs, ideas, and attention to detail.

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

MIT