Files

T

Taylor Beeston 5fabc88f9e Fix subagent crash and add external OpenCode server support (#188 )

* 🐛 Fix UI crash when subagent is active

Remove sessions dependency from hooks to prevent cascading re-renders.
Use getState() instead and switch to getGlobalSessionStatus().

* ✨ Add support for connecting to external OpenCode server

Add OPENCODE_SKIP_START env var to skip starting embedded server.
Use OPENCODE_PORT to connect to existing OpenCode instance.
Update help text to document the new environment variables.

* 📝 Document external OpenCode server support

Add OPENCODE_PORT and OPENCODE_SKIP_START to READMEs.
Update AGENTS.md with external server integration notes.

* ✨ Add URL-based routing for shareable session links

- Add react-router-dom dependency
- Create URL store for bi-directional sync with Zustand
- Add WebRouter/DesktopRouter context for runtime-aware routing
- Add useURLSync hook to sync URL with session/tab state
- Add useNavigation hook with copySessionLink utility
- Add share button in Header for copying session links
- Update App.tsx to use router wrappers

URL structure:
  /session/:sessionId?tab={chat|git|diff|terminal|files}&directory=/path
  /settings

This enables shareable links and deep-linking to specific sessions.

* Revert "✨ Add URL-based routing for shareable session links"

This reverts commit b53ee304950a789538fa3d4a236d6361e634ea61.

2026-01-22 18:32:04 +02:00

8.3 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
openchamber stop                     # Stop server
openchamber update                   # Update to latest version

Environment Variables

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_PORT to connect to external instance)

Prerequisites

OpenCode CLI installed (opencode)
Node.js 20+

Features

Core UI

Integrated terminal
Git operations with identity management and AI commit message generation
Smart tool visualization (inline diffs, file trees, results highlighting)
Rich permission cards with syntax-highlighted operation previews
Per-agent permission modes (ask/allow/full) per session
Multi-agent runs from a single prompt (isolated worktrees)
Branchable conversations: start a new session from any assistant response
Task tracker UI with live progress and tool summaries
Model selection UX: favorites, recents, and configurable tool output density
UI scaling controls (font size and spacing)
Session auto-cleanup with configurable retention
Memory optimizations with LRU eviction

Web / PWA

Mobile-first UI with gestures and optimized terminal controls
Remote access from any device via browser (works alongside the OpenCode TUI)
Self-serve updates (openchamber update) without reinstalling
Update + restart keeps previous server settings (port/password)

License

MIT

8.3 KiB Raw Blame History