chore(docs): reorganize development instructions and enhance README clarity

packages/web/README.md

@@ -1,6 +1,10 @@
 # @openchamber/web
 
-Web interface for the [OpenCode](https://opencode.ai) AI coding agent.
+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
 
@@ -25,18 +29,31 @@ openchamber update                   # Update to latest version
 
 ## Prerequisites
 
-- [OpenCode CLI](https://opencode.ai) installed and running (`opencode serve`)
+- [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
-- Beautiful themes (Flexoki Light/Dark)
-- Mobile-optimized with edge-swipe gestures
-- Rich permission cards with syntax-highlighted operation previews
 - Smart tool visualization (inline diffs, file trees, results highlighting)
-- Per-agent permission mode control
+- Rich permission cards with syntax-highlighted operation previews
+- Per-agent permission modes (ask/allow/full) per session
+- 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