Taylor Beeston
5fabc88f9e
* 🐛 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.
76 lines
8.3 KiB
Markdown
76 lines
8.3 KiB
Markdown
# <picture><source media="(prefers-color-scheme: dark)" srcset="https://github.com/btriapitsyn/openchamber/raw/HEAD/docs/references/badges/openchamber-logo-dark.svg"><img src="https://github.com/btriapitsyn/openchamber/raw/HEAD/docs/references/badges/openchamber-logo-light.svg" width="32" height="32" align="absmiddle" /></picture> @openchamber/web
|
|
|
|
[](https://github.com/btriapitsyn/openchamber/stargazers)
|
|
[](https://github.com/btriapitsyn/openchamber/network/members)
|
|
[](https://github.com/btriapitsyn/openchamber/releases/latest)
|
|
[](https://opencode.ai)
|
|
[](https://zread.ai/btriapitsyn/openchamber)
|
|
[](https://discord.gg/ZYRSdnwwKA)
|
|
[](https://ko-fi.com/G2G41SAWNS)
|
|
|
|
Web/PWA interface for the [OpenCode](https://opencode.ai) 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
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](https://opencode.ai) 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
|