diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6edb2e5b..350a8175 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,19 @@ All notable changes to this project will be documented in this file.
## [Unreleased]
+- **Walkthrough:** a new guided walkthrough reorders a diff into a sequence of stops — the model groups related changes, explains what each one does, and orders them so each builds on the last. Start one from the Changes and pull-request views for uncommitted work, a branch against its base, or a pull request; nothing runs on its own. Walkthroughs are written in your interface language by default, and the panel can generate one in any other supported language.
+- **Mobile/Tablet:** reworked the tablet and foldable layout around the phone's navigation — a persistent resizable sessions sidebar on the left, the workspace (Changes, Files, Terminal, Notes, MCP) as a resizable right sidebar, and app pages like settings and instances shown as centered dialogs. An open diff, edited file, or attached terminal now survives rotation.
+- Performance: fixed Bun dependency chunking so the web app no longer downloads a single 18.5 MB vendor bundle at startup; heavy syntax highlighting, screenshot, diagram, editor, and image-conversion libraries now load only when needed (thanks to @makeittech).
+- Mobile/Android: pairing QR codes can now be scanned on devices without Google Play Services; the camera closes as soon as a code is recognized, followed by a connection-in-progress screen.
+- Mobile/Android: left and right drawer swipes can now start farther from the screen edge, outside Android's system Back gesture area.
+- Sessions: launching OpenChamber from a directory other than your project (for example your home folder) no longer produces repeated "not a git repository" errors that could stop sessions and projects from loading (thanks to @makeittech).
+- Sidebar: a worktree shared by more than one project no longer appears twice (thanks to @makeittech).
+- Sidebar: session titles no longer clip at the ends of their rows.
+- Git/Diff: opening a changed file now jumps its header directly to the top, and live updates refresh only files that actually changed while preserving the current review position. Saves from the built-in file editor update the diff too.
+- Sessions: archiving and unarchiving now stays scoped to the current instance and workspace (thanks to @alexandrereyes).
+- Chat: assistant messages no longer render active HTML.
+- VSCode: clicking an apply_patch tool result now opens each changed file at its correct path instead of always opening the first file (thanks to @nabsiddiqui).
+
## [1.17.2] - 2026-08-01
- **Mobile:** rebuilt the app navigation around two swipe drawers — a sessions drawer (left) with a cross-project tree, swipe actions to rename, archive, or delete sessions, and a workspace drawer (right) with Changes, Files, Terminal, Notes, and MCP tabs. Tapping the session title in the header switches recents from a compact overlay with live status indicators. Cold launches reopen the last active session and land on an explicit connect screen on failure instead of flashing an empty draft.
@@ -42,7 +55,7 @@ All notable changes to this project will be documented in this file.
## [1.17.0] - 2026-07-28
- **Context panel:** a new surface rail brings Changes, pull requests, files, terminal, notes, plans, previews, and side chats into one resizable panel. The pull-request surface now shows live checks and comments, and can attach failed checks or comments to a chat draft.
-- **Desktop/Linux:** official AppImage releases for x64 and arm64, with in-app updates, frameless window controls, system tray minimize, launch at login, multi-window support, and “Open in” for discovered installed apps. Missing update manifests are treated as “no update” instead of a hard failure, and updater errors surface in About/sidebar (thanks to @jibanez-staticduo, @makeittech).
+- **Desktop/Linux:** official AppImage releases for x64 and arm64, with in-app updates, frameless window controls, system tray minimize, launch at login, multi-window support, and “Open in” for discovered installed apps. Missing update manifests are treated as “no update” instead of a hard failure, and updater errors surface in About/sidebar (thanks to @BestSithInEU, @jibanez-staticduo, @makeittech).
- **Sidebar:** sessions are organized into Recent and project zones with worktree-grouped or flat views. Scheduled tasks, archived sessions, multi-run, and worktree management now open as full-page views from the sidebar.
- **Agents/CLI:** agents on managed local instances can now create, send to, fork, inspect, and wait for sessions; create isolated worktrees; and manage scheduled tasks through the OpenChamber tool. The CLI adds matching `session`, `schedule`, `projects`, and `models` commands, and a new Schedule a Task starter guides task setup from chat.
- Chat composer: prompts now render Markdown emphasis, attention lines, file and agent mentions, slash commands, snippets, attachment citations, and `~path` references directly while you type. File mentions can be edited in place, and the mobile composer grows with its content instead of using a separate fullscreen gesture.
diff --git a/README.md b/README.md
index 1964313b..7241e03a 100644
--- a/README.md
+++ b/README.md
@@ -1,453 +1,160 @@
# OpenChamber
-[](https://github.com/openchamber/openchamber/stargazers)
-[](https://github.com/openchamber/openchamber/releases/latest)
-[](https://opencode.ai)
+[](https://github.com/openchamber/openchamber/stargazers)
+[](https://github.com/openchamber/openchamber/releases/latest)
[](https://discord.gg/ZYRSdnwwKA)
[](https://ko-fi.com/G2G41SAWNS)
-## **OpenCode, everywhere.** Desktop. Browser. Phone.
+## Run agent work. Keep control. Ship from anywhere.
-### A rich interface for [OpenCode](https://opencode.ai). Review diffs, manage agents, run dev servers, and keep the big picture while your AI codes.
+**OpenChamber is an open-source workspace for running, supervising, and reviewing AI coding work across desktop, browser, editor, and mobile.**
+
+OpenChamber gives you one place to direct agent work, understand the changes, and move them toward release. Your projects stay available when you switch devices or step away.
More screenshots
-
-
-
-
-
+
+
-## Why use OpenChamber?
+## What you can do with 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
+### Goals that continue on their own
-## Features
+Give a session a finish line with **Session Goals**. OpenChamber checks the result after every turn and keeps the agent working until the goal is complete, blocked, or reaches the limit you set — even after you close the app.
-### Core (all app versions)
+### Compare and combine runs
-- 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
+Use **Multi-run** to give the same task to up to five models, each in its own session and optionally its own worktree. See what each one actually built, choose the best result, or use **Fusion** to combine the strongest parts into a new session.
-### Web / PWA
+### Guided changes walkthroughs
-- 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
+**Changes Walkthrough** turns a large diff into an AI-guided tour of the change. It groups related edits into steps, puts them in the order the change makes sense, and explains how the pieces fit together.
-### Desktop (macOS + Windows + Linux)
+### Inspect a running app
-- Floating Mini Chat: keep a small always-on-top assistant beside your editor, browser, or terminal
-- Multiple native windows for separate projects or sessions
-- Native notifications for task alerts while OpenChamber is hidden
-- One-click open in VS Code, Cursor, Terminal, Finder, Explorer, and more
-- Desktop host switcher for local and remote OpenChamber instances
-- Convenient tunnel management without manual setup
-- Deep-link connections for joining remote OpenChamber from a link
-- SSH remote access with host import, connection management, and port forwarding
+Open your app beside the conversation with **Preview**. Point at an element and send the agent its screenshot, styles, position, and browser errors — all the context behind “this thing here.” Desktop brings the same workflow to any web page through its built-in browser.
-### VS Code Extension
+### GitHub context from issue to pull request
-- 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
+Start a session from a GitHub issue or pull request with its context attached. Send failed checks or review comments back to the agent, then update or merge the pull request from OpenChamber.
-### Custom Themes
+### Continue on another device
-- **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.
+Open the same projects and sessions from Desktop, Web/PWA, VS Code, iOS, or Android. Check progress, answer questions, review changes, and reattach to a running terminal.
-## Quick Start
+### Private remote access
-> **Prerequisite:** Desktop bundles the matching OpenCode CLI. CLI/Web and VS Code use your installed [OpenCode CLI](https://opencode.ai).
+Pair a device with a one-time QR code and connect through **Private Relay** without opening ports or exposing a public server. The connection is end-to-end encrypted and can be revoked at any time. Direct connections, LAN/VPN access, Cloudflare/Ngrok tunnels, and SSH are also supported.
-### **Desktop (macOS + Windows + Linux)**
+### Track work across projects
-Download the latest Desktop release from [GitHub Releases](https://github.com/openchamber/openchamber/releases).
+See which sessions are working, waiting, finished, or failed, along with approvals, scheduled tasks, provider limits, token use, and costs. Organize sessions into folders and keep notes, todos, and reusable project actions nearby.
-On Linux, choose the AppImage for your system:
+### Schedule recurring work
-- `linux-x86_64.AppImage` for 64-bit Intel or AMD systems
-- `linux-arm64.AppImage` for ARM64/aarch64 systems
+Run a prompt once, daily, weekly, or on a cron schedule. Scheduled tasks can use Session Goals, so they continue toward an outcome instead of stopping after one response.
-Make the AppImage executable before launching it, for example with `chmod +x `. Keep the AppImage in a location your user can write to so OpenChamber can download and apply in-app updates.
+## Use it where you work
-Linux AppImages need FUSE (`libfuse.so.2`). On Ubuntu/Debian install `libfuse2` (or `fuse` / `libfuse2t64` on newer releases). If FUSE is unavailable, run with extraction instead:
+| Surface | Role |
+| --- | --- |
+| **Desktop** | The complete workspace for macOS, Windows, and Linux, with multiple windows, Mini Chat, remote machines, SSH, and native notifications |
+| **Web / PWA** | Open your workspace in a browser, install it as an app, and stay up to date through background notifications |
+| **VS Code** | Keep sessions beside your code, send selections to the agent, open results in the editor, and compare parallel runs |
+| **iOS / Android** | Review and steer work away from your desk, receive completion alerts, and use the terminal with touch controls |
+| **CLI / Server** | Run OpenChamber on a workstation or server, schedule work, manage remote access, and keep it available after login |
+
+## Quick start
+
+### Desktop — macOS, Windows, and Linux
+
+Download the latest release from [GitHub Releases](https://github.com/openchamber/openchamber/releases/latest). Desktop bundles the matching OpenCode CLI, so no separate OpenCode installation is required.
+
+Linux releases are available as x86_64 and ARM64 AppImages. Make the downloaded AppImage executable and keep it in a writable location for in-app updates:
```bash
-APPIMAGE_EXTRACT_AND_RUN=1 ./OpenChamber-*-linux-*.AppImage
+chmod +x OpenChamber-*.AppImage
+./OpenChamber-*.AppImage
```
-Linux Desktop ships as AppImage with in-app window controls and auto-update when running from a writable AppImage.
+Linux AppImages require FUSE (`libfuse.so.2`). Without FUSE, run with `APPIMAGE_EXTRACT_AND_RUN=1`.
-### **VS Code**
-Install from [Marketplace](https://marketplace.visualstudio.com/items?itemName=fedaykindev.openchamber) or search "OpenChamber" in Extensions.
+### VS Code
-### **CLI (Web + PWA)**
-_requires Node.js 22+_
+Install [OpenChamber from the Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=fedaykindev.openchamber), or search for “OpenChamber” in Extensions.
+
+### CLI — Web and PWA
+
+Requires Node.js 22+. CLI/Web and VS Code use your installed [OpenCode CLI](https://opencode.ai).
```bash
curl -fsSL https://raw.githubusercontent.com/openchamber/openchamber/main/scripts/install.sh | bash
openchamber --ui-password be-creative-here
```
-
-Advanced CLI options
+Common operations:
```bash
-openchamber --port 8080 # Custom port
-openchamber --lan --port 3000 # Listen on LAN (0.0.0.0)
-openchamber --ui-password secret # Password-protect UI
-openchamber startup enable # Start at login as a native service
-OPENCHAMBER_UI_PASSWORD=secret openchamber startup enable # Save service password env
-openchamber startup status # Show startup service status
-openchamber startup disable # Remove startup service
-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
-openchamber tunnel start --profile prod-main
+openchamber status
+openchamber connect-url --qr
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 connect-url --port 3000 # Add this server to OpenChamber Desktop
-openchamber connect-url --server http://host:3000 --qr
-openchamber connect-url --port 3000 --qr
-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
+openchamber startup enable
+openchamber logs
+openchamber stop
+openchamber update
```
-`startup enable` snapshots your current environment into the native service so startup behaves like you launched `openchamber` from the same shell. This preserves provider tokens, PATH, SSH agent settings, and other CLI auth/config env vars. Use `--no-env-snapshot` if you want a minimal service env.
+OpenChamber binds to localhost by default. Use `--lan` only on a trusted network and protect browser access with `--ui-password`.
-Connect to an existing OpenCode server:
-```bash
-OPENCODE_PORT=4096 OPENCODE_SKIP_START=true openchamber
-OPENCODE_HOST=https://myhost:4096 OPENCODE_SKIP_START=true openchamber
-```
+## Guides
-Bind managed OpenCode server to all interfaces (use only on trusted networks):
-```bash
-OPENCHAMBER_OPENCODE_HOSTNAME=0.0.0.0 openchamber --port 3000
-```
+Go deeper with the OpenChamber guides:
-Expose OpenChamber itself on your LAN:
-```bash
-openchamber --lan --port 3000 --ui-password secret
-```
+- [Quick start](packages/docs/content/docs/quickstart.mdx)
+- [Installation](packages/docs/content/docs/install.mdx)
+- [Connect devices](packages/docs/content/docs/connect-devices.mdx)
+- [Private Relay](packages/docs/content/docs/private-relay.mdx)
+- [Multi-run](packages/docs/content/docs/multi-run.mdx)
+- [Session Goals](packages/docs/content/docs/session-goals.mdx)
+- [Changes Walkthrough](packages/docs/content/docs/walkthrough.mdx)
+- [Preview and dev servers](packages/docs/content/docs/preview.mdx)
+- [GitHub workflows](packages/docs/content/docs/github.mdx)
+- [Mobile](packages/docs/content/docs/mobile.mdx)
+- [Security](packages/docs/content/docs/security.mdx)
+- [Troubleshooting](packages/docs/content/docs/troubleshooting.mdx)
-Add this server to OpenChamber Desktop or another OpenChamber app:
-```bash
-openchamber connect-url --port 3000 --qr
-```
+For self-hosting details, see the [reverse proxy guide](docs/REVERSE_PROXY.md). For custom theme authoring, see the [custom themes guide](docs/CUSTOM_THEMES.md).
-If no OpenChamber server is running on that port, `connect-url` starts one before generating the link.
+## Why OpenCode?
-Headless/API-only setup for a remote machine:
-```bash
-openchamber connect-url --port 3000 --api-only --lan --server http://your-host-or-ip:3000 --qr --ui-password secret
-```
+OpenChamber uses [OpenCode](https://opencode.ai) to power its coding agents. We chose it because we believe it provides the best open-source agentic coding experience today: capable, extensible, and open by design.
-This runs OpenChamber as an API-only server without the desktop app or browser UI assets on that machine, then creates a link for Desktop to import. `--lan` makes the server reachable from other machines. `--server` is the address Desktop should use.
+Around that foundation, OpenChamber brings together the work that happens before, during, and after an agent run — deciding what to try, keeping it on track, reviewing the result, connecting from anywhere, and getting the change shipped.
-When OpenChamber was started with `--lan` or `--host 0.0.0.0`, `connect-url` automatically uses a detected LAN IP instead of `127.0.0.1`. Use `--server http://host:3000` to override the advertised address, and include `--lan` when `connect-url` needs to start the server for LAN access.
-
-Paste the printed `openchamber://connect?...` link in Desktop under Settings -> Remote Instances -> Direct Instances -> Import Link. The link contains the server URL and a client token. It does not enable browser UI password protection; use `--ui-password` when exposing a server beyond localhost.
-
-
-
-
-systemd service (VPN / LAN access)
-
-Run OpenChamber and OpenCode as separate persistent services — useful when you want to access your
-dev machine over a VPN (e.g. Tailscale) or LAN without a Cloudflare tunnel.
-
-**How it works:**
-- OpenCode runs as its own service, binding only to `localhost`.
-- OpenChamber connects to it via `OPENCODE_HOST` and `--lan` makes it reachable on your VPN IP.
-- `--foreground` keeps the CLI process alive so systemd can track and restart it.
-
-**`~/.config/systemd/user/opencode.service`**
-```ini
-[Unit]
-Description=OpenCode Server
-
-[Service]
-Type=simple
-ExecStart=opencode serve --port 4095
-Environment="PATH=/home/linuxbrew/.linuxbrew/bin:/home/linuxbrew/.linuxbrew/sbin:/home/YOU/.local/bin:/home/YOU/.npm-global/bin:/usr/local/bin:/usr/bin:/bin"
-Environment=SSH_AUTH_SOCK=%t/ssh-agent.socket
-Restart=on-failure
-RestartSec=5
-
-[Install]
-WantedBy=default.target
-```
-
-> **Why set `PATH` and `SSH_AUTH_SOCK`?**
-> systemd user services start with a minimal environment — no shell profile is sourced.
-> Without an explicit `PATH`, OpenCode won't find tools installed via Homebrew, npm, or `~/.local/bin`.
-> Without `SSH_AUTH_SOCK`, git operations over SSH (push, pull, clone) will fail because the agent socket isn't inherited.
-> Adjust the `PATH` to match your own tool installation paths.
-> `%t` expands to `$XDG_RUNTIME_DIR` (e.g. `/run/user/1000`), where most SSH agents write their socket.
-
-**`~/.config/systemd/user/openchamber.service`**
-```ini
-[Unit]
-Description=OpenChamber Web Server
-After=opencode.service
-
-[Service]
-Type=simple
-ExecStart=openchamber serve --port 3000 --host 0.0.0.0 --ui-password your-password --foreground
-Environment="OPENCODE_HOST=http://localhost:4095"
-Environment="OPENCODE_SKIP_START=true"
-Restart=on-failure
-RestartSec=5
-
-[Install]
-WantedBy=default.target
-```
-
-```bash
-systemctl --user daemon-reload
-systemctl --user enable --now opencode openchamber
-```
-
-OpenChamber will be reachable at `http://:3000` from any device on your VPN.
-
-> **Note:** `--host 0.0.0.0` is required to listen on all interfaces. The default
-> bind address is `127.0.0.1` (localhost only). Use `--host ` or
-> `OPENCHAMBER_HOST=` to bind to a specific interface instead.
-
-
-
-
-Docker
-
-```bash
-docker compose up -d
-```
-
-Available at `http://localhost:3000`.
-
-**UI Password:**
-```yaml
-environment:
- UI_PASSWORD: your_secure_password
-```
-
-**Cloudflare Tunnel (optional):**
-```yaml
-environment:
- OPENCHAMBER_TUNNEL_MODE: quick # quick | managed-remote | managed-local
- OPENCHAMBER_TUNNEL_PROVIDER: cloudflare
-```
-
-For `managed-remote` mode, provide:
-
-```yaml
-environment:
- OPENCHAMBER_TUNNEL_MODE: managed-remote
- OPENCHAMBER_TUNNEL_HOSTNAME: app.example.com
- OPENCHAMBER_TUNNEL_TOKEN:
-```
-
-For `managed-local` mode, optionally provide:
-
-```yaml
-environment:
- OPENCHAMBER_TUNNEL_MODE: managed-local
- OPENCHAMBER_TUNNEL_CONFIG: /home/openchamber/.cloudflared/config.yml
-```
-
-Managed-local path note: `OPENCHAMBER_TUNNEL_CONFIG` must point to a path inside the container user home (`/home/openchamber/...`). If your Cloudflare config references a credentials JSON file, that file path must also be accessible inside the container (mount with `volumes`).
-
-### Reverse proxy notes
-
-- For a complete reverse proxy setup guide, see [`docs/REVERSE_PROXY.md`](./docs/REVERSE_PROXY.md).
-- Website docs source lives at `packages/docs/content/docs/reverse-proxy.mdx`.
-
-### 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:
-
-```bash
-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.
-
-
-
-
-## 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, Vim mode, 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, managed-remote, and managed-local 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 + Windows + Linux)
-
-- Floating Mini Chat: keep a small always-on-top assistant beside your editor, browser, or terminal
-- Multiple native windows for separate projects or sessions
-- Native notifications for task alerts while OpenChamber is hidden
-- One-click open in VS Code, Cursor, Terminal, Finder, Explorer, and more
-- Desktop host switcher for local and remote OpenChamber instances
-- Convenient tunnel management without manual setup
-- Deep-link connections for joining remote OpenChamber from a link
-- SSH remote access with host import, connection management, and port forwarding
-
-
-
-
-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](docs/CUSTOM_THEMES.md)
-
-
-
-
-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:
-
-- 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](https://opencode.ai) - For the excellent API and extensible architecture.
-- [Flexoki](https://github.com/kepano/flexoki) - Beautiful color scheme by [Steph Ango](https://stephango.com/flexoki).
-- [Pierre](https://pierrejs-docs.vercel.app/) - Fast, beautiful diff viewer with syntax highlighting.
-- [Ghostty-web](https://github.com/coder/ghostty-web) - Great implementation of a Ghostty web renderer.
-- [David Hill](https://x.com/iamdavidhill) - Who inspired me to release this without [overthinking](https://x.com/iamdavidhill/status/1993648326450020746).
-- [My wife](https://github.com/yulia-ivashko), 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.
+OpenChamber is an independent project and is not affiliated with the OpenCode team.
## Contributing
-See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup and guidelines.
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup and contribution guidelines. Documentation authoring guidance lives in [`packages/docs`](packages/docs/README.md).
-Docs source lives in [`packages/docs`](packages/docs/README.md).
+## Acknowledgments
+
+Special thanks to:
+
+- [OpenCode](https://opencode.ai) for its excellent API and extensible open-source architecture
+- [Pierre](https://pierrejs-docs.vercel.app/) for its fast diff viewer and syntax highlighting
+- [Ghostty-web](https://github.com/coder/ghostty-web) for its Ghostty web renderer
+- [Yulia Ivashko](https://github.com/yulia-ivashko), who built the firework celebration that plays on every successful push
+- Every contributor who shaped OpenChamber with code, ideas, and attention to detail
## License
diff --git a/bun.lock b/bun.lock
index 070da26b..15b89095 100644
--- a/bun.lock
+++ b/bun.lock
@@ -40,7 +40,6 @@
"@radix-ui/react-slot": "^1.2.3",
"@radix-ui/react-toggle": "^1.1.10",
"@radix-ui/react-tooltip": "^1.2.8",
- "@types/react-syntax-highlighter": "^15.5.13",
"@xenova/transformers": "^2.17.2",
"@zumer/snapdom": "^2.12.8",
"bun-pty": "^0.4.5",
@@ -55,9 +54,8 @@
"react": "^19.1.1",
"react-dom": "^19.1.1",
"react-markdown": "^10.1.0",
- "react-syntax-highlighter": "^15.6.6",
"remark-gfm": "^4.0.1",
- "simple-git": "^3.28.0",
+ "simple-git": "^3.36.0",
"sonner": "^2.0.7",
"tailwind-merge": "^3.3.1",
"yaml": "^2.8.1",
@@ -202,7 +200,7 @@
"remark-math": "^6.0.0",
"remend": "^1.2.1",
"shiki": "^3.23.0",
- "simple-git": "^3.28.0",
+ "simple-git": "^3.36.0",
"sonner": "^2.0.7",
"strip-json-comments": "^5.0.3",
"tailwind-merge": "^3.3.1",
@@ -286,7 +284,7 @@
"qrcode-terminal": "^0.12.0",
"reflect-metadata": "^0.2.2",
"sherpa-onnx-node": "1.12.28",
- "simple-git": "^3.28.0",
+ "simple-git": "^3.36.0",
"web-push": "^3.6.7",
"ws": "^8.18.3",
"yaml": "^2.8.1",
@@ -1260,6 +1258,10 @@
"@shikijs/vscode-textmate": ["@shikijs/vscode-textmate@10.0.2", "", {}, "sha512-83yeghZ2xxin3Nj8z1NMd/NCuca+gsYXswywDy5bHvwlWL8tpTQmzGeUuHd9FC3E/SBEMvzJRwWEOz5gGes9Qg=="],
+ "@simple-git/args-pathspec": ["@simple-git/args-pathspec@1.0.3", "", {}, "sha512-ngJMaHlsWDTfjyq9F3VIQ8b7NXbBLq5j9i5bJ6XLYtD6qlDXT7fdKY2KscWWUF8t18xx052Y/PUO1K1TRc9yKA=="],
+
+ "@simple-git/argv-parser": ["@simple-git/argv-parser@1.1.1", "", { "dependencies": { "@simple-git/args-pathspec": "^1.0.3" } }, "sha512-Q9lBcfQ+VQCpQqGJFHe5yooOS5hGdLFFbJ5R+R5aDsnkPCahtn1hSkMcORX65J2Z5lxSkD0lQorMsncuBQxYUw=="],
+
"@simplewebauthn/browser": ["@simplewebauthn/browser@13.3.0", "", {}, "sha512-BE/UWv6FOToAdVk0EokzkqQQDOWtNydYlY6+OrmiZ5SCNmb41VehttboTetUM3T/fr6EAFYVXjz4My2wg230rQ=="],
"@simplewebauthn/server": ["@simplewebauthn/server@13.3.1", "", { "dependencies": { "@hexagon/base64": "^1.1.27", "@levischuck/tiny-cbor": "^0.2.2", "@peculiar/asn1-android": "^2.6.0", "@peculiar/asn1-ecc": "^2.6.1", "@peculiar/asn1-rsa": "^2.6.1", "@peculiar/asn1-schema": "^2.6.0", "@peculiar/asn1-x509": "^2.6.1", "@peculiar/x509": "^1.14.3" } }, "sha512-GV/oM/qeycWn8p42JZIMJBsXWQcNFg+nJFzeQTnMA4gN8mXg0+HZFWJerHg8ZN/zlveMS3iV1wzuFpOVWS/46w=="],
@@ -1384,8 +1386,6 @@
"@types/react-dom": ["@types/react-dom@19.2.3", "", { "peerDependencies": { "@types/react": "^19.2.0" } }, "sha512-jp2L/eY6fn+KgVVQAOqYItbF0VY/YApe5Mz2F0aykSO8gx31bYCZyvSeYxCHKvzHG5eZjc+zyaS5BrBWya2+kQ=="],
- "@types/react-syntax-highlighter": ["@types/react-syntax-highlighter@15.5.13", "", { "dependencies": { "@types/react": "*" } }, "sha512-uLGJ87j6Sz8UaBAooU0T6lWJ0dBmjZgN1PZTrj05TNql2/XpC6+4HhMT5syIdFUUt+FASfCeLLv4kBygNU+8qA=="],
-
"@types/resolve": ["@types/resolve@1.20.2", "", {}, "sha512-60BCwRFOZCQhDncwQdxxeOEEkbc5dIMccYLwbxsS4TUNeVECQ/pBJ0j09mrHOl/JJvpRPGwO9SvE4nR2Nb/a4Q=="],
"@types/responselike": ["@types/responselike@1.0.3", "", { "dependencies": { "@types/node": "*" } }, "sha512-H/+L+UkTV33uf49PH5pCAUBVPNj2nDBXTN+qS1dOwyyg24l3CcicicCA7ca+HMvJBZcFgl5r8e+RR6elsb4Lyw=="],
@@ -1654,13 +1654,13 @@
"chalk": ["chalk@4.1.2", "", { "dependencies": { "ansi-styles": "^4.1.0", "supports-color": "^7.1.0" } }, "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA=="],
- "character-entities": ["character-entities@1.2.4", "", {}, "sha512-iBMyeEHxfVnIakwOuDXpVkc54HijNgCyQB2w0VfGQThle6NXn50zU6V/u+LDhxHcDUPojn6Kpga3PTAD8W1bQw=="],
+ "character-entities": ["character-entities@2.0.2", "", {}, "sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ=="],
"character-entities-html4": ["character-entities-html4@2.1.0", "", {}, "sha512-1v7fgQRj6hnSwFpq1Eu0ynr/CDEw0rXo2B61qXrLNdHZmPKgb7fqS1a2JwF0rISo9q77jDI8VMEHoApn8qDoZA=="],
- "character-entities-legacy": ["character-entities-legacy@1.1.4", "", {}, "sha512-3Xnr+7ZFS1uxeiUDvV02wQ+QDbc55o97tIV5zHScSPJpcLm/r0DFPcoY3tYRp+VZukxuMeKgXYmsXQHO05zQeA=="],
+ "character-entities-legacy": ["character-entities-legacy@3.0.0", "", {}, "sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ=="],
- "character-reference-invalid": ["character-reference-invalid@1.1.4", "", {}, "sha512-mKKUkUbhPpQlCOfIuZkvSEgktjPFIsZKRRbC6KWVEMvlzblj3i3asQv5ODsrwt0N3pHAEvjP8KTQPHkp0+6jOg=="],
+ "character-reference-invalid": ["character-reference-invalid@2.0.1", "", {}, "sha512-iBZ4F4wRbyORVsu0jPV7gXkOsGYjGHPmAyv+HiHG8gi5PtC9KI2j1+v8/tlibRvjoWX027ypmG/n0HtO5t7unw=="],
"cheerio": ["cheerio@1.2.0", "", { "dependencies": { "cheerio-select": "^2.1.0", "dom-serializer": "^2.0.0", "domhandler": "^5.0.3", "domutils": "^3.2.2", "encoding-sniffer": "^0.2.1", "htmlparser2": "^10.1.0", "parse5": "^7.3.0", "parse5-htmlparser2-tree-adapter": "^7.1.0", "parse5-parser-stream": "^7.1.2", "undici": "^7.19.0", "whatwg-mimetype": "^4.0.0" } }, "sha512-WDrybc/gKFpTYQutKIK6UvfcuxijIZfMfXaYm8NMsPQxSYvf+13fXUJ4rztGGbJcBQ/GF55gvrZ0Bc0bj/mqvg=="],
@@ -1996,8 +1996,6 @@
"fastq": ["fastq@1.20.1", "", { "dependencies": { "reusify": "^1.0.4" } }, "sha512-GGToxJ/w1x32s/D2EKND7kTil4n8OVk/9mycTc4VDza13lOvpUZTGX3mFSCtV9ksdGBVzvsyAVLM6mHFThxXxw=="],
- "fault": ["fault@1.0.4", "", { "dependencies": { "format": "^0.2.0" } }, "sha512-CJ0HCB5tL5fYTEA7ToAq5+kTwd++Borf1/bifxd9iT70QcXr4MRrO3Llf8Ifs70q+SJcGHFtnIE/Nw6giCtECA=="],
-
"fd-slicer": ["fd-slicer@1.1.0", "", { "dependencies": { "pend": "~1.2.0" } }, "sha512-cE1qsB/VwyQozZ+q1dGxR8LBYNZeofhEdUNGSMbQD3Gw2lAzX9Zb3uIU6Ebc/Fmyjo9AWWfnn0AUCHqtevs/8g=="],
"fdir": ["fdir@6.5.0", "", { "peerDependencies": { "picomatch": "^3 || ^4" }, "optionalPeers": ["picomatch"] }, "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg=="],
@@ -2034,8 +2032,6 @@
"form-data-encoder": ["form-data-encoder@1.7.2", "", {}, "sha512-qfqtYan3rxrnCk1VYaA4H+Ms9xdpPqvLZa6xmMgFvhO32x7/3J/ExcTd6qpxM0vH2GdMI+poehyBZvqfMTto8A=="],
- "format": ["format@0.2.2", "", {}, "sha512-wzsgA6WOq+09wrU1tsJ09udeR/YZRaeArL9e1wPbFg3GG2yDnC2ldKpxs4xunpFF9DgqCqOIra3bc1HWrJ37Ww=="],
-
"formdata-node": ["formdata-node@4.4.1", "", { "dependencies": { "node-domexception": "1.0.0", "web-streams-polyfill": "4.0.0-beta.3" } }, "sha512-0iirZp3uVDjVGt9p49aTaqjk84TrglENEDuqfdlZQ1roC9CWlPk6Avf8EEnZNcAqPonwkG35x4n3ww/1THYAeQ=="],
"formidable": ["formidable@3.5.4", "", { "dependencies": { "@paralleldrive/cuid2": "^2.2.2", "dezalgo": "^1.0.4", "once": "^1.4.0" } }, "sha512-YikH+7CUTOtP44ZTnUhR7Ic2UASBPOqmaRkRKxRbywPTe5VxF7RRCck4af9wutiZ/QKM5nME9Bie2fFaPz5Gug=="],
@@ -2136,7 +2132,7 @@
"hast-util-is-element": ["hast-util-is-element@3.0.0", "", { "dependencies": { "@types/hast": "^3.0.0" } }, "sha512-Val9mnv2IWpLbNPqc/pUem+a7Ipj2aHacCwgNfTiK0vJKl0LF+4Ba4+v1oPHFpf3bLYmreq0/l3Gud9S5OH42g=="],
- "hast-util-parse-selector": ["hast-util-parse-selector@2.2.5", "", {}, "sha512-7j6mrk/qqkSehsM92wQjdIgWM2/BW61u/53G6xmC8i1OmEdKLHbk419QKQUjz6LglWsfqoiHmyMRkP1BGjecNQ=="],
+ "hast-util-parse-selector": ["hast-util-parse-selector@4.0.0", "", { "dependencies": { "@types/hast": "^3.0.0" } }, "sha512-wkQCkSYoOGCRKERFWcxMVMOcYE2K1AaNLU8DXS9arxnLOUEWbOXKXiJUNzEpqZ3JOKpnha3jkFrumEjVliDe7A=="],
"hast-util-to-html": ["hast-util-to-html@9.0.5", "", { "dependencies": { "@types/hast": "^3.0.0", "@types/unist": "^3.0.0", "ccount": "^2.0.0", "comma-separated-tokens": "^2.0.0", "hast-util-whitespace": "^3.0.0", "html-void-elements": "^3.0.0", "mdast-util-to-hast": "^13.0.0", "property-information": "^7.0.0", "space-separated-tokens": "^2.0.0", "stringify-entities": "^4.0.0", "zwitch": "^2.0.4" } }, "sha512-OguPdidb+fbHQSU4Q4ZiLKnzWo8Wwsf5bZfbvu7//a9oTYoqD/fWpe96NuHkoS9h0ccGOTe0C4NGXdtS0iObOw=="],
@@ -2146,14 +2142,10 @@
"hast-util-whitespace": ["hast-util-whitespace@3.0.0", "", { "dependencies": { "@types/hast": "^3.0.0" } }, "sha512-88JUN06ipLwsnv+dVn+OIYOvAuvBMy/Qoi6O7mQHxdPXpjy+Cd6xRkWwux7DKO+4sYILtLBRIKgsdpS2gQc7qw=="],
- "hastscript": ["hastscript@6.0.0", "", { "dependencies": { "@types/hast": "^2.0.0", "comma-separated-tokens": "^1.0.0", "hast-util-parse-selector": "^2.0.0", "property-information": "^5.0.0", "space-separated-tokens": "^1.0.0" } }, "sha512-nDM6bvd7lIqDUiYEiu5Sl/+6ReP0BMk/2f4U/Rooccxkj0P5nm+acM5PrGJ/t5I8qPGiqZSE6hVAwZEdZIvP4w=="],
+ "hastscript": ["hastscript@9.0.1", "", { "dependencies": { "@types/hast": "^3.0.0", "comma-separated-tokens": "^2.0.0", "hast-util-parse-selector": "^4.0.0", "property-information": "^7.0.0", "space-separated-tokens": "^2.0.0" } }, "sha512-g7df9rMFX/SPi34tyGCyUBREQoKkapwdY/T04Qn9TDWfHhAYt4/I0gMVirzK5wEzeUqIjEB+LXC/ypb7Aqno5w=="],
"heic2any": ["heic2any@0.0.4", "", {}, "sha512-3lLnZiDELfabVH87htnRolZ2iehX9zwpRyGNz22GKXIu0fznlblf0/ftppXKNqS26dqFSeqfIBhAmAj/uSp0cA=="],
- "highlight.js": ["highlight.js@10.7.3", "", {}, "sha512-tzcUFauisWKNHaRkN4Wjl/ZA07gENAjFl3J/c480dprkGTg5EQstgaNFqBfUqCq54kZRIEcreTsAgF/m2quD7A=="],
-
- "highlightjs-vue": ["highlightjs-vue@1.0.0", "", {}, "sha512-PDEfEF102G23vHmPhLyPboFCD+BkMGu+GuJe2d9/eH4FsCwvgBpnc9n0pGE+ffKdph38s6foEZiEjdgHdzp+IA=="],
-
"hosted-git-info": ["hosted-git-info@4.1.0", "", { "dependencies": { "lru-cache": "^6.0.0" } }, "sha512-kyCuEOWjJqZuDbRHzL8V93NzQhwIB71oFWSyzVo+KPZI+pnQPPxucdkrOZvkLRnrf5URsQM+IJ09Dw29cRALIA=="],
"html-to-image": ["html-to-image@1.11.13", "", {}, "sha512-cuOPoI7WApyhBElTTb9oqsawRvZ0rHhaHwghRLlTuffoD1B2aDemlCruLeZrUIIdvG7gs9xeELEPm6PhuASqrg=="],
@@ -2222,9 +2214,9 @@
"ipaddr.js": ["ipaddr.js@1.9.1", "", {}, "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g=="],
- "is-alphabetical": ["is-alphabetical@1.0.4", "", {}, "sha512-DwzsA04LQ10FHTZuL0/grVDk4rFoVH1pjAToYwBrHSxcrBIGQuXrQMtD5U1b0U2XVgKZCTLLP8u2Qxqhy3l2Vg=="],
+ "is-alphabetical": ["is-alphabetical@2.0.1", "", {}, "sha512-FWyyY60MeTNyeSRpkM2Iry0G9hpr7/9kD40mD/cGQEuilcZYS4okz8SN2Q6rLCJ8gbCt6fN+rC+6tMGS99LaxQ=="],
- "is-alphanumerical": ["is-alphanumerical@1.0.4", "", { "dependencies": { "is-alphabetical": "^1.0.0", "is-decimal": "^1.0.0" } }, "sha512-UzoZUr+XfVz3t3v4KyGEniVL9BDRoQtY7tOyrRybkVNjDFWyo1yhXNGrrBTQxp3ib9BLAWs7k2YKBQsFRkZG9A=="],
+ "is-alphanumerical": ["is-alphanumerical@2.0.1", "", { "dependencies": { "is-alphabetical": "^2.0.0", "is-decimal": "^2.0.0" } }, "sha512-hmbYhX/9MUMF5uh7tOXyK/n0ZvWpad5caBA17GsC6vyuCqaWliRG5K1qS9inmUhEMaOBIW7/whAnSwveW/LtZw=="],
"is-array-buffer": ["is-array-buffer@3.0.5", "", { "dependencies": { "call-bind": "^1.0.8", "call-bound": "^1.0.3", "get-intrinsic": "^1.2.6" } }, "sha512-DDfANUiiG2wC1qawP66qlTugJeL5HyzMpfr8lLK+jMQirGzNod0B12cFB/9q838Ru27sBwfw78/rdoU7RERz6A=="],
@@ -2246,7 +2238,7 @@
"is-date-object": ["is-date-object@1.1.0", "", { "dependencies": { "call-bound": "^1.0.2", "has-tostringtag": "^1.0.2" } }, "sha512-PwwhEakHVKTdRNVOw+/Gyh0+MzlCl4R6qKvkhuvLtPMggI1WAHt9sOwZxQLSGpUaDnrdyDsomoRgNnCfKNSXXg=="],
- "is-decimal": ["is-decimal@1.0.4", "", {}, "sha512-RGdriMmQQvZ2aqaQq3awNA6dCGtKpiDFcOzrTWrDAT2MiWrKQVPmxLGHl7Y2nNu6led0kEyoX0enY0qXYsv9zw=="],
+ "is-decimal": ["is-decimal@2.0.1", "", {}, "sha512-AAB9hiomQs5DXWcRB1rqsxGUstbRroFOPPVAomNk/3XHR5JyEZChOyTWe2oayKnsSsr/kcGqF+z6yuH6HHpN0A=="],
"is-docker": ["is-docker@2.2.1", "", { "bin": { "is-docker": "cli.js" } }, "sha512-F+i2BKsFrH66iaUFc0woD8sLy8getkwTwtOBjvs56Cx4CgJDeKQeqfz8wAYiSb8JOprWhHH5p77PbmYCvvUuXQ=="],
@@ -2260,7 +2252,7 @@
"is-glob": ["is-glob@4.0.3", "", { "dependencies": { "is-extglob": "^2.1.1" } }, "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg=="],
- "is-hexadecimal": ["is-hexadecimal@1.0.4", "", {}, "sha512-gyPJuv83bHMpocVYoqof5VDiZveEoGoFL8m3BXNb2VW8Xs+rz9kqO8LOQ5DH6EsuvilT1ApazU0pyl+ytbPtlw=="],
+ "is-hexadecimal": ["is-hexadecimal@2.0.1", "", {}, "sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg=="],
"is-inside-container": ["is-inside-container@1.0.0", "", { "dependencies": { "is-docker": "^3.0.0" }, "bin": { "is-inside-container": "cli.js" } }, "sha512-KIYLCCJghfHZxqjYBE7rEy0OBuTd5xCHS7tHVgvCLkx7StIoaxwNW3hCALgEUjFfeRk+MG/Qxmp/vtETEF3tRA=="],
@@ -2446,8 +2438,6 @@
"lowercase-keys": ["lowercase-keys@2.0.0", "", {}, "sha512-tqNXrS78oMOE73NMxK4EMLQsQowWf8jKooH9g7xPavRT706R6bkQJ6DY2Te7QukaZsulxa30wQ7bk0pm4XiHmA=="],
- "lowlight": ["lowlight@1.20.0", "", { "dependencies": { "fault": "^1.0.0", "highlight.js": "~10.7.0" } }, "sha512-8Ktj+prEb1RoCPkEOrPMYUN/nCggB7qAWe3a7OpMjWQkh3l2RD5wKRQ+o8Q8YuI9RG/xs95waaI/E6ym/7NsTw=="],
-
"lru-cache": ["lru-cache@6.0.0", "", { "dependencies": { "yallist": "^4.0.0" } }, "sha512-Jo6dJ04CmSjuznwJSS3pUeWmd/H0ffTlkXXgwZi+eq1UCmqQwCh+eLsYOYCwY991i2Fah4h1BEMCx4qThGbsiA=="],
"lru_map": ["lru_map@0.4.1", "", {}, "sha512-I+lBvqMMFfqaV8CJCISjI3wbjmwVu/VyOoU7+qtu9d7ioW5klMgsTTiUOUp+DJvfTTzKXoPbyC6YfgkNcyPSOg=="],
@@ -2714,7 +2704,7 @@
"parent-module": ["parent-module@1.0.1", "", { "dependencies": { "callsites": "^3.0.0" } }, "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g=="],
- "parse-entities": ["parse-entities@2.0.0", "", { "dependencies": { "character-entities": "^1.0.0", "character-entities-legacy": "^1.0.0", "character-reference-invalid": "^1.0.0", "is-alphanumerical": "^1.0.0", "is-decimal": "^1.0.0", "is-hexadecimal": "^1.0.0" } }, "sha512-kkywGpCcRYhqQIchaWqZ875wzpS/bMKhz5HnN3p7wveJTkTtyAB/AlnS0f8DFSqYW1T82t6yEAkEcB+A1I3MbQ=="],
+ "parse-entities": ["parse-entities@4.0.2", "", { "dependencies": { "@types/unist": "^2.0.0", "character-entities-legacy": "^3.0.0", "character-reference-invalid": "^2.0.0", "decode-named-character-reference": "^1.0.0", "is-alphanumerical": "^2.0.0", "is-decimal": "^2.0.0", "is-hexadecimal": "^2.0.0" } }, "sha512-GG2AQYWoLgL877gQIKeRPGO1xF9+eG1ujIb5soS5gPvLQ1y2o8FL90w2QWNdf9I361Mpp7726c+lj3U0qK1uGw=="],
"parse-json": ["parse-json@8.3.0", "", { "dependencies": { "@babel/code-frame": "^7.26.2", "index-to-position": "^1.1.0", "type-fest": "^4.39.1" } }, "sha512-ybiGyvspI+fAoRQbIPRddCcSTV9/LsJbf0e/S85VLowVGzRmokfneg2kwVW/KU5rOXrPSbF1qAKPMgNTqqROQQ=="],
@@ -2776,8 +2766,6 @@
"pretty-bytes": ["pretty-bytes@6.1.1", "", {}, "sha512-mQUvGU6aUFQ+rNvTIAcZuWGRT9a6f6Yrg9bHs4ImKF+HZCEK+plBvnAZYSIQztknZF2qnzNtr6F8s0+IuptdlQ=="],
- "prismjs": ["prismjs@1.30.0", "", {}, "sha512-DEvV2ZF2r2/63V+tK8hQvrR2ZGn10srHbXviTlcv7Kpzw8jWiNTqbVgjO3IY8RxrrOUF8VPMQQFysYYYv0YZxw=="],
-
"proc-log": ["proc-log@2.0.1", "", {}, "sha512-Kcmo2FhfDTXdcbfDH76N7uBYHINxc/8GW7UAVuVP9I+Va3uHSerrnKV6dLooga/gh7GlgzuCCr/eoldnL1muGw=="],
"progress": ["progress@2.0.3", "", {}, "sha512-7PiHtLll5LdnKIMw100I+8xJXR5gW2QwWYkT6iJva0bXitZKa/XMrSbdmg3r2Xnaidz9Qumd0VPaMrZlF9V9sA=="],
@@ -2846,8 +2834,6 @@
"react-style-singleton": ["react-style-singleton@2.2.3", "", { "dependencies": { "get-nonce": "^1.0.0", "tslib": "^2.0.0" }, "peerDependencies": { "@types/react": "*", "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react"] }, "sha512-b6jSvxvVnyptAiLjbkWLE/lOnR4lfTtDAl+eUC7RZy+QQWc6wRzIV2CE6xBuMmDxc2qIihtDCZD5NPOFl7fRBQ=="],
- "react-syntax-highlighter": ["react-syntax-highlighter@15.6.6", "", { "dependencies": { "@babel/runtime": "^7.3.1", "highlight.js": "^10.4.1", "highlightjs-vue": "^1.0.0", "lowlight": "^1.17.0", "prismjs": "^1.30.0", "refractor": "^3.6.0" }, "peerDependencies": { "react": ">= 0.14.0" } }, "sha512-DgXrc+AZF47+HvAPEmn7Ua/1p10jNoVZVI/LoPiYdtY+OM+/nG5yefLHKJwdKqY1adMuHFbeyBaG9j64ML7vTw=="],
-
"read": ["read@1.0.7", "", { "dependencies": { "mute-stream": "~0.0.4" } }, "sha512-rSOKNYUmaxy0om1BNjMN4ezNT6VKK+2xF4GBhc81mkH7L60i6dp8qPYrkndNLT3QPphoII3maL9PVC9XmhHwVQ=="],
"read-binary-file-arch": ["read-binary-file-arch@1.0.6", "", { "dependencies": { "debug": "^4.3.4" }, "bin": { "read-binary-file-arch": "cli.js" } }, "sha512-BNg9EN3DD3GsDXX7Aa8O4p92sryjkmzYYgmgTAc6CA4uGLEDzFfxOxugu21akOxpcXHiEgsYkC6nPsQvLLLmEg=="],
@@ -2862,8 +2848,6 @@
"reflect.getprototypeof": ["reflect.getprototypeof@1.0.10", "", { "dependencies": { "call-bind": "^1.0.8", "define-properties": "^1.2.1", "es-abstract": "^1.23.9", "es-errors": "^1.3.0", "es-object-atoms": "^1.0.0", "get-intrinsic": "^1.2.7", "get-proto": "^1.0.1", "which-builtin-type": "^1.2.1" } }, "sha512-00o4I+DVrefhv+nX0ulyi3biSHCPDe+yLv5o/p6d/UVlirijB8E16FtfwSAi4g3tcqrQ4lRAqQSoFEZJehYEcw=="],
- "refractor": ["refractor@3.6.0", "", { "dependencies": { "hastscript": "^6.0.0", "parse-entities": "^2.0.0", "prismjs": "~1.27.0" } }, "sha512-MY9W41IOWxxk31o+YvFCNyNzdkc9M20NoZK5vq6jkv4I/uh2zkWcfudj0Q1fovjUQJrNewS9NMzeTtqPf+n5EA=="],
-
"regenerate": ["regenerate@1.4.2", "", {}, "sha512-zrceR/XhGYU/d/opr2EKO7aRHUeiBI8qjtfHqADTwZd6Szfy16la6kqD0MIUs5z5hx6AaKa+PixpPrR289+I0A=="],
"regenerate-unicode-properties": ["regenerate-unicode-properties@10.2.2", "", { "dependencies": { "regenerate": "^1.4.2" } }, "sha512-m03P+zhBeQd1RGnYxrGyDAPpWX/epKirLrp8e3qevZdVkKtnCrjjWczIbYc8+xd6vcTStVlqfycTx1KR4LOr0g=="],
@@ -3020,7 +3004,7 @@
"simple-get": ["simple-get@4.0.1", "", { "dependencies": { "decompress-response": "^6.0.0", "once": "^1.3.1", "simple-concat": "^1.0.0" } }, "sha512-brv7p5WgH0jmQJr1ZDDfKDOSeWWg+OVypG99A/5vYGPqJ6pxiaHLy8nxtFjBA7oMa01ebA9gfh1uMCFqOuXxvA=="],
- "simple-git": ["simple-git@3.32.3", "", { "dependencies": { "@kwsites/file-exists": "^1.1.1", "@kwsites/promise-deferred": "^1.1.1", "debug": "^4.4.0" } }, "sha512-56a5oxFdWlsGygOXHWrG+xjj5w9ZIt2uQbzqiIGdR/6i5iococ7WQ/bNPzWxCJdEUGUCmyMH0t9zMpRJTaKxmw=="],
+ "simple-git": ["simple-git@3.36.0", "", { "dependencies": { "@kwsites/file-exists": "^1.1.1", "@kwsites/promise-deferred": "^1.1.1", "@simple-git/args-pathspec": "^1.0.3", "@simple-git/argv-parser": "^1.1.0", "debug": "^4.4.0" } }, "sha512-cGQjLjK8bxJw4QuYT7gxHw3/IouVESbhahSsHrX97MzCL1gu2u7oy38W6L2ZIGECEfIBG4BabsWDPjBxJENv9Q=="],
"simple-swizzle": ["simple-swizzle@0.2.4", "", { "dependencies": { "is-arrayish": "^0.3.1" } }, "sha512-nAu1WFPQSMNr2Zn9PGSZK9AGn4t/y97lEm+MXTtUDwfP0ksAIX4nO+6ruD9Jwut4C49SB1Ws+fbXsm/yScWOHw=="],
@@ -3408,8 +3392,6 @@
"xmlbuilder": ["xmlbuilder@15.1.1", "", {}, "sha512-yMqGBqtXyeN1e3TGYvgNgDVZ3j84W4cwkOXQswghol6APgZWaff9lnbvN7MHYJOiXsvGPXtjTYJEiC9J2wv9Eg=="],
- "xtend": ["xtend@4.0.2", "", {}, "sha512-LKYU1iAXJXUgAXn9URjiu+MWhyUXHsvfp7mcuYm9dSUKK0/CjtrUwFAxD82/mCWbtLsGjFIad0wIsod4zrTAEQ=="],
-
"y18n": ["y18n@5.0.8", "", {}, "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA=="],
"yallist": ["yallist@4.0.0", "", {}, "sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A=="],
@@ -3606,8 +3588,6 @@
"compression/debug": ["debug@2.6.9", "", { "dependencies": { "ms": "2.0.0" } }, "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA=="],
- "decode-named-character-reference/character-entities": ["character-entities@2.0.2", "", {}, "sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ=="],
-
"dmg-builder/iconv-lite": ["iconv-lite@0.6.3", "", { "dependencies": { "safer-buffer": ">= 2.1.2 < 3.0.0" } }, "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw=="],
"dom-serializer/entities": ["entities@4.5.0", "", {}, "sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw=="],
@@ -3642,18 +3622,6 @@
"globby/slash": ["slash@5.1.0", "", {}, "sha512-ZA6oR3T/pEyuqwMgAKT0/hAv8oAXckzbkmR0UkUosQ+Mc4RxGoJkRmwHgHufaenlyAgE1Mxgpdcrf75y6XcnDg=="],
- "hast-util-from-dom/hastscript": ["hastscript@9.0.1", "", { "dependencies": { "@types/hast": "^3.0.0", "comma-separated-tokens": "^2.0.0", "hast-util-parse-selector": "^4.0.0", "property-information": "^7.0.0", "space-separated-tokens": "^2.0.0" } }, "sha512-g7df9rMFX/SPi34tyGCyUBREQoKkapwdY/T04Qn9TDWfHhAYt4/I0gMVirzK5wEzeUqIjEB+LXC/ypb7Aqno5w=="],
-
- "hast-util-from-parse5/hastscript": ["hastscript@9.0.1", "", { "dependencies": { "@types/hast": "^3.0.0", "comma-separated-tokens": "^2.0.0", "hast-util-parse-selector": "^4.0.0", "property-information": "^7.0.0", "space-separated-tokens": "^2.0.0" } }, "sha512-g7df9rMFX/SPi34tyGCyUBREQoKkapwdY/T04Qn9TDWfHhAYt4/I0gMVirzK5wEzeUqIjEB+LXC/ypb7Aqno5w=="],
-
- "hastscript/@types/hast": ["@types/hast@2.3.10", "", { "dependencies": { "@types/unist": "^2" } }, "sha512-McWspRw8xx8J9HurkVBfYj0xKoE25tOFlHGdx4MJ5xORQrMGZNqJhVQWaIbm6Oyla5kYOXtDiopzKRJzEOkwJw=="],
-
- "hastscript/comma-separated-tokens": ["comma-separated-tokens@1.0.8", "", {}, "sha512-GHuDRO12Sypu2cV70d1dkA2EUmXHgntrzbpvOB+Qy+49ypNfGgFQIC2fhhXbnyrJRynDCAARsT7Ou0M6hirpfw=="],
-
- "hastscript/property-information": ["property-information@5.6.0", "", { "dependencies": { "xtend": "^4.0.0" } }, "sha512-YUHSPk+A30YPv+0Qf8i9Mbfe/C0hdPXk1s1jPVToV8pk8BQtpw10ct89Eo7OWkutrwqvT0eicAxlOg3dOAu8JA=="],
-
- "hastscript/space-separated-tokens": ["space-separated-tokens@1.1.5", "", {}, "sha512-q/JSVd1Lptzhf5bkYm4ob4iWPjx0KiRe3sRFBNrVqbJkFaBm5vbbowy1mymoPNLRa52+oadOhJ+K49wsSeSjTA=="],
-
"iconv-corefoundation/cli-truncate": ["cli-truncate@2.1.0", "", { "dependencies": { "slice-ansi": "^3.0.0", "string-width": "^4.2.0" } }, "sha512-n8fOixwDD6b/ObinzTrp1ZKFzbgvKZvuz/TvejnLn1aQfC6r52XEx85FmuC+3HI+JM7coBRXUvNqEU2PHVrHpg=="],
"iconv-corefoundation/node-addon-api": ["node-addon-api@1.7.2", "", {}, "sha512-ibPK3iA+vaY1eEjESkQkM0BbCqFOaZMiXRTtdB0u7b4djtY6JnsjvPdUHVMg6xQt3B8fpTTWHI9A+ADjM9frzg=="],
@@ -3676,8 +3644,6 @@
"mdast-util-find-and-replace/escape-string-regexp": ["escape-string-regexp@5.0.0", "", {}, "sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw=="],
- "mdast-util-mdx-jsx/parse-entities": ["parse-entities@4.0.2", "", { "dependencies": { "@types/unist": "^2.0.0", "character-entities-legacy": "^3.0.0", "character-reference-invalid": "^2.0.0", "decode-named-character-reference": "^1.0.0", "is-alphanumerical": "^2.0.0", "is-decimal": "^2.0.0", "is-hexadecimal": "^2.0.0" } }, "sha512-GG2AQYWoLgL877gQIKeRPGO1xF9+eG1ujIb5soS5gPvLQ1y2o8FL90w2QWNdf9I361Mpp7726c+lj3U0qK1uGw=="],
-
"micromark-extension-math/katex": ["katex@0.16.45", "", { "dependencies": { "commander": "^8.3.0" }, "bin": { "katex": "cli.js" } }, "sha512-pQpZbdBu7wCTmQUh7ufPmLr0pFoObnGUoL/yhtwJDgmmQpbkg/0HSVti25Fu4rmd1oCR6NGWe9vqTWuWv3GcNA=="],
"micromatch/picomatch": ["picomatch@2.3.1", "", {}, "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA=="],
@@ -3714,6 +3680,8 @@
"openai/@types/node": ["@types/node@18.19.130", "", { "dependencies": { "undici-types": "~5.26.4" } }, "sha512-GRaXQx6jGfL8sKfaIDD6OupbIHBr9jv7Jnaml9tB7l4v068PAOXqfcujMMo5PhbIs6ggR1XODELqahT2R8v0fg=="],
+ "parse-entities/@types/unist": ["@types/unist@2.0.11", "", {}, "sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA=="],
+
"parse-json/type-fest": ["type-fest@4.41.0", "", {}, "sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA=="],
"parse-semver/semver": ["semver@5.7.2", "", { "bin": { "semver": "bin/semver" } }, "sha512-cBznnQ9KjJqU67B52RMC65CMarK2600WFnbkcaiwWq3xy/5haFJlshgnpjovMVJ+Hff49d8GEn0b87C5pDQ10g=="],
@@ -3736,16 +3704,12 @@
"rc/strip-json-comments": ["strip-json-comments@2.0.1", "", {}, "sha512-4gB8na07fecVVkOI6Rs4e7T6NOTki5EmL7TUduTs6bu3EdnSycntVJ4re8kgZA+wx9IueI2Y11bfbgwtzuE0KQ=="],
- "react-syntax-highlighter/@babel/runtime": ["@babel/runtime@7.28.6", "", {}, "sha512-05WQkdpL9COIMz4LjTxGpPNCdlpyimKppYNoJ5Di5EUObifl8t4tuLuUBBZEpoLYOmfvIWrsp9fCl0HoPRVTdA=="],
-
"read-pkg/type-fest": ["type-fest@4.41.0", "", {}, "sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA=="],
"read-pkg/unicorn-magic": ["unicorn-magic@0.1.0", "", {}, "sha512-lRfVq8fE8gz6QMBuDM6a+LO3IAzTi05H6gCVaUpir2E1Rwpo4ZUog45KpNXKC/Mn3Yb9UDuHumeFTo9iV/D9FQ=="],
"readdirp/picomatch": ["picomatch@2.3.1", "", {}, "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA=="],
- "refractor/prismjs": ["prismjs@1.27.0", "", {}, "sha512-t13BGPUlFDR7wRB5kQDG4jjl7XeuH6jbJGt11JHPL96qwsEHNX2+68tFXqc1/k+/jALsbSWJKUOT/hcYAZ5LkA=="],
-
"rehype-katex/katex": ["katex@0.16.45", "", { "dependencies": { "commander": "^8.3.0" }, "bin": { "katex": "cli.js" } }, "sha512-pQpZbdBu7wCTmQUh7ufPmLr0pFoObnGUoL/yhtwJDgmmQpbkg/0HSVti25Fu4rmd1oCR6NGWe9vqTWuWv3GcNA=="],
"rimraf/glob": ["glob@13.0.6", "", { "dependencies": { "minimatch": "^10.2.2", "minipass": "^7.1.3", "path-scurry": "^2.0.2" } }, "sha512-Wjlyrolmm8uDpm/ogGyXZXb1Z+Ca2B8NbJwqBVg0axK9GbBeoS7yGV6vjXnYdGm6X53iehEuxxbyiKp8QmN4Vw=="],
@@ -3768,8 +3732,6 @@
"ssri/minipass": ["minipass@3.3.6", "", { "dependencies": { "yallist": "^4.0.0" } }, "sha512-DxiNidxSEK+tHG6zOIklvNOwm3hvCrbUrdtzY74U6HKTJxvIDfOUL5W5P2Ghd3DTkhhKPYGqeNUIh5qcM4YBfw=="],
- "stringify-entities/character-entities-legacy": ["character-entities-legacy@3.0.0", "", {}, "sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ=="],
-
"superagent/mime": ["mime@2.6.0", "", { "bin": { "mime": "cli.js" } }, "sha512-USPkMeET31rOMiarsBNIHZKLGgvKc/LrjofAnBlOttf5ajRvqiRA8QsenbcooctK6d6Ts6aqZXBA+XbkKthiQg=="],
"supports-hyperlinks/supports-color": ["supports-color@7.2.0", "", { "dependencies": { "has-flag": "^4.0.0" } }, "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw=="],
@@ -3886,30 +3848,12 @@
"glob/minimatch/brace-expansion": ["brace-expansion@5.0.4", "", { "dependencies": { "balanced-match": "^4.0.2" } }, "sha512-h+DEnpVvxmfVefa4jFbCf5HdH5YMDXRsmKflpf1pILZWRFlTbJpxeU55nJl4Smt5HQaGzg1o6RHFPJaOqnmBDg=="],
- "hast-util-from-dom/hastscript/hast-util-parse-selector": ["hast-util-parse-selector@4.0.0", "", { "dependencies": { "@types/hast": "^3.0.0" } }, "sha512-wkQCkSYoOGCRKERFWcxMVMOcYE2K1AaNLU8DXS9arxnLOUEWbOXKXiJUNzEpqZ3JOKpnha3jkFrumEjVliDe7A=="],
-
- "hast-util-from-parse5/hastscript/hast-util-parse-selector": ["hast-util-parse-selector@4.0.0", "", { "dependencies": { "@types/hast": "^3.0.0" } }, "sha512-wkQCkSYoOGCRKERFWcxMVMOcYE2K1AaNLU8DXS9arxnLOUEWbOXKXiJUNzEpqZ3JOKpnha3jkFrumEjVliDe7A=="],
-
- "hastscript/@types/hast/@types/unist": ["@types/unist@2.0.11", "", {}, "sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA=="],
-
"iconv-corefoundation/cli-truncate/slice-ansi": ["slice-ansi@3.0.0", "", { "dependencies": { "ansi-styles": "^4.0.0", "astral-regex": "^2.0.0", "is-fullwidth-code-point": "^3.0.0" } }, "sha512-pSyv7bSTC7ig9Dcgbw9AuRNUb5k5V6oDudjZoMBSr13qpLBG7tB+zgCkARjq7xIUgdz5P1Qe8u+rSGdouOOIyQ=="],
"make-fetch-happen/http-proxy-agent/agent-base": ["agent-base@6.0.2", "", { "dependencies": { "debug": "4" } }, "sha512-RZNwNclF7+MS/8bDg70amg32dyeZGZxiDuQmZxKLAlQjr3jGyLx+4Kkk58UO7D2QdgFIQCovuSuZESne6RG6XQ=="],
"make-fetch-happen/https-proxy-agent/agent-base": ["agent-base@6.0.2", "", { "dependencies": { "debug": "4" } }, "sha512-RZNwNclF7+MS/8bDg70amg32dyeZGZxiDuQmZxKLAlQjr3jGyLx+4Kkk58UO7D2QdgFIQCovuSuZESne6RG6XQ=="],
- "mdast-util-mdx-jsx/parse-entities/@types/unist": ["@types/unist@2.0.11", "", {}, "sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA=="],
-
- "mdast-util-mdx-jsx/parse-entities/character-entities-legacy": ["character-entities-legacy@3.0.0", "", {}, "sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ=="],
-
- "mdast-util-mdx-jsx/parse-entities/character-reference-invalid": ["character-reference-invalid@2.0.1", "", {}, "sha512-iBZ4F4wRbyORVsu0jPV7gXkOsGYjGHPmAyv+HiHG8gi5PtC9KI2j1+v8/tlibRvjoWX027ypmG/n0HtO5t7unw=="],
-
- "mdast-util-mdx-jsx/parse-entities/is-alphanumerical": ["is-alphanumerical@2.0.1", "", { "dependencies": { "is-alphabetical": "^2.0.0", "is-decimal": "^2.0.0" } }, "sha512-hmbYhX/9MUMF5uh7tOXyK/n0ZvWpad5caBA17GsC6vyuCqaWliRG5K1qS9inmUhEMaOBIW7/whAnSwveW/LtZw=="],
-
- "mdast-util-mdx-jsx/parse-entities/is-decimal": ["is-decimal@2.0.1", "", {}, "sha512-AAB9hiomQs5DXWcRB1rqsxGUstbRroFOPPVAomNk/3XHR5JyEZChOyTWe2oayKnsSsr/kcGqF+z6yuH6HHpN0A=="],
-
- "mdast-util-mdx-jsx/parse-entities/is-hexadecimal": ["is-hexadecimal@2.0.1", "", {}, "sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg=="],
-
"micromark-extension-math/katex/commander": ["commander@8.3.0", "", {}, "sha512-OkTL9umf+He2DZkUq8f8J9of7yL6RJKI24dVITBmNfZBmri9zYZQrKkuXiKhyfPSu8tUhnVBB1iKXevvnlR4Ww=="],
"node-gyp/make-fetch-happen/cacache": ["cacache@19.0.1", "", { "dependencies": { "@npmcli/fs": "^4.0.0", "fs-minipass": "^3.0.0", "glob": "^10.2.2", "lru-cache": "^10.0.1", "minipass": "^7.0.3", "minipass-collect": "^2.0.1", "minipass-flush": "^1.0.5", "minipass-pipeline": "^1.2.4", "p-map": "^7.0.2", "ssri": "^12.0.0", "tar": "^7.4.3", "unique-filename": "^4.0.0" } }, "sha512-hdsUxulXCi5STId78vRVYEtDAjq99ICAUktLTeTYsLoTE6Z8dS0c8pWNCxwdrk9YfJeobDZc2Y186hD/5ZQgFQ=="],
@@ -4090,8 +4034,6 @@
"glob/minimatch/brace-expansion/balanced-match": ["balanced-match@4.0.4", "", {}, "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA=="],
- "mdast-util-mdx-jsx/parse-entities/is-alphanumerical/is-alphabetical": ["is-alphabetical@2.0.1", "", {}, "sha512-FWyyY60MeTNyeSRpkM2Iry0G9hpr7/9kD40mD/cGQEuilcZYS4okz8SN2Q6rLCJ8gbCt6fN+rC+6tMGS99LaxQ=="],
-
"node-gyp/make-fetch-happen/cacache/@npmcli/fs": ["@npmcli/fs@4.0.0", "", { "dependencies": { "semver": "^7.3.5" } }, "sha512-/xGlezI6xfGO9NwuJlnwz/K14qD1kCSAGtacBHnGzeAIuJGazcp45KP5NuyARXoKb7cwulAGWVsbeSxdG/cb0Q=="],
"node-gyp/make-fetch-happen/cacache/fs-minipass": ["fs-minipass@3.0.3", "", { "dependencies": { "minipass": "^7.0.3" } }, "sha512-XUBA9XClHbnJWSfBzjkm6RvPsyg3sryZt06BEQoXcF7EK/xpGaQYJgQKDJSUH5SGZ76Y7pFx1QBnXz09rU5Fbw=="],
diff --git a/docs/references/diff_example.png b/docs/references/diff_example.png
deleted file mode 100644
index 97b51f1f..00000000
Binary files a/docs/references/diff_example.png and /dev/null differ
diff --git a/docs/references/settings_example.png b/docs/references/settings_example.png
deleted file mode 100644
index 9e7fb55f..00000000
Binary files a/docs/references/settings_example.png and /dev/null differ
diff --git a/docs/references/tool_output_example.png b/docs/references/tool_output_example.png
deleted file mode 100644
index ca17726f..00000000
Binary files a/docs/references/tool_output_example.png and /dev/null differ
diff --git a/knip.json b/knip.json
index beb1972a..f2e4c823 100644
--- a/knip.json
+++ b/knip.json
@@ -1,8 +1,13 @@
{
"$schema": "https://unpkg.com/knip@latest/schema.json",
+ "ignore": [
+ "packages/mobile/android/app/src/main/assets/public/**",
+ "packages/mobile/ios/App/App/public/**"
+ ],
"workspaces": {
".": {
"entry": [
+ "postcss.config.js",
"scripts/**/*.{js,cjs,mjs,ts}"
],
"project": [
@@ -12,6 +17,8 @@
},
"packages/ui": {
"entry": [
+ "src/apps/renderVSCodeApp.tsx",
+ "src/**/*.bench.{ts,tsx}",
"src/**/*.{test,spec}.{js,cjs,mjs,jsx,ts,tsx}",
"src/**/__tests__/**/*.{js,cjs,mjs,jsx,ts,tsx}"
],
@@ -23,7 +30,9 @@
"entry": [
"src/mobile-main.tsx",
"src/mini-chat-main.tsx",
+ "src/main.tsx",
"src/sw.ts",
+ "bin/**/*.{test,spec}.{js,cjs,mjs}",
"server/**/*.{test,spec}.{js,cjs,mjs}",
"src/**/*.{test,spec}.{ts,tsx}"
],
@@ -50,6 +59,7 @@
},
"packages/vscode": {
"entry": [
+ "webview/main.tsx",
"src/**/*.{test,spec}.{js,cjs,mjs,ts,tsx}",
"webview/**/*.{test,spec}.{js,cjs,mjs,ts,tsx}"
],
@@ -57,6 +67,15 @@
"src/**/*.{ts,tsx}",
"webview/**/*.{ts,tsx}"
]
+ },
+ "packages/mobile": {
+ "entry": [
+ "scripts/**/*.{js,cjs,mjs,ts}"
+ ],
+ "project": [
+ "*.{js,cjs,mjs,ts}",
+ "scripts/**/*.{js,cjs,mjs,ts}"
+ ]
}
}
}
diff --git a/package.json b/package.json
index 31f9c141..3561555d 100644
--- a/package.json
+++ b/package.json
@@ -119,7 +119,6 @@
"@radix-ui/react-slot": "^1.2.3",
"@radix-ui/react-toggle": "^1.1.10",
"@radix-ui/react-tooltip": "^1.2.8",
- "@types/react-syntax-highlighter": "^15.5.13",
"@xenova/transformers": "^2.17.2",
"@zumer/snapdom": "^2.12.8",
"bun-pty": "^0.4.5",
@@ -134,9 +133,8 @@
"react": "^19.1.1",
"react-dom": "^19.1.1",
"react-markdown": "^10.1.0",
- "react-syntax-highlighter": "^15.6.6",
"remark-gfm": "^4.0.1",
- "simple-git": "^3.28.0",
+ "simple-git": "^3.36.0",
"sonner": "^2.0.7",
"tailwind-merge": "^3.3.1",
"yaml": "^2.8.1",
diff --git a/packages/docs/CONTRIBUTING.md b/packages/docs/CONTRIBUTING.md
index 76d6efbf..133cc359 100644
--- a/packages/docs/CONTRIBUTING.md
+++ b/packages/docs/CONTRIBUTING.md
@@ -203,13 +203,14 @@ other language mirrors the English files under a locale folder.
| Korean | `ko/` | `ko` |
| Polish | `pl/` | `pl` |
| French | `fr/` | `fr` |
+| German | `de/` | `de` |
| Japanese | `ja/` | `ja` |
> [!IMPORTANT]
> The **content folder** uses the lowercase locale key (`zh-cn`, `pt-br`); the
> **sidebar `translations`** key uses the BCP-47 language tag (`zh-CN`, `pt-BR`).
> They look similar but are not interchangeable — Starlight resolves them with
-> different rules. Everything else (`uk`, `es`, `ko`, `pl`, `fr`, `ja`, `en`) is identical
+> different rules. Everything else (`uk`, `es`, `ko`, `pl`, `fr`, `de`, `ja`, `en`) is identical
> in both columns.
This locale set is mirrored in the website at
@@ -269,6 +270,7 @@ to each section and item in `sidebar.config.json`:
"ko": "여기서 시작",
"pl": "Zacznij tutaj",
"fr": "Commencer ici",
+ "de": "Hier starten",
"ja": "ここから開始"
},
"items": [
@@ -283,6 +285,7 @@ to each section and item in `sidebar.config.json`:
"ko": "설치",
"pl": "Instalacja",
"fr": "Installation",
+ "de": "Installation",
"ja": "インストール"
}
}
diff --git a/packages/docs/content/docs/de/agent-control-tool.mdx b/packages/docs/content/docs/de/agent-control-tool.mdx
new file mode 100644
index 00000000..c3b8dec6
--- /dev/null
+++ b/packages/docs/content/docs/de/agent-control-tool.mdx
@@ -0,0 +1,39 @@
+---
+title: Agent-Steuerungswerkzeug
+description: Lass einen Agenten OpenChamber-Sitzungen, Worktrees und geplante Aufgaben direkt aus dem Chat verwalten.
+---
+
+# Agent-Steuerungswerkzeug
+
+Verwende das Agentenwerkzeug `openchamber`, um Arbeit in der App direkt aus dem Chat zu verwalten. Es ist standardmäßig aktiviert, wenn OpenChamber seinen eigenen lokalen OpenCode-Server ausführt; du musst kein separates Werkzeug installieren und keinen Shell-Befehl ausführen.
+
+## Was du anfragen kannst
+
+Sprich einfach in natürlicher Sprache mit dem Agenten. Zum Beispiel:
+
+- "Erstelle in diesem Projekt eine neue OpenChamber-Sitzung, verwende das Modell `openai/gpt-5.6-sol` und sende ihr diese Aufforderung: überprüfe den Authentifizierungsfluss."
+- "Erstelle für diese Aufgabe eine neue OpenChamber-Sitzung in einem separaten Worktree und bitte sie, Tests für den Login-Fluss hinzuzufügen."
+- "Verwende OpenChamber, um meine 10 neuesten Sitzungen aufzulisten und ihren aktuellen Status anzuzeigen."
+- "Erstelle eine geplante OpenChamber-Aufgabe mit dem Namen Weekday review, die diese Aufforderung werktags um 09:00 sendet: review changes since the last run."
+- "Führe die geplante OpenChamber-Aufgabe mit dem Namen Weekday review jetzt aus."
+- "Prüfe die OpenChamber-Sitzung mit dem Namen Authentication review und zeige mir die neueste Antwort des Assistenten."
+
+Das Werkzeug kann Projekte und Modelleinstellungen auflisten, Sitzungen erstellen und weiterführen, eine Sitzung forken, isolierte Worktree-Sitzungen erstellen und geplante Aufgaben verwalten. Auf diese Weise gestartete Sitzungen erscheinen in OpenChamber wie jede andere Sitzung auch, sodass du sie öffnen und die Arbeit selbst fortsetzen kannst.
+
+## Beachten
+
+- Neue Sitzungsaufforderungen kehren standardmäßig sofort zurück. Verfolge die Sitzung in OpenChamber oder bitte den Agenten, sie später noch einmal zu prüfen.
+- Ein separater Worktree wird nur erstellt, wenn du ausdrücklich danach fragst. Nicht-committete Änderungen aus deinem aktuellen Worktree werden nicht dorthin kopiert.
+- Das Werkzeug kann keine Sitzungen oder Worktrees löschen, keine Projektpfade registrieren, keine beliebigen Shell-Befehle ausführen und keine beliebigen URLs aufrufen.
+
+## Werkzeug ein- oder ausschalten
+
+Öffne **Einstellungen → Allgemein → OpenCode CLI**, ändere **Agent control tool** und wähle dann **Save + Reload**. Die Einstellung gilt, nachdem der verwaltete OpenCode-Server neu gestartet wurde.
+
+Das Werkzeug ist nicht verfügbar, wenn OpenChamber über `OPENCODE_HOST` oder skip-start mit einem externen OpenCode-Server verbunden ist oder innerhalb der VS-Code-Erweiterung läuft. Desktop- und Web-Installationen, die den verwalteten OpenCode-Server von OpenChamber verwenden, unterstützen es automatisch.
+
+## Verwandt
+
+- [Geplante Aufgaben](/scheduled-tasks/)
+- [Worktree-Sitzungen](/worktrees/)
+- [Sitzungsziele](/session-goals/)
diff --git a/packages/docs/content/docs/de/commands-snippets.mdx b/packages/docs/content/docs/de/commands-snippets.mdx
new file mode 100644
index 00000000..e4a7c68f
--- /dev/null
+++ b/packages/docs/content/docs/de/commands-snippets.mdx
@@ -0,0 +1,39 @@
+---
+title: Befehle & Snippets
+description: Wiederverwendbare Slash-Befehle und Text-Snippets für den Chat erstellen.
+---
+
+# Befehle & Snippets
+
+Sowohl Befehle als auch Snippets ersparen dir das wiederholte Tippen derselben Dinge. Befehle sind ganze Prompts, die du mit `/` aufrufst; Snippets sind Textbausteine, die du mit `#` in eine Nachricht einfügst.
+
+## Befehle
+
+Ein Befehl ist ein gespeicherter Prompt, den du mit einem Slash aufrufst, etwa `/review`. Du verwaltest ihn unter **Einstellungen → Befehle**.
+
+1. Öffne **Einstellungen → Befehle** und erstelle einen Befehl.
+2. Gib ihm einen Namen, eine Beschreibung und den Prompt-Text, den er senden soll.
+3. Optional kannst du ihn an einen bestimmten Agenten oder ein Modell binden.
+4. Wähle den Geltungsbereich: persönlich oder projektbezogen.
+
+Gib im Chat als **erstes** Zeichen der Nachricht `/` ein, um Befehle anzuzeigen, und wähle dann einen aus. Dein Text kann Platzhalter verwenden:
+
+- `$ARGUMENTS` — alles, was du nach dem Befehl eingibst
+- `@filename` — fügt den Inhalt einer Datei ein
+- `` !`command` `` — fügt die Ausgabe eines Shell-Befehls ein
+
+Die eingebauten Befehle `init` und `review` können zurückgesetzt, aber nicht gelöscht werden.
+
+## Snippets
+
+Ein Snippet ist wiederverwendbarer Text, auf den du inline mit einer Raute verweist, zum Beispiel `#signoff`. Du verwaltest ihn unter **Einstellungen → Snippets**.
+
+1. Öffne **Einstellungen → Snippets** und erstelle ein Snippet.
+2. Gib ihm einen Namen und den Text, für den es steht. Füge Aliase hinzu, wenn du mehr als einen Auslöser möchtest.
+3. Wähle den persönlichen oder projektbezogenen Geltungsbereich.
+
+Gib im Chat `#` ein und wähle ein Snippet aus. OpenChamber ersetzt es vor dem Senden durch den vollständigen Text.
+
+## Weiterführend
+
+- [Skills](/skills/) — größere Anweisungssätze bei Bedarf laden
diff --git a/packages/docs/content/docs/de/connect-devices.mdx b/packages/docs/content/docs/de/connect-devices.mdx
new file mode 100644
index 00000000..e3d19233
--- /dev/null
+++ b/packages/docs/content/docs/de/connect-devices.mdx
@@ -0,0 +1,68 @@
+---
+title: Ein Gerät verbinden
+description: Kopple dein Telefon, deinen Desktop oder einen anderen Browser mit deinem OpenChamber-Server über einen einmaligen QR-Code.
+---
+
+# Ein Gerät verbinden
+
+Kopple ein weiteres Gerät — die Mobile App, die Desktop-App oder einen Browser auf einem anderen Rechner — mit deinem OpenChamber-Server, indem du einen einmaligen QR-Code scannst. Das ist der empfohlene Weg, Geräte zu verbinden; du musst keine Ports öffnen und keine Adressen eintippen.
+
+## Gerät koppeln
+
+1. Öffne auf dem Rechner mit OpenChamber **Settings → Remote Instances → Connect to this server** und drücke **Add a device**.
+2. Gib dem Gerät einen Namen (z. B. *Mein iPhone*), damit du es später wiedererkennst.
+3. Wähle, wo du das Gerät nutzen wirst:
+ - **This computer only** — für Apps, die auf genau diesem Rechner laufen
+ - **Home network only** — verbindet sich direkt über dein WLAN; funktioniert außerhalb dieses Netzwerks nicht
+ - **Anywhere** — funktioniert zu Hause und unterwegs; Daten außerhalb deines Netzwerks laufen über das [Private Relay](/private-relay/), ein Ende-zu-Ende-verschlüsselter Tunnel ohne zusätzliche Einrichtung
+4. Drücke **Create QR code**.
+5. Scanne den Code auf dem anderen Gerät:
+ - **mobile app** — tippe auf dem Verbindungsbildschirm (oder in der Instanzliste) auf **Scan QR code**
+ - **desktop app** — kopiere stattdessen den Verbindungslink und füge ihn unter **Settings → Remote Instances → Other OpenChamber servers → Import Link** ein
+
+Der Dialog schließt sich von selbst, sobald das Gerät verbunden ist, und das Gerät erscheint mit Live-Status in der Liste. Das war’s — die Kopplung ist abgeschlossen.
+
+## So bleibt die Kopplung sicher
+
+- **Der QR-Code ist nur einmal verwendbar.** Er funktioniert in dem Moment nicht mehr, in dem ein Gerät ihn einlöst, und läuft von selbst ab, wenn er nie benutzt wird.
+- **Jedes Gerät erhält sein eigenes Token.** Beim Scannen wird niemals dein UI-Passwort offengelegt, und das Token eines Geräts kann nicht verwendet werden, um sich als ein anderes auszugeben.
+- **Du behältst die Kontrolle.** Jedes gekoppelte Gerät wird mit Name, Plattform und Verbindungsstatus angezeigt — du kannst jedes davon jederzeit widerrufen.
+- **Verkehr von unterwegs ist Ende-zu-Ende verschlüsselt.** Bei **Anywhere** läuft Verkehr außerhalb deines Netzwerks über das [Private Relay](/private-relay/), das nicht lesen kann, was hindurchläuft.
+
+## Gekoppelte Geräte verwalten
+
+**Settings → Remote Instances → Connect to this server** listet jedes Gerät, das diesen Server erreichen kann, mit einem grünen Punkt, wenn es online ist, und zeigt an, ob es über das lokale Netzwerk oder das Relay verbunden ist.
+
+- **Revoke** trennt ein Gerät sofort. Kopple es mit einem neuen QR-Code erneut, wenn du es dir anders überlegst.
+- **Clear revoked** räumt die Liste auf.
+
+Dasselbe physische Gerät bleibt nur in einem Eintrag, auch wenn es sich später erneut anmeldet — du sammelst keine Duplikate an.
+
+## Über die Kommandozeile verbinden
+
+Wenn der Server ohne UI läuft (also headless), erstelle einen Verbindungslink in einem Terminal auf diesem Rechner.
+
+Für ein Gerät im selben Netzwerk:
+
+```bash
+openchamber connect-url --port 3000 --qr
+```
+
+Für ein Gerät, das sich von **überall** verbinden soll — das entspricht der Wahl von **Anywhere** im Dialog:
+
+```bash
+openchamber connect-url --relay --qr
+```
+
+Ein `--relay`-Link enthält beide Routen, genau wie der Dialog: Das Gerät verbindet sich direkt über dein lokales Netzwerk, wenn es den Server erreichen kann, und fällt auf das [Private Relay](/private-relay/) zurück, wenn es unterwegs ist. Das Relay startet von selbst: Eine laufende Instanz übernimmt den Link innerhalb einer Minute, eine gestoppte Instanz beim nächsten Start.
+
+> Die direkte Route funktioniert nur, wenn der Server tatsächlich im Netzwerk lauscht. Standardmäßig lauscht OpenChamber nur auf dem Rechner selbst — starte es mit `--lan`, damit es über WLAN erreichbar ist. Der Befehl warnt dich (`[LAN_UNREACHABLE]`), wenn die direkte Route des Links von anderen Geräten nicht nutzbar ist; ein `--relay`-Link funktioniert dann trotzdem, nur immer über das Relay.
+
+Der ausgegebene Link und QR-Code funktionieren genau wie die aus dem Einstellungsdialog — nur einmal verwendbar, mit Ablaufzeit und widerrufbar.
+
+## Verwandt
+
+- [Private Relay](/private-relay/) — wie "Anywhere"-Verbindungen funktionieren
+- [Mobile Apps](/mobile/) — die iOS- oder Android-App installieren
+- [Remote Instances](/remote-instances/) — die Desktop-App per SSH oder Link mit Servern verbinden
+- [Remote access](/troubleshooting/remote-access/) — wenn sich ein Gerät nicht verbinden kann
diff --git a/packages/docs/content/docs/de/context.mdx b/packages/docs/content/docs/de/context.mdx
new file mode 100644
index 00000000..9973d1d4
--- /dev/null
+++ b/packages/docs/content/docs/de/context.mdx
@@ -0,0 +1,38 @@
+---
+title: Kontext
+description: Sieh, wie viel des Modellgedächtnisses eine Session verwendet.
+---
+
+# Kontext
+
+Jedes Modell kann immer nur so viel von einer Unterhaltung gleichzeitig halten — seinen Kontext. OpenChamber zeigt dir, wie voll er ist, damit du erkennst, wenn eine Session an die Grenze kommt und eine Antwort vielleicht ältere Details fallen lässt.
+
+## Die schnelle Anzeige
+
+Während du chattest, zeigt eine kleine Anzeige den prozentualen Kontextverbrauch. Die Farbe ändert sich, während er voller wird:
+
+- grün — noch reichlich Platz
+- gelb — wird voll (etwa drei Viertel)
+- rot — fast voll
+
+Bewege den Mauszeiger darüber (oder tippe sie auf dem Handy an), um die genauen Token-Zahlen zu sehen.
+
+## Das vollständige Kontext-Panel
+
+Öffne den Tab **Kontext** in der rechten Seitenleiste für ein vollständigeres Bild der aktuellen Session:
+
+- das verwendete Modell und wann die Session gestartet wurde
+- Gesamtzahl der Tokens im Verhältnis zum Limit des Modells
+- Gesamtzahlen für Nachrichten und Kosten
+- eine Aufschlüsselung der Token der letzten Antwort
+- eine grobe Aufteilung dessen, was den Kontext belegt (deine Nachrichten, die des Agenten, Tool-Ausgaben)
+
+Die Aufschlüsselung ist eine Schätzung, keine exakte Zahl — nutze sie, um zu erkennen, was das Fenster füllt, nicht für die Abrechnung.
+
+## Was tun, wenn es voll ist
+
+Starte für eine neue Aufgabe eine frische Session, statt eine Session endlos wachsen zu lassen. Ein kürzerer Kontext ist schneller und hält das Modell fokussiert.
+
+## Verwandtes
+
+- [Projekte](/projects/) — Sessions werden pro Projekt gruppiert
diff --git a/packages/docs/content/docs/de/desktop-browser.mdx b/packages/docs/content/docs/de/desktop-browser.mdx
new file mode 100644
index 00000000..8860ee8f
--- /dev/null
+++ b/packages/docs/content/docs/de/desktop-browser.mdx
@@ -0,0 +1,22 @@
+---
+title: Desktop-Browser
+description: Durchsuche jede Seite in der Desktop-App mit Inspektion und Konsolenaufzeichnung.
+---
+
+# Desktop-Browser
+
+Die Desktop-App hat einen eingebauten Browser, damit du jede Seite direkt neben deinem Chat öffnen, auf Elemente zeigen und danach fragen sowie die Konsole der Seite aufzeichnen kannst. Öffne ihn über die Globus-Schaltfläche im App-Kopfbereich.
+
+> Der Desktop-Browser ist eine Funktion **nur für den Desktop**. Im Web bietet das [Preview](/preview/)-Panel dieselben Inspektions- und Konsolentools für deinen lokalen Dev-Server.
+
+## Inspizieren und annotieren
+
+Aktiviere **inspect** und klicke auf ein beliebiges Element auf der Seite. OpenChamber erstellt dazu eine Notiz — was es ist, welche Stile es hat, wo es sich befindet und einen Screenshot — und hängt sie an deine Chatnachricht an. Das ist der schnellste Weg, dem Agenten zu sagen: „dieses Element, genau hier“.
+
+## Konsolenaufzeichnung
+
+Der Browser sammelt die Konsolenausgabe der Seite — Fehler, Warnungen und Logs — damit du sie filtern und lesen kannst, ohne die Entwicklertools zu öffnen.
+
+## Verwandt
+
+- [Preview & Dev Servers](/preview/) — dieselben Tools für deinen lokalen Dev-Server
diff --git a/packages/docs/content/docs/de/desktop-tunnels.mdx b/packages/docs/content/docs/de/desktop-tunnels.mdx
new file mode 100644
index 00000000..6b3d80ad
--- /dev/null
+++ b/packages/docs/content/docs/de/desktop-tunnels.mdx
@@ -0,0 +1,41 @@
+---
+title: Desktop-Tunnel
+description: Erstelle Cloudflare- oder Ngrok-Tunnel aus der Desktop-App.
+---
+
+# Desktop-Tunnel
+
+Die Desktop-App kann unter **Settings → OpenChamber → Tunnel** einen öffentlichen Tunnel erstellen. Für diesen Weg musst du OpenChamber nicht per CLI starten.
+
+## Anbieter installieren
+
+OpenChamber startet das Provider-CLI auf deinem Rechner. Installiere zuerst den Anbieter, den du verwenden möchtest:
+
+```bash
+brew install cloudflared
+brew install ngrok
+```
+
+Cloudflare verwendet `cloudflared`. Ngrok benötigt ein ngrok-Konto und ein Authtoken aus dem ngrok-Dashboard:
+
+```bash
+ngrok config add-authtoken
+```
+
+## In der App starten
+
+1. Öffne **Settings → OpenChamber → Tunnel**.
+2. Wähle **Cloudflare** oder **Ngrok**.
+3. Starte einen Quick Tunnel.
+4. Scanne den erzeugten QR-Code mit deinem Telefon.
+
+Ngrok unterstützt derzeit Quick Tunnels. Cloudflare unterstützt Quick Tunnels und verwaltete Cloudflare-Modi.
+
+## Zugriffsschutz
+
+Auch wenn die Anbieter-URL selbst öffentlich ist, schützt OpenChamber den Zugriff weiterhin mit seinem eigenen Verbindungs-Token. Der erzeugte Verbindungslink enthält ein Einmal-Token, hat eine TTL, und alte unbenutzte Links werden widerrufen, wenn du einen neuen erzeugst oder den Tunnel stoppst bzw. neu startest.
+
+## Verwandt
+
+- [Tunnels](/tunnels/) — Tunnel-Nutzung per CLI und verwaltete Cloudflare-Modi
+- [PWA & Mobile](/mobile/) — OpenChamber vom Telefon aus erreichen
diff --git a/packages/docs/content/docs/de/environment.mdx b/packages/docs/content/docs/de/environment.mdx
new file mode 100644
index 00000000..8e48b703
--- /dev/null
+++ b/packages/docs/content/docs/de/environment.mdx
@@ -0,0 +1,138 @@
+---
+title: Umgebungsvariablen
+description: Konfiguriere die OpenChamber- und OpenCode-Integration mit Umgebungsvariablen.
+---
+
+# Umgebungsvariablen
+
+OpenChamber liest diese Umgebungsvariablen beim Start. Für Startdienste speichert `openchamber startup enable` die aktuelle Umgebung standardmäßig als Schnappschuss, also führe den Befehl nach Änderungen an den Variablen, die der Dienst verwenden soll, erneut aus.
+
+## OpenChamber-Server
+
+### `OPENCHAMBER_HOST`
+
+Bind-Adresse für den OpenChamber-Webserver. Verwende `0.0.0.0`, um Zugriff von anderen Maschinen zu erlauben.
+
+### `OPENCHAMBER_UI_PASSWORD`
+
+Passwort für die Browser-Oberfläche. Verwende es, wenn du außerhalb von localhost bindest, Tunnels nutzt oder hinter einem Reverse Proxy läufst.
+
+### `OPENCHAMBER_API_ONLY`
+
+Startet OpenChamber im Headless-Modus, wenn auf `true` oder `1` gesetzt. API-Routen bleiben für Desktop- und Mobile-Clients verfügbar, aber die Browser-Oberfläche wird nicht ausgeliefert.
+
+### `OPENCHAMBER_DATA_DIR`
+
+Überschreibt das OpenChamber-Datenverzeichnis. Standard ist `~/.config/openchamber`.
+
+### `OPENCHAMBER_COMPRESS_API`
+
+Steuert die Komprimierung von API-Antworten. Verwende `true` oder `1`, um sie zu erzwingen, und `false` oder `0`, um sie zu deaktivieren.
+
+### `OPENCHAMBER_SKIP_API_COMPRESSION`
+
+Deaktiviert die Komprimierung von API-Antworten, wenn auf `true` oder `1` gesetzt. Das hat Vorrang vor `OPENCHAMBER_COMPRESS_API`.
+
+### `OPENCHAMBER_VERBOSE_REQUEST_LOGS`
+
+Aktiviert ausführliche HTTP-Request-Logs, wenn auf `true` oder `1` gesetzt.
+
+### `OPENCHAMBER_UPDATE_API_URL`
+
+Überschreibt den API-Endpunkt für Update-Prüfungen. Die meisten Nutzer sollten das nicht setzen.
+
+### `OPENCHAMBER_PACKAGE_MANAGER`
+
+Erzwingt den Paketmanager, den Update-Operationen verwenden, wenn die automatische Erkennung falsch liegt.
+
+## OpenCode-Server
+
+### `OPENCODE_HOST`
+
+Verbindet OpenChamber mit einem vorhandenen OpenCode-Server. Der Wert muss ein `http`- oder `https`-Origin mit explizitem Port und ohne Pfad, Query oder Hash sein. `OPENCODE_HOST` hat Vorrang vor `OPENCODE_PORT`.
+
+### `OPENCODE_PORT`
+
+Legt den Port des OpenCode-Servers fest. Bei verwaltetem OpenCode fordert dies den verwalteten Port an; mit `OPENCODE_SKIP_START=true` verbindet es sich mit einem externen Server auf diesem Port.
+
+### `OPENCODE_SKIP_START`
+
+Verhindert, dass OpenChamber einen eigenen OpenCode-Server startet, wenn auf `true` gesetzt.
+
+### `OPENCHAMBER_OPENCODE_HOSTNAME`
+
+Bind-Hostname für den von OpenChamber verwalteten OpenCode-Server. Standard ist `127.0.0.1`.
+
+### `OPENCODE_BINARY`
+
+Pfad zur ausführbaren `opencode`-Datei, die OpenChamber ausführen soll.
+
+### `OPENCODE_CONFIG`
+
+Pfad zu einer bestimmten OpenCode-Konfigurationsdatei.
+
+### `OPENCODE_CONFIG_DIR`
+
+Pfad zu einem bestimmten OpenCode-Konfigurationsverzeichnis für Agents, Skills, Snippets und Konfigurationssuche.
+
+### `OPENCODE_DATA_DIR`
+
+Benutzerdefiniertes Datenverzeichnis für den verwalteten OpenCode-Server.
+
+### `OPENCODE_WSL_DISTRO`
+
+Wählt die WSL-Distribution für die OpenCode-Integration unter Windows aus.
+
+### `OPENCHAMBER_OPENCODE_WSL_DISTRO`
+
+OpenChamber-spezifischer Alias zur Auswahl der WSL-Distribution. `OPENCODE_WSL_DISTRO` hat Vorrang, wenn beide gesetzt sind.
+
+### `OPENCODE_JWT_SECRET`
+
+Geheimnis zum Signieren von UI-Authentifizierungstokens. Verwende für dauerhafte Diensteinrichtungen einen langen, zufälligen Wert.
+
+## Terminal und Git
+
+### `OPENCHAMBER_TERMINAL_SHELL`
+
+Shell-Executable, die OpenChamber für Terminal-Sessions verwendet.
+
+### `OPENCHAMBER_GIT_BINARY`
+
+Git-Executable, die OpenChamber-Git-Funktionen verwenden.
+
+### `GIT_BINARY`
+
+Alternative Git-Executable-Überschreibung. Bevorzuge `OPENCHAMBER_GIT_BINARY` für OpenChamber-spezifische Konfiguration.
+
+### `OPENCHAMBER_GIT_READ_CACHE_TTL_MS`
+
+Lebensdauer in Millisekunden für zwischengespeicherte Git-gestützte Dateilesevorgänge. Setze `0`, um diesen Cache beim Debuggen zu deaktivieren.
+
+## Voice und Tunnels
+
+### `OPENAI_API_KEY`
+
+API-Schlüssel, den OpenChamber-Voice-Funktionen für OpenAI-kompatible Dienste verwenden.
+
+### `OPENCHAMBER_ALLOW_REMOTE_OPENAI_COMPAT_URLS`
+
+Erlaubt entfernte OpenAI-kompatible Basis-URLs für Voice-Funktionen, wenn auf `true` oder `1` gesetzt.
+
+### `NGROK_AUTHTOKEN`
+
+ngrok-Auth-Token, den OpenChamber-Tunnel-Befehle verwenden. Du kannst ngrok auch mit `ngrok config add-authtoken ` konfigurieren.
+
+## Laufzeit-Helfer
+
+### `BUN_BINARY`
+
+Bun-Executable, die OpenChamber beim Starten von Daemon-Prozessen verwenden soll.
+
+### `BUN_INSTALL`
+
+Installationswurzel von Bun. OpenChamber verwendet sie, um `bin/bun` für Daemon-Start und Updates zu finden.
+
+### `VITE_OPENCODE_URL`
+
+Build-Zeit-API-Basis-URL für die mit Vite gebaute Web-App. Die meisten Nutzer sollten sie für die normale CLI- oder Desktop-Nutzung nicht setzen.
diff --git a/packages/docs/content/docs/de/git-identities.mdx b/packages/docs/content/docs/de/git-identities.mdx
new file mode 100644
index 00000000..7c02f83b
--- /dev/null
+++ b/packages/docs/content/docs/de/git-identities.mdx
@@ -0,0 +1,30 @@
+---
+title: Git-Identitäten
+description: Committe mit dem richtigen Namen und der richtigen E-Mail für jedes Repository.
+---
+
+# Git-Identitäten
+
+Eine Git-Identität ist der Name und die E-Mail-Adresse, mit denen deine Commits signiert werden. Wenn du zwischen privaten und Arbeits-Repos wechselst, kannst du Identitäten speichern und pro Repository die richtige anwenden, statt dich auf eine einzige globale Einstellung zu verlassen. Verwalte sie unter **Einstellungen → Git**.
+
+## Eine Identität hinzufügen
+
+1. Öffne **Einstellungen → Git** und wähle **New**.
+2. Gib den **name** und die **email** ein, mit denen committen werden soll.
+3. Wähle aus, wie sie sich beim Remote authentifiziert:
+ - **SSH** — verweise auf einen SSH-Schlüssel
+ - **token** — verwende eine gespeicherte Anmeldedaten für einen Host
+4. Gib ihr optional eine Farbe und ein Symbol, damit sie leicht zu erkennen ist.
+
+Auch deine globale System-Identität wird angezeigt, allerdings nur lesbar.
+
+## Eine Identität auf ein Repo anwenden
+
+Das Anwenden einer Identität schreibt sie in die **lokale** Git-Konfiguration dieses Repositories — sie betrifft nur dieses Repo, nicht deine globale Einstellung. SSH-Identitäten setzen außerdem den zu verwendenden SSH-Befehl auf deinen Schlüssel; Token-Identitäten richten die Anmeldedatenspeicherung für den Host ein.
+
+Du kannst Identitäten importieren, die OpenChamber aus deinen vorhandenen Git-Anmeldedaten erkennt, und sie als Token-Identitäten speichern.
+
+## Verwandt
+
+- [Git- & GitHub-Workflows](/git/) — mit der von dir festgelegten Identität committen
+- [GitHub Issues & PRs](/github/) — ein GitHub-Konto für PRs verbinden
diff --git a/packages/docs/content/docs/de/git.mdx b/packages/docs/content/docs/de/git.mdx
new file mode 100644
index 00000000..fc2d4b54
--- /dev/null
+++ b/packages/docs/content/docs/de/git.mdx
@@ -0,0 +1,41 @@
+---
+title: Git- & GitHub-Workflows
+description: Änderungen vormerken, committen und Branches verwalten, ohne OpenChamber zu verlassen.
+---
+
+# Git- & GitHub-Workflows
+
+OpenChamber hat eine integrierte Git-Ansicht, damit du Änderungen prüfen, committen und Branches verwalten kannst, ohne in ein Terminal zu wechseln. Öffne sie über den **Git**-Tab in der rechten Seitenleiste.
+
+## Prüfen und committen
+
+Die Git-Ansicht teilt deine Änderungen in **staged** und **unstaged** auf:
+
+- klicke auf das **+** einer Datei, um sie zu stage'n, oder auf **−**, um sie wieder unstaged zu machen
+- stage oder unstage ganze Gruppen auf einmal
+- klicke auf eine Datei, um ihren Diff zu sehen
+
+Schreibe dann eine Commit-Nachricht und committe. Du kannst OpenChamber eine **Commit-Nachricht generieren** lassen, basierend auf deinen gestagten Änderungen — dabei wird das Modell der aktuellen Sitzung verwendet, also brauchst du eine geöffnete Sitzung.
+
+## Branches und Verlauf
+
+Die Git-Ansicht deckt auch den üblichen Rest von Git ab:
+
+- Branches erstellen, wechseln, umbenennen und löschen
+- pushen, pullen und fetchen
+- Verlauf und Diffs pro Commit durchsuchen
+- Änderungen stashen und wiederherstellen
+
+## Pull Requests
+
+Verbinde GitHub (siehe [GitHub Issues & PRs](/github/)) und der **PR**-Tab lässt dich einen Pull Request öffnen, aktualisieren, als bereit markieren oder mergen — und seinen Titel und seine Beschreibung auf dieselbe Weise wie Commit-Nachrichten generieren.
+
+## Konflikte übernehmen
+
+Wenn ein Merge, Rebase oder Integrate auf einen Konflikt stößt, zeigt OpenChamber, was festhängt, und lässt dich es lösen — einschließlich der Übergabe an den Agenten.
+
+## Verwandt
+
+- [GitHub Issues & PRs](/github/) — GitHub verbinden und mit Issues mit der Arbeit beginnen
+- [Worktree-Sitzungen](/worktrees/) — einen Branch in seinem eigenen Ordner isolieren
+- [Git-Identitäten](/git-identities/) — als die richtige Person pro Repo committen
diff --git a/packages/docs/content/docs/de/github.mdx b/packages/docs/content/docs/de/github.mdx
new file mode 100644
index 00000000..e2de6f5a
--- /dev/null
+++ b/packages/docs/content/docs/de/github.mdx
@@ -0,0 +1,34 @@
+---
+title: GitHub Issues & PRs
+description: Verbinde GitHub und starte Sitzungen aus Issues und Pull Requests.
+---
+
+# GitHub Issues & PRs
+
+Verbinde dein GitHub-Konto und OpenChamber kann Issues und Pull Requests einlesen, direkt daraus eine Sitzung starten und PRs für dich öffnen oder aktualisieren.
+
+## GitHub verbinden
+
+1. Öffne **Einstellungen → Git**.
+2. Wähle unter GitHub **Connect**. OpenChamber zeigt einen Link und einen kurzen Code an.
+3. Öffne den Link, gib den Code ein und bestätige.
+
+Wenn die Verbindung steht, erscheint dein Konto im GitHub-Bereich. Du kannst mehr als ein Konto verbinden und zwischen ihnen wechseln oder dich jederzeit trennen.
+
+## Arbeit aus einem Issue oder PR starten
+
+Wenn du mit verbundenem GitHub eine [Worktree-Sitzung](/worktrees/) erstellst, kannst du **Start from GitHub issue/PR** wählen:
+
+- wähle ein **issue** und OpenChamber benennt den Branch danach und öffnet die Sitzung mit dem Issue und seinen Kommentaren als erster Nachricht
+- wähle einen **pull request** und OpenChamber checkt den Branch des PR aus; du kannst den Diff des PR einbeziehen, damit der Agent die komplette Änderung hat
+
+So landest du direkt in einer Sitzung, in der der Kontext bereits geladen ist.
+
+## Pull Requests öffnen und verwalten
+
+Im **PR**-Tab der [Git-Ansicht](/git/) kannst du einen Pull Request erstellen, aktualisieren, einen Entwurf als bereit markieren oder mergen. OpenChamber kann den PR-Titel und die Beschreibung aus deinen Änderungen generieren.
+
+## Verwandt
+
+- [Git- & GitHub-Workflows](/git/) — committen und Branches verwalten
+- [Worktree-Sitzungen](/worktrees/) — dort starten Issue- und PR-Sitzungen
diff --git a/packages/docs/content/docs/de/index.mdx b/packages/docs/content/docs/de/index.mdx
new file mode 100644
index 00000000..617013ad
--- /dev/null
+++ b/packages/docs/content/docs/de/index.mdx
@@ -0,0 +1,32 @@
+---
+title: OpenChamber-Dokumentation
+description: Ein Einrichtungs- und Bedienhandbuch für OpenChamber für Web, Desktop und VS Code.
+---
+
+# OpenChamber-Dokumentation
+
+OpenChamber ist der visuelle Arbeitsbereich rund um OpenCode (den KI-Coding-Agenten, der in deinem Terminal läuft). Er gibt dir einen Bildschirm, auf dem du diese Arbeit beobachten und steuern kannst, statt nur auf der Befehlszeile zu arbeiten.
+
+Nutze diese Doku, um:
+
+- die richtige App für deine Arbeitsweise zu installieren
+- OpenChamber für den sicheren Remote-Einsatz zu öffnen
+- das Aussehen anzupassen und häufige Probleme zu beheben
+
+## Lies zuerst das hier
+
+- [Install](/install/)
+- [Quickstart](/quickstart/)
+- [Tunnels](/tunnels/)
+- [Troubleshooting](/troubleshooting/)
+
+## Entdecken
+
+- [Projects](/projects/) und [Worktree Sessions](/worktrees/) — deine Arbeit organisieren und isolieren
+- [Providers, Models & Agents](/providers/) — OpenCode verbinden und ein Modell wählen
+- [Git & GitHub Workflows](/git/) — commits erstellen, prüfen und PRs öffnen
+- [Security](/security/) und [Tunnels](/tunnels/) — deine Instanz schützen und erreichen
+
+## Wofür OpenChamber gedacht ist
+
+OpenChamber ist für die Teile des KI-Codings gedacht, die von einer Leitstelle profitieren: verzweigende Sessions, Diffs prüfen, Terminals verwalten, den Fortschritt von Tools beobachten, Projektaktionen ausführen und das gesamte Board sichtbar halten, während der Agent arbeitet.
diff --git a/packages/docs/content/docs/de/install.mdx b/packages/docs/content/docs/de/install.mdx
new file mode 100644
index 00000000..097ce2a0
--- /dev/null
+++ b/packages/docs/content/docs/de/install.mdx
@@ -0,0 +1,33 @@
+---
+title: Installieren
+description: Installiere OpenChamber für Desktop, Web oder VS Code.
+---
+
+# Installieren
+
+Es gibt drei Möglichkeiten, OpenChamber auszuführen:
+
+- Desktop-App für macOS
+- Web-App, die vom CLI gehostet wird und die du wie eine Handy-App installieren kannst (eine PWA)
+- VS-Code-Erweiterung
+
+## Voraussetzung
+
+Installiere zuerst [OpenCode](https://opencode.ai) — OpenChamber läuft darauf auf.
+
+## Web + PWA
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/openchamber/openchamber/main/scripts/install.sh | bash
+openchamber --ui-password be-creative-here
+```
+
+Öffne die URL, die das CLI ausgibt (normalerweise `http://localhost:3000`). Du solltest die OpenChamber-Session-Liste sehen. Damit du sie griffbereit hast, kannst du im Adressfeld deines Browsers über die Option „Installieren“ daraus eine App machen.
+
+## Desktop
+
+Lade den aktuellen Desktop-Build von der GitHub-Releases-Seite oder der OpenChamber-Downloadseite herunter. Öffne ihn und melde dich in deinem gewohnten OpenCode-Workflow an.
+
+## VS Code
+
+Installiere sie aus dem VS Code Marketplace und melde dich in deinem gewohnten OpenCode-Workflow an. Die OpenChamber-Ansicht öffnet sich dann in der Seitenleiste.
diff --git a/packages/docs/content/docs/de/magic-prompts.mdx b/packages/docs/content/docs/de/magic-prompts.mdx
new file mode 100644
index 00000000..d6dd2c68
--- /dev/null
+++ b/packages/docs/content/docs/de/magic-prompts.mdx
@@ -0,0 +1,26 @@
+---
+title: Magische Prompts
+description: Passe die eingebauten Prompts an, die hinter OpenChambers automatisierten Abläufen stehen.
+---
+
+# Magische Prompts
+
+OpenChamber verwendet im Hintergrund eingebaute Prompts, wenn etwas automatisch geschieht — eine Commit-Nachricht schreiben, einen PR entwerfen, ein Issue prüfen, einen Konflikt lösen oder eine Sitzung zusammenfassen. Hier kannst du diese Prompts ansehen und umschreiben. Öffne die Seite unter **Einstellungen → Magische Prompts**.
+
+Für die normale Nutzung brauchst du diese Seite nicht. Nutze sie, wenn ein Ablauf sich anders verhalten soll — etwa bei Commit-Nachrichten in einem bestimmten Stil.
+
+## Einen Prompt bearbeiten
+
+1. Öffne **Einstellungen → Magische Prompts**.
+2. Wähle einen Prompt aus den Gruppen in der Seitenleiste — Git, GitHub, Planung und Sitzung.
+3. Bearbeite den Text und speichere ihn.
+
+Einige Prompts haben einen sichtbaren Teil (die Nachricht, die du sehen würdest) und einen Anweisungsteil (versteckte Hinweise für den Agenten). Prompts können `{{placeholders}}` enthalten, die OpenChamber einsetzt, zum Beispiel den Diff oder den Issue-Titel — lass diese unverändert.
+
+## Zurücksetzen
+
+Anders entschieden? Jeder Prompt hat **Auf Standard zurücksetzen**, und es gibt **Alle zurücksetzen**, wenn du überall neu anfangen möchtest.
+
+## Weiterführend
+
+- [Git- & GitHub-Workflows](/git/) — viele dieser Prompts treiben die Git-Abläufe an
diff --git a/packages/docs/content/docs/de/mcp.mdx b/packages/docs/content/docs/de/mcp.mdx
new file mode 100644
index 00000000..24841978
--- /dev/null
+++ b/packages/docs/content/docs/de/mcp.mdx
@@ -0,0 +1,30 @@
+---
+title: MCP-Server
+description: Füge MCP-Server hinzu, damit Agents zusätzliche Werkzeuge erhalten.
+---
+
+# MCP-Server
+
+Ein MCP-Server gibt deinen Agents zusätzliche Werkzeuge — etwa um eine Datenbank zu durchsuchen, eine API aufzurufen oder einen genutzten Dienst auszulesen. Du fügst sie unter **Einstellungen → MCP** hinzu.
+
+## Einen Server hinzufügen
+
+1. Öffne **Einstellungen → MCP**.
+2. Füge einen Server hinzu und wähle seinen Typ:
+ - **lokal** — OpenChamber führt einen Befehl auf deinem Rechner aus. Du gibst den auszuführenden Befehl an und, falls nötig, Umgebungsvariablen.
+ - **entfernt** — OpenChamber verbindet sich mit einer URL, die jemand anderes hostet. Du gibst die URL und alle nötigen Header an (zum Beispiel ein Auth-Token).
+3. Speichere. Der Server ist standardmäßig eingeschaltet; du kannst ihn deaktivieren, ohne ihn zu löschen.
+
+## Wo es gilt
+
+Wähle den Geltungsbereich, wenn du einen Server hinzufügst:
+
+- **persönlich** — in jedem Projekt verfügbar
+- **projektbezogen** — nur im aktuellen Projekt verfügbar und zusammen mit den übrigen Projekteinstellungen gespeichert
+
+Servernamen verwenden Kleinbuchstaben, Ziffern, Bindestriche und Unterstriche.
+
+## Weiterführend
+
+- [Provider, Modelle & Agents](/providers/) — verbinde zuerst ein Modell
+- [Skills](/skills/) — eine weitere Möglichkeit, die Fähigkeiten von Agents zu erweitern
diff --git a/packages/docs/content/docs/de/mobile.mdx b/packages/docs/content/docs/de/mobile.mdx
new file mode 100644
index 00000000..b0f9ed2e
--- /dev/null
+++ b/packages/docs/content/docs/de/mobile.mdx
@@ -0,0 +1,43 @@
+---
+title: Mobile Apps & PWA
+description: Installiere die OpenChamber-App auf iOS oder Android und verbinde sie mit deinem Server.
+---
+
+# Mobile Apps & PWA
+
+OpenChamber hat native Apps für iPhone und Android, damit du Sitzungen verfolgen, auf Agenten antworten und Arbeiten von deinem Telefon aus verwalten kannst — zu Hause über WLAN oder von überall über das [Private Relay](/private-relay/).
+
+## App installieren
+
+- **iPhone/iPad** — tritt der [TestFlight-Beta](https://testflight.apple.com/join/5ek6GU1E) bei
+- **Android** — lade das APK aus dem [latest release](https://github.com/openchamber/openchamber/releases/latest) herunter
+
+## Mit deinem Server verbinden
+
+1. Öffne auf dem Computer mit OpenChamber **Settings → Remote Instances → Connect to this server** und drücke **Add a device**.
+2. Wähle **Anywhere** (oder **Home network only**, wenn du das Telefon nur zu Hause nutzt) und drücke **Create QR code**.
+3. Tippe in der Mobile App auf **Scan QR code** und halte die Kamera darauf.
+
+Die App verbindet sich und merkt sich den Server. Der QR-Code ist nur einmal verwendbar, und jedes Gerät erhält sein eigenes, widerrufbares Token — siehe [Connect a Device](/connect-devices/) für die sichere Kopplung.
+
+Du kannst die App mit mehreren Servern koppeln und im Instanzenbereich zwischen ihnen wechseln; die App zeigt bei jedem an, ob er erreichbar ist und ob du über das lokale Netzwerk oder das Relay verbunden bist.
+
+## PWA (Browser-Installation)
+
+Du willst gar keinen App-Store? Die Web-App lässt sich direkt aus dem Browser installieren:
+
+- **desktop browser** — nutze die Option **Install** in der Adressleiste
+- **iPhone/iPad (Safari)** — Teilen → **Add to Home Screen**
+- **Android (Chrome)** — Menü → **Install app** / **Add to Home Screen**
+
+Um die PWA von außerhalb deines Netzwerks zu erreichen, brauchst du einen [Tunnel](/tunnels/) und ein starkes [UI password](/security/) — die nativen Apps übernehmen das für dich über das Relay.
+
+## Mobile Einstellungen
+
+Unter **Settings → OpenChamber** passen ein paar Optionen die mobile und installierte Nutzung an — der Installationsname der App, die Bildschirmausrichtung und das Verhalten der Bildschirmtastatur.
+
+## Verwandt
+
+- [Connect a Device](/connect-devices/) — Kopplung, einmalige QR-Codes und Geräteverwaltung
+- [Private Relay](/private-relay/) — wie "Anywhere"-Zugriff funktioniert
+- [Security](/security/) — die UI schützen, bevor du sie freigibst
diff --git a/packages/docs/content/docs/de/multi-run.mdx b/packages/docs/content/docs/de/multi-run.mdx
new file mode 100644
index 00000000..197a1210
--- /dev/null
+++ b/packages/docs/content/docs/de/multi-run.mdx
@@ -0,0 +1,34 @@
+---
+title: Multi-run
+description: Führe dieselbe Aufforderung gleichzeitig über mehrere Modelle oder Sitzungen aus.
+---
+
+# Multi-run
+
+Multi-run startet mehrere Sitzungen aus einem einzigen Formular — praktisch, um dieselbe Aufgabe mit verschiedenen Modellen zu testen und die Ergebnisse zu vergleichen. Öffne es über die Schaltfläche oben in der Sitzungs-Seitenleiste.
+
+## Einen Multi-run starten
+
+1. Öffne den Multi-run-Startbildschirm.
+2. Wähle das Projekt und benenne die Run-Gruppe.
+3. Schreibe die Aufforderung und wähle die Modelle aus, mit denen sie ausgeführt werden soll (bis zu fünf pro Gruppe).
+4. Entscheide, ob du **Runs isolieren** möchtest.
+5. Starte.
+
+Jedes Modell erhält seine eigene Sitzung, und alle beginnen mit deiner Aufforderung.
+
+## Isolierte Runs
+
+Aktiviere **Runs isolieren**, damit jeder Run seinen eigenen [Worktree](/worktrees/) und Branch bekommt und sie sich nie dieselben Dateien teilen. Dafür brauchst du ein Git-Repo — für Ordner, die keines sind, wird es automatisch deaktiviert. Wähle den Branch, von dem die Runs starten.
+
+Ohne Isolation ist jeder Run einfach eine normale Sitzung im Projektordner.
+
+## Ergebnisse vergleichen
+
+Jeder Run ist eine normale Sitzung, die du öffnen, lesen und behalten oder verwerfen kannst. Wenn du Runs gestartet hast, um Ansätze zu vergleichen, prüfe sie nebeneinander und nimm den besten mit.
+
+Wenn ein einzelner Run nicht startet, werden die anderen trotzdem ausgeführt — du siehst dann nur weniger Sitzungen, als du angefordert hast.
+
+## Verwandt
+
+- [Worktree-Sitzungen](/worktrees/) — wie Isolation unter der Haube funktioniert
diff --git a/packages/docs/content/docs/de/notes-todos-plans.mdx b/packages/docs/content/docs/de/notes-todos-plans.mdx
new file mode 100644
index 00000000..3a196aee
--- /dev/null
+++ b/packages/docs/content/docs/de/notes-todos-plans.mdx
@@ -0,0 +1,37 @@
+---
+title: Projektnotizen, Todos & Pläne
+description: Halte Notizen, eine Todo-Liste und gespeicherte Pläne für jedes Projekt fest.
+---
+
+# Projektnotizen, Todos & Pläne
+
+Jedes Projekt hat seinen eigenen Arbeitsbereich für Notizen, eine Todo-Liste und gespeicherte Pläne. Sie gehören zum Projekt und nicht zu einer einzelnen Session, also bleiben sie erhalten, wenn du zwischen Sessions wechselst. Du findest sie im Tab **Kontext** der rechten Seitenleiste (auf Mobilgeräten ein eigener Tab).
+
+## Notizen
+
+Ein freies Notizfeld für alles, woran du dich zum Projekt erinnern möchtest. Es speichert automatisch, während du tippst.
+
+## Todos
+
+Eine einfache Checkliste. Füge Einträge hinzu, hake sie ab, ordne sie per Drag-and-drop um und lösche die erledigten.
+
+Jedes Todo hat ein Menü **Senden**, damit du es an den Agenten übergeben kannst:
+
+- an die aktuelle Session senden
+- mit ihm eine neue Session starten
+- mit ihm eine neue [Worktree-Session](/worktrees/) starten (nur wenn das Projekt ein Git-Repo ist)
+
+## Pläne
+
+Ein Ort, um längere Pläne als gespeicherte Dateien aufzubewahren. Du kannst:
+
+- einen Plan aus einer Markdown- oder Textdatei importieren
+- einen Plan öffnen, um ihn im Seitenpanel zu lesen
+- Pläne löschen, die du nicht mehr brauchst
+
+Du solltest danach wieder im Kontext-Tab landen — mit gespeicherter Notiz, abgehakter Todo oder gelistetem Plan; so erkennst du, dass es geklappt hat.
+
+## Verwandtes
+
+- [Worktree-Sessions](/worktrees/) — eine Todo in einem eigenen Branch ausführen
+- [Projekte](/projects/) — diese gehören zum aktiven Projekt
diff --git a/packages/docs/content/docs/de/notifications.mdx b/packages/docs/content/docs/de/notifications.mdx
new file mode 100644
index 00000000..268779ce
--- /dev/null
+++ b/packages/docs/content/docs/de/notifications.mdx
@@ -0,0 +1,34 @@
+---
+title: Benachrichtigungen
+description: Lass dich benachrichtigen, wenn eine Sitzung deine Aufmerksamkeit braucht oder fertig ist.
+---
+
+# Benachrichtigungen
+
+Benachrichtigungen sagen dir, wenn etwas deine Aufmerksamkeit braucht, damit du nicht ständig auf den Bildschirm schauen musst — eine Sitzung ist fertig, hat einen Fehler, stellt eine Frage oder braucht eine Berechtigung für etwas. Du richtest sie unter **Einstellungen → OpenChamber → Benachrichtigungen** ein.
+
+## Aktivieren
+
+1. Öffne **Einstellungen → OpenChamber → Benachrichtigungen**.
+2. Erlaube Benachrichtigungen, wenn dein Browser oder System dich danach fragt.
+3. Wähle aus, worüber du informiert werden möchtest:
+ - eine Sitzung **endet**
+ - eine Sitzung **hat einen Fehler**
+ - eine Sitzung **stellt eine Frage**
+ - eine Sitzung braucht **eine Berechtigung**
+ - **Unteraufgaben** sind abgeschlossen
+
+## Wie sie bei dir ankommen
+
+- auf dem **Desktop** bekommst du native Systembenachrichtigungen
+- in einem **Browser oder einer installierten App** bekommst du Web-Push-Benachrichtigungen, damit sie auch ankommen, wenn der Tab im Hintergrund ist
+
+Sitzungen, die auf automatisches Annehmen gesetzt sind, belästigen dich nicht mit Berechtigungsbenachrichtigungen.
+
+## Die Formulierungen anpassen
+
+Jede Art von Benachrichtigung hat einen Titel und eine Nachrichtenvorlage, die du bearbeiten kannst, mit Feldern wie Agentenname und Modell. Außerdem gibt es eine Begrenzung, wie viel der letzten Nachricht eingefügt wird, damit Benachrichtigungen kurz bleiben.
+
+## Weiterführend
+
+- [Sprachmodus](/voice/) — lass dir Antworten stattdessen vorlesen
diff --git a/packages/docs/content/docs/de/opencode-server.mdx b/packages/docs/content/docs/de/opencode-server.mdx
new file mode 100644
index 00000000..8ee05494
--- /dev/null
+++ b/packages/docs/content/docs/de/opencode-server.mdx
@@ -0,0 +1,97 @@
+---
+title: OpenCode-Server
+description: Verbinde OpenChamber mit einem lokalen oder entfernten OpenCode-Server.
+---
+
+# OpenCode-Server
+
+OpenChamber läuft auf einem OpenCode-Server auf. Standardmäßig startet es einen für dich, sodass du nichts tun musst. Diese Seite brauchst du nur, wenn du OpenChamber auf einen Server zeigen lassen willst, den du bereits betreibst, oder den Server verwalten willst, den es startet.
+
+## Wie OpenChamber einen Server findet
+
+Wenn OpenChamber startet, sucht es in dieser Reihenfolge nach einem Server:
+
+1. einen Server wiederverwenden, den es bereits gestartet hat
+2. zu einem externen verbinden, wenn du es so angegeben hast (siehe unten)
+3. einen Server am Standard-Port automatisch erkennen (`4096`)
+4. andernfalls den eigenen starten und verwalten
+
+Wenn nichts konfiguriert ist, geschieht Schritt 4 automatisch und du bist startklar.
+
+## Mit einem Server verbinden, den du bereits betreibst
+
+Setze diese Variablen, bevor du OpenChamber startest:
+
+```bash
+OPENCODE_HOST=http://localhost:4096 OPENCODE_SKIP_START=true openchamber
+```
+
+- `OPENCODE_HOST` — die vollständige Adresse deines OpenCode-Servers einschließlich des Ports (ein Wert wie `http://localhost:4096`). Sie darf am Ende keinen Pfad haben.
+- `OPENCODE_SKIP_START=true` — weist OpenChamber an, keinen eigenen Server zu starten.
+
+Wenn du nur den Port ändern musst, setze `OPENCODE_PORT` statt `OPENCODE_HOST`.
+
+Wenn `OPENCODE_HOST` keinen Port hat oder einen Pfad enthält, ignoriert OpenChamber ihn und fällt darauf zurück, den eigenen Server zu starten. Achte beim Start auf eine `[config]`-Warnung in den Logs, wenn eine erwartete Verbindung nicht zustande kam.
+
+## Den Server über das CLI verwalten
+
+```bash
+openchamber status
+openchamber logs
+openchamber restart
+openchamber stop
+```
+
+`openchamber` allein startet den Server im Hintergrund. Füge `--foreground` hinzu, damit er an dein Terminal gebunden bleibt.
+
+## OpenChamber beim Anmelden starten
+
+Verwende `startup enable`, um einen nativen Benutzerdienst zu installieren. OpenChamber nutzt `launchd` auf macOS, `systemd --user` auf Linux und den Taskplaner auf Windows.
+
+```bash
+openchamber startup enable
+openchamber startup status
+openchamber startup disable
+```
+
+Um die UI zu schützen, setze das Passwort beim Aktivieren des Dienstes:
+
+```bash
+OPENCHAMBER_UI_PASSWORD='secret' openchamber startup enable
+```
+
+Für einen headless Server, der sich beim Anmelden startet und für Desktop- oder Mobile-Clients gedacht ist, füge `--api-only` und einen erreichbaren Host hinzu:
+
+```bash
+openchamber startup enable --port 3000 --api-only --host 0.0.0.0 --ui-password secret
+```
+
+`startup enable` speichert deine aktuelle Umgebung als Schnappschuss im Dienst, damit er sich eher so verhält, als würdest du `openchamber` aus derselben Shell starten. So bleiben Provider-Tokens, `PATH`, SSH-Agent-Einstellungen und andere CLI-Auth-/Konfigurationsvariablen verfügbar. Verwende `--no-env-snapshot`, wenn du eine minimale Dienstenumgebung willst.
+
+Der Startup-Dienst merkt sich `--port`, `--host`, `--ui-password` und `--api-only`. CLI-Neustarts und Update-Neustarts verwenden diese gespeicherten Einstellungen wieder.
+
+Um einen Verbindungslink für eine andere OpenChamber-App zu erstellen, verwende:
+
+```bash
+openchamber connect-url --port 3000 --server http://your-host:3000 --qr
+```
+
+Führe `openchamber connect-url --help` aus, um alle Link-Optionen zu sehen, einschließlich `--name`, `--lan`, `--server`, `--api-only`, `--ui-password` und `--qr`.
+
+Du kannst Tunnel für diesen laufenden Dienst weiterhin unabhängig verwalten:
+
+```bash
+openchamber tunnel start --port 3000
+openchamber tunnel stop --port 3000
+```
+
+Das Stoppen des Tunnels startet weder den Dienst noch die App neu.
+
+## „OpenCode wird neu gestartet“
+
+Während der Server startet oder neu startet, zeigt OpenChamber den Status „OpenCode wird neu gestartet“ an und pausiert Anfragen, bis er bereit ist. Das ist direkt nach dem Start oder einem Neustart normal. Wenn er nie verschwindet, siehe [OpenCode-Verbindung](/troubleshooting/opencode-connection/).
+
+## Verwandtes
+
+- [Providers, Models & Agents](/providers/) — festlegen, womit der Server spricht
+- [OpenCode-Verbindung](/troubleshooting/opencode-connection/) — falls keine Verbindung möglich ist
diff --git a/packages/docs/content/docs/de/preview.mdx b/packages/docs/content/docs/de/preview.mdx
new file mode 100644
index 00000000..555f5023
--- /dev/null
+++ b/packages/docs/content/docs/de/preview.mdx
@@ -0,0 +1,32 @@
+---
+title: Vorschau & Entwicklungsserver
+description: Öffne einen laufenden Entwicklungsserver direkt in OpenChamber.
+---
+
+# Vorschau & Entwicklungsserver
+
+Wenn du einen Entwicklungsserver startest, kann OpenChamber ihn direkt in der App öffnen statt in einem separaten Browser-Tab — so kannst du deine Seite neben dem Chat sehen, ihre Konsole aufzeichnen und Elemente anstupsen, um Fragen dazu zu stellen.
+
+## Eine Vorschau öffnen
+
+OpenChamber überwacht die Terminalausgabe auf eine lokale Adresse (die `Local:`-Zeile, die Werkzeuge wie Vite, Next.js oder Astro ausgeben). Sobald es eine findet:
+
+- erscheint im Terminal eine Schaltfläche **Open preview**
+- öffnet eine [Projektaktion](/project-actions/) mit aktiviertem Auto-Open die Vorschau für dich
+- kann auch ein lokaler Link in einer Chatnachricht sie öffnen
+
+Die Seite lädt im Seitenbereich. Nur lokale Adressen (auf deinem eigenen Rechner) können als Vorschau geöffnet werden.
+
+## Konsole und Inspektion
+
+Im Vorschau-Bereich kannst du:
+
+- die **Konsole** der Seite beobachten — Fehler, Warnungen und Protokolle, so gefiltert, wie du möchtest
+- **inspect** einschalten, auf ein beliebiges Element klicken und eine Notiz dazu senden — Selektor, Stile, Position und ein Screenshot — direkt in den Chat
+
+Das ist der schnellste Weg, dem Agenten "diese Schaltfläche hier" zu sagen, ohne sie beschreiben zu müssen.
+
+## Verwandt
+
+- [Projektaktionen](/project-actions/) — einen Server automatisch öffnen, wenn du ihn startest
+- [Desktop-Browser](/desktop-browser/) — dieselben Werkzeuge für jede Seite, auf dem Desktop
diff --git a/packages/docs/content/docs/de/private-relay.mdx b/packages/docs/content/docs/de/private-relay.mdx
new file mode 100644
index 00000000..e14ad627
--- /dev/null
+++ b/packages/docs/content/docs/de/private-relay.mdx
@@ -0,0 +1,44 @@
+---
+title: Privates Relay
+description: Erreiche deinen OpenChamber-Server von überall über ein Ende-zu-Ende-verschlüsseltes Relay — ohne Ports, ohne Tunnel, ohne Einrichtung.
+---
+
+# Privates Relay
+
+Das OpenChamber Private Relay ermöglicht es deinen gekoppelten Geräten, deinen Server von überall aus zu erreichen — im Mobilfunknetz, im Café, in einer anderen Stadt — ohne Ports zu öffnen, einen Tunnel einzurichten oder deinen Rechner direkt mit dem Internet zu verbinden. Die Einrichtung ist selbstständig: Ein Gerät mit **Anywhere** unter [Connect a Device](/connect-devices/) zu koppeln reicht aus.
+
+## So funktioniert es
+
+Dein Server baut eine ausgehende Verbindung zur Relay-Infrastruktur von OpenChamber auf und hält sie offen. Wenn eines deiner Geräte außerhalb deines Netzwerks ist, verbindet es sich ebenfalls mit dem Relay, und das Relay leitet die verschlüsselten Daten zwischen beiden weiter. Auf deinem Rechner lauscht nichts auf eingehende Verbindungen aus dem Internet.
+
+Wenn eine direkte Verbindung verfügbar ist — du bist wieder zu Hause im selben WLAN — bevorzugen deine Geräte sie und umgehen das Relay vollständig.
+
+## Was das Relay sehen kann und was nicht
+
+Das Relay ist ein blinder Kurier, kein Vermittler:
+
+- **Ende-zu-Ende verschlüsselt.** Dein Gerät und dein Server handeln Verschlüsselungsschlüssel direkt miteinander aus. Das Relay leitet nur versiegelte Daten weiter, für die es keine Schlüssel hat — es kann weder deinen Code noch deine Prompts oder Passwörter lesen.
+- **Nur deine Geräte können sich verbinden.** Ein Gerät muss ein Token besitzen, das über [one-time pairing](/connect-devices/) von *deinem* Server ausgestellt wurde. Niemand kann deinen Server über das Relay entdecken oder ohne ein von dir erstelltes Token darauf zugreifen — und du kannst jedes Token jederzeit widerrufen.
+- **Pairing-Links sind nur einmal verwendbar.** Ein QR-Code zum Koppeln funktioniert genau einmal und läuft ab, wenn er nicht verwendet wird; ein geleakter alter Link ist also wertlos.
+- **Nichts wird geteilt, bevor du es erlaubst.** Das Relay bleibt aus, bis du es aktivierst oder ein Gerät darüber koppelst, und du kannst es jederzeit deaktivieren — Geräte, die darüber verbunden sind, werden sofort getrennt.
+
+## Wann es läuft
+
+Das Relay verwaltet seinen Lebenszyklus selbst — es gibt keinen Schalter, den du dir merken musst:
+
+- **Es startet bei Bedarf.** Das Erstellen einer **Anywhere**-Kopplung schaltet das Relay ein, und es kommt nach einem Neustart zurück, solange noch ein gekoppeltes Gerät davon abhängt.
+- **Es stoppt von selbst.** Sobald kein Gerät und keine ausstehende Kopplung das Relay mehr nutzt — zum Beispiel nachdem du das letzte Relay-gekoppelte Gerät widerrufen hast — fährt es automatisch herunter.
+
+**Settings → Remote Instances → OpenChamber Relay** zeigt den Live-Status (Connected, Reconnecting, …) und wie viele Geräte gerade darüber verbunden sind. Dort kannst du auch **Disable** drücken, um den Relay-Zugriff sofort zu beenden; Geräte im lokalen Netzwerk sind davon nicht betroffen.
+
+## Relay oder ein Tunnel?
+
+- Nutze das **Relay**, um von deinen eigenen gekoppelten Geräten aus deinen eigenen Server zu erreichen. Es kommt ohne Einrichtung aus, und nichts ist öffentlich exponiert.
+- Nutze einen [Tunnel](/tunnels/), wenn du eine einfache **öffentliche URL** brauchst — zum Beispiel um OpenChamber in einem normalen Browser auf einem Rechner zu öffnen, den du nicht koppeln kannst, oder um Zugriff hinter einem [UI password](/security/) zu teilen.
+
+## Verwandt
+
+- [Connect a Device](/connect-devices/) — ein Gerät mit einem einmaligen QR-Code koppeln
+- [Mobile Apps](/mobile/) — die iOS- oder Android-App installieren
+- [Security](/security/) — Passwörter, Passkeys und Grundlagen der Freigabe
+- [Remote access](/troubleshooting/remote-access/) — wenn eine Verbindung nicht zustande kommt
diff --git a/packages/docs/content/docs/de/project-actions.mdx b/packages/docs/content/docs/de/project-actions.mdx
new file mode 100644
index 00000000..a0ef9b78
--- /dev/null
+++ b/packages/docs/content/docs/de/project-actions.mdx
@@ -0,0 +1,28 @@
+---
+title: Projektaktionen
+description: Speichere Befehle, die du oft ausführst, und starte sie mit einem Klick.
+---
+
+# Projektaktionen
+
+Eine Projektaktion ist ein Shell-Befehl, den du einmal speicherst und dann mit einem Klick ausführst — dein Entwicklungsserver, ein Build, ein Testlauf. Jedes Projekt hat seine eigene Liste. Richte sie unter **Einstellungen → Projekte → Projektaktionen** ein.
+
+## Eine Aktion hinzufügen
+
+1. Öffne **Einstellungen → Projekte** und suche den Bereich **Projektaktionen**.
+2. Füge eine Aktion hinzu, gib ihr einen Namen, wähle ein Symbol und gib den auszuführenden Befehl ein.
+3. Speichern.
+
+Du kannst eine Aktion auf bestimmte Betriebssysteme beschränken, wenn ein Befehl nur auf einem davon sinnvoll ist.
+
+## Eine Aktion ausführen
+
+Aktionen liegen in einem Menü im App-Header. Klicke auf eine und OpenChamber führt sie in einem Terminal in deinem Projektordner aus und wechselt dich in die Terminalansicht, damit du die Ausgabe verfolgen kannst. Stoppe sie über dasselbe Menü.
+
+## Einen Entwicklungsserver automatisch öffnen
+
+Aktiviere **auto-open URL** für eine Aktion, die einen Server startet. OpenChamber überwacht die Ausgabe auf eine lokale Adresse und bietet an, sie zu öffnen — siehe [Vorschau & Entwicklungsserver](/preview/). Auf dem Desktop kannst du sie außerdem über einen SSH-Port-Forward leiten.
+
+## Verwandt
+
+- [Vorschau & Entwicklungsserver](/preview/) — einen laufenden Entwicklungsserver in OpenChamber öffnen
diff --git a/packages/docs/content/docs/de/project-icons.mdx b/packages/docs/content/docs/de/project-icons.mdx
new file mode 100644
index 00000000..3e0775ec
--- /dev/null
+++ b/packages/docs/content/docs/de/project-icons.mdx
@@ -0,0 +1,20 @@
+---
+title: Projektsymbole
+description: Geben Sie jedem Projekt ein wiedererkennbares Symbol.
+---
+
+# Projektsymbole
+
+Ein Projektsymbol macht es leicht, Ihre Projekte auf einen Blick zu unterscheiden. OpenChamber versucht, eines für Sie zu finden, und Sie können jederzeit Ihr eigenes setzen. Verwalten Sie es unter **Einstellungen → Projekte**.
+
+## Automatische Erkennung
+
+Wenn Sie ein Projekt hinzufügen, sucht OpenChamber darin nach einer `favicon`-Datei und verwendet sie als Symbol des Projekts. Wenn Ihr Repo bereits ein Favicon ausliefert, erscheint das Symbol meist einfach — Sie müssen nichts tun.
+
+## Eigenes festlegen
+
+Öffnen Sie **Einstellungen → Projekte** und laden Sie ein Bild hoch (PNG, JPEG oder SVG, bis zu 5 MB). Ein benutzerdefiniertes Bild hat Vorrang vor dem automatisch erkannten. Sie können stattdessen auch eine Farbe wählen oder das Bild entfernen, um zur Erkennung zurückzukehren.
+
+## Verwandt
+
+- [Projekte](/projects/) — Ihre Projekte benennen, einfärben und organisieren
diff --git a/packages/docs/content/docs/de/projects.mdx b/packages/docs/content/docs/de/projects.mdx
new file mode 100644
index 00000000..8baf4c22
--- /dev/null
+++ b/packages/docs/content/docs/de/projects.mdx
@@ -0,0 +1,34 @@
+---
+title: Projekte
+description: Organisiere deine Arbeit in Projekten und wechsle zwischen ihnen.
+---
+
+# Projekte
+
+Ein Projekt ist ein Ordner auf deinem Computer, den OpenChamber im Blick behält — normalerweise eine Codebasis. Wenn du das Projekt wechselst, wechselt der Ordner, in dem der Agent arbeitet, zusammen mit den Sessions und Einstellungen dieses Projekts.
+
+## Ein Projekt hinzufügen
+
+Du kannst ein Projekt an ein paar Stellen hinzufügen:
+
+- der Eintrag **Projekt hinzufügen** in der Befehlspalette
+- die Schaltfläche **+** oben in der Session-Seitenleiste
+- der Ordnerbrowser, wenn du ein Verzeichnis auswählst
+
+Zeige auf einen Ordner, und OpenChamber merkt ihn sich. Der Name kommt vom Ordner; du kannst ihn später ändern.
+
+## Projekte wechseln
+
+Wähle ein Projekt in der Seitenleiste aus, um es aktiv zu machen. Alles — Sessions, Git, Notizen — folgt dem Projekt, das du geöffnet hast.
+
+## Ein Projekt wiedererkennbar machen
+
+Öffne **Einstellungen → Projekte**, um einem Projekt einen eigenen Namen, eine Farbe oder ein Symbol zu geben. OpenChamber versucht, automatisch ein Symbol zu finden — siehe [Projekt-Symbole](/project-icons/).
+
+> In VS Code verwendet OpenChamber immer den Ordner, den du geöffnet hast, als einziges Projekt. Es gibt dort also nichts hinzuzufügen oder umzuschalten. Die Seite mit den Projekteinstellungen ist dort ausgeblendet.
+
+## Verwandtes
+
+- [Projektnotizen, Todos & Pläne](/notes-todos-plans/) — Arbeitsnotizen pro Projekt behalten
+- [Projektaktionen](/project-actions/) — Befehle speichern, die du oft ausführst
+- [Kontext](/context/) — sehen, wie viel des Modellgedächtnisses eine Session verbraucht
diff --git a/packages/docs/content/docs/de/providers.mdx b/packages/docs/content/docs/de/providers.mdx
new file mode 100644
index 00000000..4d5738f5
--- /dev/null
+++ b/packages/docs/content/docs/de/providers.mdx
@@ -0,0 +1,49 @@
+---
+title: Provider, Modelle & Agents
+description: Verbinde KI-Provider, wähle Modelle aus und richte Agents ein.
+---
+
+# Provider, Modelle & Agents
+
+Bevor OpenChamber etwas tun kann, braucht es mindestens einen verbundenen KI-Provider. Diese Seite erklärt, wie du einen Provider verbindest, ein Modell auswählst und Agents anpasst.
+
+## Einen Provider verbinden
+
+1. Öffne **Einstellungen → Provider**.
+2. Öffne das Menü **Provider hinzufügen** und wähle einen Provider aus, der noch nicht verbunden ist.
+3. Melde dich auf eine von zwei Arten an, je nach Provider:
+ - **API-Schlüssel** — füge deinen Schlüssel ein und speichere.
+ - **Anmeldung (Gerätefluss)** — OpenChamber zeigt einen Link und einen kurzen Code an. Öffne den Link, gib den Code ein und bestätige. OpenChamber schließt die Verbindung dann selbstständig ab.
+
+Wenn ein Provider als verbunden angezeigt wird, sind seine Modelle im Chat verfügbar.
+
+Zum Trennen öffnest du den Provider und entfernst seine Anmeldung.
+
+## Ein Modell auswählen
+
+Du wählst das Modell dort aus, wo du arbeitest:
+
+- im Chat verwendest du den Modellwähler in der Nachrichtenleiste, um Provider und Modell für diese Sitzung festzulegen
+- pro Agent legst du unten ein Standardmodell fest
+
+## Agents einrichten
+
+Ein Agent ist eine benannte Konfiguration — ein Modell, eine Persönlichkeit und das, was er tun darf.
+
+1. Öffne **Einstellungen → Agents**.
+2. Wähle einen Agenten aus oder erstelle einen neuen.
+3. Bearbeite beliebige dieser Felder:
+ - **Beschreibung** — wofür der Agent gedacht ist
+ - **Modell** — sein Standardmodell
+ - **Temperatur** — wie kreativ seine Antworten sind
+ - **Prompt** — dauerhafte Anweisungen, denen er immer folgt
+ - **Tool-Regeln** — welche Werkzeuge er verwenden darf
+
+## Wo deine Anmeldungen gespeichert werden
+
+Provider-Anmeldungen werden von OpenCode gespeichert, nicht von OpenChamber, daher sind sie mit der OpenCode-CLI geteilt. Wenn du denselben Provider an mehr als einem Ort einrichtest, gewinnt die spezifischste Einstellung: Eine projektbezogene Einstellung überschreibt deine persönliche.
+
+## Weiterführend
+
+- [MCP-Server](/mcp/) — füge Agents zusätzliche Werkzeuge hinzu
+- [Nutzung & Kontingente](/usage/) — verfolge, wie viel du verbraucht hast
diff --git a/packages/docs/content/docs/de/quickstart.mdx b/packages/docs/content/docs/de/quickstart.mdx
new file mode 100644
index 00000000..5411db01
--- /dev/null
+++ b/packages/docs/content/docs/de/quickstart.mdx
@@ -0,0 +1,26 @@
+---
+title: Schnellstart
+description: Starte OpenChamber schnell und wähle die richtige App für die Aufgabe.
+---
+
+# Schnellstart
+
+## Schnellster Weg
+
+1. Installiere [OpenCode](https://opencode.ai).
+2. Installiere das OpenChamber-CLI (siehe [Installieren](/install/) für den Einzeilenbefehl).
+3. Führe `openchamber --ui-password be-creative-here` aus.
+4. Öffne die URL, die das CLI ausgibt (normalerweise `http://localhost:3000`).
+5. Um es auf deinem Handy zu nutzen, starte einen [Tunnel](/tunnels/) und scanne den QR-Code.
+
+Du solltest die OpenChamber-Session-Liste in deinem Browser sehen. Wenn sie geladen wird, bist du startklar.
+
+Verwende ein starkes UI-Passwort, besonders wenn du die Instanz ins Internet öffnen willst.
+
+Wenn die Seite nicht lädt, sieh unter [Troubleshooting](/troubleshooting/) nach.
+
+## Welche App soll ich verwenden?
+
+- verwende **Desktop** für die tägliche Arbeit auf macOS
+- verwende **Web** für den Remote-Zugriff und zum Prüfen vom Handy aus
+- verwende **VS Code** für Sessions direkt neben deinem Code
diff --git a/packages/docs/content/docs/de/remote-instances.mdx b/packages/docs/content/docs/de/remote-instances.mdx
new file mode 100644
index 00000000..91bb8216
--- /dev/null
+++ b/packages/docs/content/docs/de/remote-instances.mdx
@@ -0,0 +1,48 @@
+---
+title: Remote-Instanzen
+description: Verbinde die Desktop-App per SSH mit OpenChamber auf einem anderen Rechner.
+---
+
+# Remote-Instanzen
+
+Die Desktop-App kann per SSH mit OpenChamber auf einem anderen Rechner verbunden werden — einem Arbeitsserver, einer Cloud-Box, einem Homelab — und dessen UI so auf deinen Bildschirm bringen, als wäre sie lokal. Richte das unter **Settings → Remote Instances** ein.
+
+> Remote-Instanzen sind eine Funktion **nur für den Desktop**. Im Web oder in VS Code verbindest du dich stattdessen über die Umgebungsvariablen in [OpenCode Server](/opencode-server/) mit einem Remote-Server.
+
+## Remote-Instanz hinzufügen
+
+1. Öffne **Settings → Remote Instances** und füge eine hinzu.
+2. Gib den SSH-Befehl an, den du normalerweise für den Zugriff auf den Rechner verwendest, plus einen Spitznamen.
+3. Wähle, wie OpenChamber dort läuft:
+ - **managed** — OpenChamber installiert und startet sich auf dem entfernten Rechner selbst
+ - **external** — verbinde dich mit einer Instanz, die bereits läuft
+4. Verbinde dich.
+
+OpenChamber geht die Schritte durch — Verbindung prüfen, Remote einrichten, Server starten und den Port weiterleiten — und zeigt bei jedem Schritt, wo es gerade ist. Wenn **ready** erreicht ist, wird die entfernte UI lokal geladen.
+
+## Anmeldedaten
+
+Du entscheidest, ob SSH- und UI-Passwörter gespeichert werden oder ob du sie jedes Mal eingibst. Wenn die Verbindung abbricht, meldet OpenChamber, welcher Schritt fehlgeschlagen ist, damit du ihn beheben kannst — siehe [Remote access](/troubleshooting/remote-access/).
+
+## Verbindungslinks
+
+Wenn auf einem entfernten Rechner bereits OpenChamber läuft, ist ein Kopplungslink der einfachste Weg, die Desktop-App zu verbinden. Öffne auf der UI des entfernten Servers **Settings → Remote Instances → Connect to this server → Add a device**, erstelle einen Link und importiere ihn auf deinem Desktop unter **Settings → Remote Instances → Other OpenChamber servers → Import Link**. Den vollständigen Ablauf findest du unter [Connect a Device](/connect-devices/).
+
+Ein mit **Anywhere** erstellter Link enthält sowohl eine direkte Adresse als auch eine Route über das [Private Relay](/private-relay/): Die Desktop-App verbindet sich direkt, wenn sie den Server erreichen kann (gleiches Netzwerk), und fällt auf das Ende-zu-Ende-verschlüsselte Relay zurück, wenn du unterwegs bist. Der Status neben jedem gespeicherten Server zeigt, welche Route gerade verwendet wird.
+
+Du kannst einen Link auch in einem Terminal auf dem entfernten Rechner erstellen:
+
+```bash
+openchamber connect-url --port 3000 --server http://your-host:3000 --qr
+```
+
+`connect-url` startet den Server zuerst, wenn auf diesem Port nichts läuft. Füge `--api-only` für einen headless Server hinzu, `--lan`, um beim Starten an das LAN zu binden, `--ui-password`, um den Browserzugriff zu schützen, und `--name`, um die gespeicherte Verbindung zu benennen. Füge `--relay` für einen Link hinzu, der auch außerhalb des lokalen Netzwerks funktioniert: Das Gerät bevorzugt die direkte Verbindung, wenn sie erreichbar ist, und fällt auf das [Private Relay](/private-relay/) zurück — die Instanz startet das Relay selbstständig.
+
+Der erzeugte Link enthält ein Einmal-Geheimnis zum Koppeln. Nach dem Import besitzt das Gerät sein eigenes Client-Token — getrennt vom UI password des Browsers —, das Server-Neustarts überdauert, bis du es auf dem ausstellenden Server widerrufst.
+
+## Verwandt
+
+- [Connect a Device](/connect-devices/) — Kopplungslinks, QR-Codes und Geräteverwaltung
+- [Private Relay](/private-relay/) — wie "Anywhere"-Verbindungen funktionieren
+- [OpenCode Server](/opencode-server/) — eine Verbindung zu einem entfernten Server in Web oder VS Code herstellen
+- [Remote access](/troubleshooting/remote-access/) — wenn eine Verbindung nicht zustande kommt
diff --git a/packages/docs/content/docs/de/reverse-proxy.mdx b/packages/docs/content/docs/de/reverse-proxy.mdx
new file mode 100644
index 00000000..40e4221b
--- /dev/null
+++ b/packages/docs/content/docs/de/reverse-proxy.mdx
@@ -0,0 +1,347 @@
+---
+title: Reverse Proxy
+description: Konfigurieren Sie OpenChamber korrekt hinter Nginx, Nginx Proxy Manager oder einem anderen Reverse Proxy.
+---
+
+# Reverse Proxy
+
+Nutzen Sie diese Seite, wenn OpenChamber hinter Nginx, Nginx Proxy Manager, Caddy, Cloudflare oder einem anderen Reverse Proxy läuft.
+
+## Bevor Sie es proxyen
+
+1. Bestätigen Sie zuerst, dass OpenChamber direkt funktioniert.
+2. Öffnen Sie `http://:3000` oder Ihren benutzerdefinierten Port aus demselben Netzwerk.
+3. Fügen Sie den Reverse Proxy erst hinzu, wenn die Direktverbindung funktioniert.
+
+## Was der Proxy unterstützen muss
+
+- WebSockets für den Live-Nachrichtenverkehr:
+ - `/api/event/ws`
+ - `/api/global/event/ws`
+ - `/api/terminal/ws`
+- SSE ohne Buffering:
+ - `/api/event`
+ - `/api/global/event`
+ - `/api/notifications/stream`
+ - `/api/openchamber/events`
+ - `/api/terminal/:sessionId/stream`
+- Große Request-Bodies für Anhänge und Dateioperationen
+- Lange Read-Timeouts für Live-Streams und Terminal-Sitzungen
+
+## Wichtige Regeln
+
+- Aktivieren Sie das Proxying für WebSockets.
+- Deaktivieren Sie Buffering auf SSE-Routen.
+- Deaktivieren Sie gzip auf dem Proxy, wenn OpenChamber Antworten bereits komprimiert.
+- Halten Sie Komprimierung nur in einer Ebene aktiv.
+- Leiten Sie normale Proxy-Header wie `Host`, `X-Forwarded-For` und `X-Forwarded-Proto` weiter.
+- Erhöhen Sie die Body-Größenlimits, wenn Nutzer Dateien hochladen.
+
+## Kurze Checkliste
+
+- OpenChamber direkt im LAN erreichbar
+- WebSockets im Proxy aktiviert
+- SSE-Routen ohne Buffering
+- `gzip off` auf dem Proxy-Host oder Komprimierung anderweitig deaktiviert
+- `client_max_body_size` groß genug für Anhänge
+- `proxy_read_timeout` lang genug für Streams
+
+## Beispiel: Nginx
+
+
+Beispielkonfiguration anzeigen
+
+```nginx
+client_max_body_size 50M;
+client_body_buffer_size 50M;
+proxy_request_buffering off;
+
+proxy_http_version 1.1;
+proxy_set_header Connection "";
+proxy_set_header Host $host;
+proxy_set_header X-Real-IP $remote_addr;
+proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+proxy_set_header X-Forwarded-Proto $scheme;
+proxy_set_header X-Forwarded-Host $host;
+
+gzip off;
+
+location = /api/terminal/ws {
+ proxy_pass http://127.0.0.1:3000;
+ proxy_set_header Upgrade $http_upgrade;
+ proxy_set_header Connection "upgrade";
+ proxy_buffering off;
+ proxy_cache off;
+ proxy_read_timeout 3600s;
+ proxy_send_timeout 3600s;
+}
+
+location = /api/global/event/ws {
+ proxy_pass http://127.0.0.1:3000;
+ proxy_set_header Upgrade $http_upgrade;
+ proxy_set_header Connection "upgrade";
+ proxy_buffering off;
+ proxy_cache off;
+ proxy_read_timeout 3600s;
+ proxy_send_timeout 3600s;
+}
+
+location = /api/event/ws {
+ proxy_pass http://127.0.0.1:3000;
+ proxy_set_header Upgrade $http_upgrade;
+ proxy_set_header Connection "upgrade";
+ proxy_buffering off;
+ proxy_cache off;
+ proxy_read_timeout 3600s;
+ proxy_send_timeout 3600s;
+}
+
+location ~ ^/api/(event|global/event|notifications/stream|openchamber/events)$ {
+ proxy_pass http://127.0.0.1:3000;
+ proxy_set_header Accept "text/event-stream";
+ proxy_set_header Cache-Control "no-cache";
+ proxy_buffering off;
+ proxy_cache off;
+ gzip off;
+ add_header X-Accel-Buffering "no" always;
+ add_header Cache-Control "no-cache, no-transform" always;
+ proxy_read_timeout 3600s;
+ proxy_send_timeout 3600s;
+}
+
+location ~ ^/api/terminal/.+/stream$ {
+ proxy_pass http://127.0.0.1:3000;
+ proxy_set_header Accept "text/event-stream";
+ proxy_set_header Cache-Control "no-cache";
+ proxy_buffering off;
+ proxy_cache off;
+ gzip off;
+ add_header X-Accel-Buffering "no" always;
+ add_header Cache-Control "no-cache, no-transform" always;
+ proxy_read_timeout 3600s;
+ proxy_send_timeout 3600s;
+}
+
+location /api {
+ proxy_pass http://127.0.0.1:3000;
+ proxy_read_timeout 3600s;
+ proxy_send_timeout 3600s;
+}
+
+location / {
+ proxy_pass http://127.0.0.1:3000;
+}
+```
+
+
+
+## Beispiel: Nginx Proxy Manager
+
+
+Beispiel für den Tab „Advanced“ anzeigen
+
+```nginx
+client_max_body_size 50M;
+client_body_buffer_size 50M;
+proxy_request_buffering off;
+
+proxy_http_version 1.1;
+proxy_set_header Connection "";
+proxy_set_header Host $host;
+proxy_set_header X-Real-IP $remote_addr;
+proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+proxy_set_header X-Forwarded-Proto $scheme;
+proxy_set_header X-Forwarded-Host $host;
+
+gzip off;
+
+location = /api/terminal/ws {
+ proxy_pass http://127.0.0.1:3000;
+ proxy_set_header Upgrade $http_upgrade;
+ proxy_set_header Connection "upgrade";
+ proxy_buffering off;
+ proxy_cache off;
+ proxy_read_timeout 3600s;
+ proxy_send_timeout 3600s;
+ proxy_connect_timeout 30s;
+}
+
+location = /api/global/event/ws {
+ proxy_pass http://127.0.0.1:3000;
+ proxy_set_header Upgrade $http_upgrade;
+ proxy_set_header Connection "upgrade";
+ proxy_buffering off;
+ proxy_cache off;
+ proxy_read_timeout 3600s;
+ proxy_send_timeout 3600s;
+ proxy_connect_timeout 30s;
+}
+
+location = /api/event/ws {
+ proxy_pass http://127.0.0.1:3000;
+ proxy_set_header Upgrade $http_upgrade;
+ proxy_set_header Connection "upgrade";
+ proxy_buffering off;
+ proxy_cache off;
+ proxy_read_timeout 3600s;
+ proxy_send_timeout 3600s;
+ proxy_connect_timeout 30s;
+}
+
+location = /api/event {
+ proxy_pass http://127.0.0.1:3000;
+ proxy_set_header Accept "text/event-stream";
+ proxy_set_header Cache-Control "no-cache";
+ proxy_buffering off;
+ proxy_cache off;
+ gzip off;
+ add_header X-Accel-Buffering "no" always;
+ add_header Cache-Control "no-cache, no-transform" always;
+ proxy_read_timeout 3600s;
+ proxy_send_timeout 3600s;
+ proxy_connect_timeout 30s;
+}
+
+location = /api/global/event {
+ proxy_pass http://127.0.0.1:3000;
+ proxy_set_header Accept "text/event-stream";
+ proxy_set_header Cache-Control "no-cache";
+ proxy_buffering off;
+ proxy_cache off;
+ gzip off;
+ add_header X-Accel-Buffering "no" always;
+ add_header Cache-Control "no-cache, no-transform" always;
+ proxy_read_timeout 3600s;
+ proxy_send_timeout 3600s;
+ proxy_connect_timeout 30s;
+}
+
+location = /api/notifications/stream {
+ proxy_pass http://127.0.0.1:3000;
+ proxy_set_header Accept "text/event-stream";
+ proxy_set_header Cache-Control "no-cache";
+ proxy_buffering off;
+ proxy_cache off;
+ gzip off;
+ add_header X-Accel-Buffering "no" always;
+ add_header Cache-Control "no-cache, no-transform" always;
+ proxy_read_timeout 3600s;
+ proxy_send_timeout 3600s;
+ proxy_connect_timeout 30s;
+}
+
+location = /api/openchamber/events {
+ proxy_pass http://127.0.0.1:3000;
+ proxy_set_header Accept "text/event-stream";
+ proxy_set_header Cache-Control "no-cache";
+ proxy_buffering off;
+ proxy_cache off;
+ gzip off;
+ add_header X-Accel-Buffering "no" always;
+ add_header Cache-Control "no-cache, no-transform" always;
+ proxy_read_timeout 3600s;
+ proxy_send_timeout 3600s;
+ proxy_connect_timeout 30s;
+}
+
+location ~ ^/api/terminal/.+/stream$ {
+ proxy_pass http://127.0.0.1:3000;
+ proxy_set_header Accept "text/event-stream";
+ proxy_set_header Cache-Control "no-cache";
+ proxy_buffering off;
+ proxy_cache off;
+ gzip off;
+ add_header X-Accel-Buffering "no" always;
+ add_header Cache-Control "no-cache, no-transform" always;
+ proxy_read_timeout 3600s;
+ proxy_send_timeout 3600s;
+ proxy_connect_timeout 30s;
+}
+
+location /api {
+ proxy_pass http://127.0.0.1:3000;
+ proxy_read_timeout 3600s;
+ proxy_send_timeout 3600s;
+ proxy_connect_timeout 30s;
+}
+
+location / {
+ proxy_pass http://127.0.0.1:3000;
+}
+```
+
+
+
+Aktivieren Sie für diesen Host außerdem `Websockets Support` in Nginx Proxy Manager.
+
+## Häufige Fehlersymptome
+
+### Seite lädt, aber das Senden von Nachrichten schlägt fehl
+
+- WebSockets sind im Proxy nicht aktiviert
+- `/api/event/ws` oder `/api/global/event/ws` wird nicht korrekt weitergeleitet
+
+### Benachrichtigungen oder Live-Status werden nicht aktualisiert
+
+- eine der SSE-Routen wird gepuffert oder gecacht
+- `X-Accel-Buffering "no"` fehlt
+
+### Datei-Uploads schlagen fehl
+
+- `client_max_body_size` ist zu klein
+
+### Alles funktioniert lokal, bricht aber nur hinter dem Proxy
+
+- der Proxy komprimiert und puffert Live-Verkehr
+- dem Proxy fehlt WebSocket-Unterstützung
+
+## Beispiel: Caddy
+
+
+Beispielkonfiguration anzeigen
+
+```caddy
+reverse_proxy 127.0.0.1:3000 {
+ # WebSocket-Unterstützung ist in Caddy automatisch vorhanden
+
+ # SSE-Antworten sofort flushen
+ flush_interval -1
+
+ # Host- und Proxy-Header weiterreichen
+ header_up Host {host}
+ header_up X-Real-IP {remote_host}
+ header_up X-Forwarded-For {remote_host}
+ header_up X-Forwarded-Proto {scheme}
+
+ # Timeouts für langlebige Streams erhöhen
+ transport http {
+ read_timeout 3600s
+ write_timeout 3600s
+ }
+}
+```
+
+
+
+Caddy behandelt WebSocket-Upgrades automatisch — keine zusätzliche Konfiguration nötig. Die Direktive `flush_interval -1` sorgt dafür, dass SSE-Teilstücke ohne Buffering sofort weitergeleitet werden.
+
+## Warnung zu CDN und doppelter Komprimierung
+
+Wenn Sie ein CDN (wie Cloudflare) vor Ihren Reverse Proxy setzen, achten Sie auf doppelte Komprimierung:
+
+- OpenChamber komprimiert HTTP-Antworten mit gzip (Schwelle 1 KB).
+- Cloudflare und andere CDNs komprimieren Antworten standardmäßig ebenfalls.
+- Das kann zu doppelt komprimierten Antworten oder falschen `Content-Encoding`-Headern führen.
+
+Um das zu vermeiden, deaktivieren Sie die Komprimierung auf **einer** Ebene:
+
+- **Cloudflare:** Rules → Compression → deaktivieren (oder den Modus „Passthrough“ verwenden).
+- **Nginx:** `gzip off` (oben in den Beispielen bereits gezeigt).
+- **Caddy:** Caddy komprimiert standardmäßig nicht erneut, wenn der Upstream bereits komprimierte Inhalte sendet.
+
+SSE-Streaming-Routen sind von OpenChamber von der Komprimierung ausgeschlossen, das CDN kann sie aber trotzdem puffern. Prüfen Sie in der CDN-Dokumentation, wie sich Buffering auf SSE-Pfaden deaktivieren lässt.
+
+## Verwandt
+
+- [Tunnels](/tunnels/)
+- [Fehlerbehebung](/troubleshooting/)
diff --git a/packages/docs/content/docs/de/scheduled-tasks.mdx b/packages/docs/content/docs/de/scheduled-tasks.mdx
new file mode 100644
index 00000000..ac80c229
--- /dev/null
+++ b/packages/docs/content/docs/de/scheduled-tasks.mdx
@@ -0,0 +1,35 @@
+---
+title: Geplante Aufgaben
+description: Führe einen Prompt automatisch nach Zeitplan aus.
+---
+
+# Geplante Aufgaben
+
+Eine geplante Aufgabe führt für dich nach Zeitplan einen Prompt aus — zum Beispiel täglich „die Änderungen von gestern zusammenfassen“ oder wöchentlich eine Bereinigung. Wenn sie läuft, startet OpenChamber eine neue Session und sendet den Prompt selbst. Öffne den Scheduler über die Schaltfläche oben in der Session-Seitenleiste.
+
+## Eine Aufgabe erstellen
+
+1. Öffne den Dialog für geplante Aufgaben in der Session-Seitenleiste.
+2. Füge eine Aufgabe hinzu und gib ihr einen Namen.
+3. Wähle, wann sie läuft:
+ - **daily** — zu einer oder mehreren Zeiten pro Tag
+ - **weekly** — an ausgewählten Wochentagen und Uhrzeiten
+ - **once** — ein einzelnes Datum und eine einzelne Uhrzeit
+4. Lege fest, was sie tut: den zu sendenden Prompt sowie Provider, Modell und Agent, die verwendet werden sollen. Der Prompt kann ein Slash-Befehl sein, zum Beispiel `/review`.
+5. Speichern und sicherstellen, dass die Aufgabe aktiviert ist.
+
+Du kannst jede Aufgabe sofort mit **run now** ausführen, um zu prüfen, ob sie das tut, was du erwartest.
+
+Aktiviere **Run as goal**, damit der Lauf seinen Prompt bis zum Abschluss verfolgt, statt nach einer Antwort zu stoppen — siehe [Session Goals](/session-goals/).
+
+## Woran du Erfolg erkennst
+
+Nach einem Lauf zeigt die Aufgabe, wann sie zuletzt gelaufen ist, ob sie erfolgreich war und einen Link zur Session, die sie erstellt hat. Wenn ein Lauf fehlschlägt, wird dort auch der Fehler angezeigt.
+
+## Wichtig zu wissen
+
+Aufgaben werden nur ausgelöst, während der OpenChamber-Server läuft. Wenn du ihn schließt, sind geplante Läufe pausiert, bis er wieder online ist.
+
+## Verwandtes
+
+- [Commands & Snippets](/commands-snippets/) — einen Slash-Befehl als Prompt wiederverwenden
diff --git a/packages/docs/content/docs/de/security.mdx b/packages/docs/content/docs/de/security.mdx
new file mode 100644
index 00000000..e00bb7cd
--- /dev/null
+++ b/packages/docs/content/docs/de/security.mdx
@@ -0,0 +1,44 @@
+---
+title: Sicherheit
+description: Schützen Sie die UI mit einem Passwort und Passkeys, bevor Sie sie freigeben.
+---
+
+# Sicherheit
+
+OpenChamber gewährt Zugriff auf Ihren Rechner und Ihren Code. Sperren Sie es also ab, bevor jemand außer Ihnen darauf zugreifen kann. Diese Seite behandelt das UI-Passwort, Passkeys und was Sie wissen sollten, bevor Sie OpenChamber in ein Netzwerk exponieren.
+
+## UI-Passwort setzen
+
+Starten Sie OpenChamber mit einem Passwort, und die Browser-UI fragt danach:
+
+```bash
+openchamber --ui-password be-creative-here
+```
+
+Sie können es auch über die Umgebungsvariable `OPENCHAMBER_UI_PASSWORD` setzen, statt es in die Befehlszeile zu schreiben. Nach der Anmeldung merkt sich OpenChamber das Gerät für eine Weile, damit Sie nicht jedes Mal gefragt werden.
+
+Setzen Sie immer ein Passwort, wenn die Instanz für andere erreichbar ist — besonders über einen [Tunnel](/tunnels/) oder das öffentliche Internet.
+
+## Passkeys
+
+Sobald ein Passwort gesetzt ist, können Sie Passkeys (Face ID, Touch ID, ein Sicherheitsschlüssel) für eine schnellere Anmeldung hinzufügen. Fügen Sie sie unter **Einstellungen → OpenChamber → Passkeys** hinzu.
+
+Passkeys sind an das aktuelle Passwort gebunden. Wenn Sie das Passwort ändern oder entfernen, werden gespeicherte Passkeys gelöscht und Sie fügen sie erneut hinzu.
+
+## Geräte-Tokens
+
+Geräte, die über [Ein Gerät verbinden](/connect-devices/) gekoppelt werden, authentifizieren sich mit eigenen gerätespezifischen Tokens, nicht mit dem UI-Passwort. Pairing-Links sind nur einmal nutzbar und laufen ab, wenn sie nicht verwendet werden; jedes gekoppelte Gerät wird unter **Einstellungen → Remote-Instanzen → Mit diesem Server verbinden** aufgeführt, wo Sie es jederzeit widerrufen können. Verbindungen von außerhalb laufen über das [Private Relay](/private-relay/), das Ende-zu-Ende verschlüsselt ist und Ihren Traffic nicht lesen kann.
+
+## Bevor Sie es freigeben
+
+- Standardmäßig lauscht OpenChamber nur auf Ihrem eigenen Rechner (`127.0.0.1`). Es braucht eine bewusste Änderung, um breiter zu lauschen, und Sie sollten vorher ein Passwort setzen.
+- Für Ihre eigenen Geräte bevorzugen Sie [Pairing](/connect-devices/) mit dem [Private Relay](/private-relay/) — dabei wird überhaupt nichts öffentlich freigegeben.
+- Wenn Sie eine öffentliche URL brauchen, verwenden Sie lieber einen [Tunnel](/tunnels/) oder ein privates Netzwerk (z. B. VPN), statt einen Port ins Internet zu öffnen.
+- Wenn Sie OpenChamber hinter Ihrem eigenen HTTPS-Server betreiben, sehen Sie sich [Reverse Proxy](/reverse-proxy/) an.
+
+## Verwandt
+
+- [Ein Gerät verbinden](/connect-devices/) — einmaliges Pairing und gerätespezifische Tokens
+- [Private Relay](/private-relay/) — Ende-zu-Ende-verschlüsselter Zugriff von überall
+- [Tunnel](/tunnels/) — eine öffentliche URL freigeben, wenn Sie eine brauchen
+- [Reverse Proxy](/reverse-proxy/) — OpenChamber hinter Ihrem eigenen Server betreiben
diff --git a/packages/docs/content/docs/de/session-goals.mdx b/packages/docs/content/docs/de/session-goals.mdx
new file mode 100644
index 00000000..3b7a2bf1
--- /dev/null
+++ b/packages/docs/content/docs/de/session-goals.mdx
@@ -0,0 +1,73 @@
+---
+title: Sitzungsziele
+description: Verwandelt eine Aufforderung in ein Ziel, auf das der Agent automatisch hinarbeitet.
+---
+
+# Sitzungsziele
+
+Ein Ziel macht aus einer Aufforderung eine Ziellinie. Statt den Agenten nach jeder Antwort mit "continue" anzustupsen, legst du das Ziel einmal fest — und OpenChamber hält die Sitzung automatisch darauf ausgerichtet und prüft nach jedem Zug mit einem unabhängigen Prüfer den Fortschritt. Es läuft weiter, auch wenn du nicht da bist.
+
+## Ein Ziel starten
+
+1. Drücke in der Composer-Ansicht die Zielschaltfläche. Sie leuchtet auf — der Zielmodus ist aktiviert.
+2. Gib deine Aufforderung ein und sende sie ab. Diese Nachricht wird zum Ziel des Vorhabens.
+
+Das funktioniert in einer bestehenden Sitzung ebenso wie in einem neuen Sitzungsentwurf: Zielmodus aktivieren, die erste Nachricht schreiben, senden — die neue Sitzung startet mit dem bereits aktiven Ziel.
+
+### Weitere Wege, ein Ziel zu starten
+
+- **Aus einer Antwort des Agenten**: Im Dialog "Start new session from this answer" aktiviere **Run as goal** — die Antwort wird als Aufgabe übergeben, die die neue Sitzung bis zum Abschluss ausführt (kombiniere das mit **Create worktree** für einen isolierten Lauf).
+- **Aus einem Plan**: Wenn du einen gespeicherten Plan in einer neuen Sitzung oder einem Worktree umsetzt, aktiviere im Dialog **Run as goal**. Das Ziel übernimmt den Planinhalt als seine Aufgabe, sodass der Prüfer den Fortschritt am tatsächlichen Plan misst.
+- **Nach Zeitplan**: Aktiviere bei einer [geplanten Aufgabe](/scheduled-tasks/) **Run as goal**, damit wiederkehrende Läufe ihre Aufforderung bis zum Abschluss verfolgen.
+
+## Eine eigenständige Zielbeschreibung schreiben
+
+Der Fortschrittsprüfer sieht nur deine Zielbeschreibung und die neueste Antwort des Agenten — nicht den Chatverlauf. Formuliere die Zielnachricht also so, dass auch jemand ohne Gesprächskontext versteht, wie der fertige Zustand aussieht.
+
+- Gut: "Füge Tests für das Exportmodul hinzu und sorge dafür, dass die gesamte Test-Suite besteht."
+- Nicht so gut: "Beheb das" oder "Mach mit der Idee weiter."
+
+Für kleine nachgelagerte Rückfragen mit Kontext brauchst du kein Ziel — sende einfach eine normale Nachricht.
+
+## So funktioniert es
+
+Nachdem der Agent anhält und die Sitzung für einen Moment ruhig bleibt, macht OpenChamber Folgendes:
+
+1. Es bittet ein kleines, günstiges Modell, den letzten Zug gegen das Ziel zu prüfen: weitermachen, fertig oder festgefahren?
+2. Wenn das Urteil "weitermachen" lautet, sendet es eine Fortsetzungsaufforderung und der Agent nimmt die Arbeit wieder auf.
+3. Wenn das Ziel nachweislich erreicht ist, ist es abgeschlossen und du bekommst eine Benachrichtigung.
+4. Wenn der Agent wirklich feststeckt (deine Eingabe braucht), wird das Ziel erst dann als blockiert gestoppt — aber nur nachdem der Prüfer das dreimal in Folge gesagt hat, damit ein einzelner Ausrutscher das Ziel nie beendet.
+
+Es gibt auch harte Sicherheitsstopps: ein optionales Token-Budget, eine Obergrenze für automatische Fortsetzungen und ein Stopp bei Fehlern in einem Zug. Wenn der Kontext der Sitzung mitten in der Arbeit komprimiert wird, geht das Ziel einfach weiter — in das Kontextfenster zu laufen ist ein Beweis dafür, dass die Arbeit noch nicht fertig war.
+
+### Stoppen und fortsetzen
+
+- Die **Stopp-Schaltfläche** bricht den laufenden Zug ab und pausiert das Ziel — dein ausdrückliches "stop" gewinnt immer gegen die Schleife.
+- **Pause** in der Zielleiste macht aus der anderen Richtung dasselbe: Es pausiert das Ziel und stoppt den laufenden Zug.
+- Während der Pause kannst du normal chatten — die Schleife bleibt dir aus dem Weg.
+- **Resume** aktiviert die Schleife neu: Bei einer ruhenden Sitzung geht der Fortsetzungsanstupser sofort raus; wenn der Agent gerade arbeitet, hängt sich die Schleife beim nächsten Halt stillschweigend wieder an.
+
+## Beobachten und verwalten
+
+- Die Leiste über dem Composer zeigt die neueste Fortschrittsnotiz, den Status und die Token-Nutzung des Ziels sowie eine Inline-Schaltfläche zum Pausieren/Fortsetzen. Wenn der Agent angehalten hat und das Ziel aktiv ist, zeigt die Leiste ein drehendes **Evaluating…** — das ist das ruhige Zeitfenster und der laufende Audit.
+- Die Zielschaltfläche bleibt während der Laufzeit blau beleuchtet, wird bei Abschluss grün und bei Blockierung oder erreichtem Budget rot. Drücke sie, um den Zieldialog zu öffnen: Bearbeite das Ziel oder das Budget oder entferne das Ziel. Ein abgeschlossenes Ziel ist schreibgeschützt — entferne es und aktiviere dann ein neues.
+- In der Sitzungs-Seitenleiste erscheint neben dem Sitzungsdatum ein kleines Zielsymbol, dessen Farbe den Zustand des Ziels widerspiegelt.
+
+## Benachrichtigungen
+
+Während ein Ziel aktiv ist, werden die "Agent ist bereit"-Benachrichtigungen pro Zug unterdrückt — sie würden nur die eigenen Fortsetzungen der Zielschleife wiederholen. Wenn das Ziel zur Ruhe kommt (abgeschlossen, blockiert oder Budget erreicht), bekommst du stattdessen eine letzte Benachrichtigung, auf dem Desktop und als mobile Push-Nachricht. Sie folgt derselben Einstellung "bei Abschluss benachrichtigen"; Berechtigungsanfragen, Fragen und Fehlermeldungen funktionieren währenddessen wie gewohnt weiter.
+
+## Token-Budget
+
+In **Einstellungen → Chat → Goal** kannst du ein Standard-Token-Budget für neue Ziele festlegen. Wenn ein Ziel sein Budget erreicht, stoppt es als "budget reached" statt weiter zu verbrauchen — du kannst das Budget erhöhen und im Zieldialog fortsetzen.
+
+## Beachten
+
+- Die Zielschleife läuft im OpenChamber-Server, nicht in deinem Browser-Tab. Schließe den Tab, sperre das Telefon — der Agent arbeitet weiter, und du bekommst eine Benachrichtigung, wenn das Ziel zur Ruhe kommt. Der Server (Desktop-App oder `openchamber`-Prozess) muss weiterlaufen.
+- Ziele verwenden den eigenen Provider und das Modell deiner Sitzung, einschließlich der Prüferaufrufe — nichts verlässt die Provider, die du bereits nutzt.
+- Pro Sitzung immer nur ein Ziel gleichzeitig.
+
+## Verwandt
+
+- [Geplante Aufgaben](/scheduled-tasks/) — eine Aufforderung nach Zeitplan ausführen; dort "Run as goal" aktivieren, damit ein geplanter Lauf seine Aufforderung bis zum Abschluss verfolgt
+- [Benachrichtigungen](/notifications/) — wie du von einem fertigen Ziel erfährst
diff --git a/packages/docs/content/docs/de/skills-catalog.mdx b/packages/docs/content/docs/de/skills-catalog.mdx
new file mode 100644
index 00000000..1b1c35a7
--- /dev/null
+++ b/packages/docs/content/docs/de/skills-catalog.mdx
@@ -0,0 +1,27 @@
+---
+title: Skills-Katalog
+description: Fertige Skills durchsuchen und installieren.
+---
+
+# Skills-Katalog
+
+Im Skills-Katalog kannst du Skills installieren, die andere veröffentlicht haben, statt selbst welche zu schreiben. Du öffnest ihn unter **Einstellungen → Skills → Katalog**.
+
+Zum Schreiben eigener Skills siehe [Skills](/skills/).
+
+## Einen Skill installieren
+
+1. Öffne den Katalog.
+2. Durchsuche die eingebauten Quellen — das Anthropic-Skills-Repo und die ClawdHub-Community-Registry — oder nutze die Suche.
+3. Wähle einen Skill aus und installiere ihn.
+4. Entscheide, wo er installiert werden soll: für alles, was du tust, oder nur für das aktuelle Projekt.
+
+Wenn bereits ein Skill mit demselben Namen existiert, fragt OpenChamber, was geschehen soll — überspringen, überschreiben oder für jeden Skill einzeln entscheiden.
+
+## Eigene Quelle hinzufügen
+
+Du kannst jedes Git-Repository als Quelle hinzufügen — entweder mit seinem `owner/repo`-Namen oder mit einer vollständigen Git-URL. Private Repositories brauchen Zugriff auf deinem Rechner (einen SSH-Schlüssel oder gespeicherte Anmeldedaten); wenn sich eine Quelle nicht authentifizieren kann, weist der Katalog darauf hin, statt still zu scheitern.
+
+## Weiterführend
+
+- [Skills](/skills/) — installierte Skills erstellen und verwalten
diff --git a/packages/docs/content/docs/de/skills.mdx b/packages/docs/content/docs/de/skills.mdx
new file mode 100644
index 00000000..f0aabce4
--- /dev/null
+++ b/packages/docs/content/docs/de/skills.mdx
@@ -0,0 +1,30 @@
+---
+title: Skills
+description: Erstelle wiederverwendbare Anweisungen, die Agents bei Bedarf laden.
+---
+
+# Skills
+
+Ein Skill ist ein wiederverwendbarer Satz von Anweisungen, den ein Agent bei Bedarf laden kann — zum Beispiel „wie wir Commit-Nachrichten schreiben“ oder „unsere API-Konventionen“. Du verwaltest sie unter **Einstellungen → Skills**.
+
+Wenn du fertige Skills installieren statt eigene schreiben möchtest, siehe [Skills-Katalog](/skills-catalog/).
+
+## Einen Skill erstellen
+
+1. Öffne **Einstellungen → Skills**.
+2. Erstelle einen Skill und gib ihm einen Namen und eine kurze Beschreibung. Die Beschreibung ist die Grundlage dafür, wann der Agent den Skill anwendet. Sei daher konkret.
+3. Schreibe die Anweisungen. Füge unterstützende Dateien hinzu, falls der Skill sie braucht.
+4. Wähle den Speicherort:
+ - **persönlich** — in jedem Projekt verfügbar
+ - **projektbezogen** — nur im aktuellen Projekt verfügbar
+
+## Einen Skill im Chat verwenden
+
+Gib mitten in einer Nachricht `/` ein, um die Skill-Auswahl zu öffnen, und wähle dann einen Skill aus. Der Agent lädt für die Antwort die Anweisungen dieses Skills.
+
+Ein `/` ganz am Anfang der Nachricht öffnet stattdessen [Befehle](/commands-snippets/).
+
+## Weiterführend
+
+- [Skills-Katalog](/skills-catalog/) — installiere Skills, die andere veröffentlicht haben
+- [Befehle & Snippets](/commands-snippets/) — weitere Möglichkeiten, Text im Chat wiederzuverwenden
diff --git a/packages/docs/content/docs/de/ssh-hosts-proxying.mdx b/packages/docs/content/docs/de/ssh-hosts-proxying.mdx
new file mode 100644
index 00000000..4ce4021a
--- /dev/null
+++ b/packages/docs/content/docs/de/ssh-hosts-proxying.mdx
@@ -0,0 +1,48 @@
+---
+title: SSH-Hosts & Proxying
+description: Importiere gespeicherte SSH-Hosts und füge in der Desktop-App zusätzliche SSH-Portweiterleitungen hinzu.
+---
+
+# SSH-Hosts & Proxying
+
+Verwende in der Desktop-App **Settings → Remote Instances**, um gespeicherte SSH-Hosts zu importieren, dich mit einem entfernten Rechner zu verbinden und über dieselbe SSH-Verbindung zusätzliche Ports bereitzustellen.
+
+> SSH-Hosts und SSH-Proxying sind Funktionen **nur für den Desktop**. Sie verwenden den SSH-Client auf deinem Rechner.
+
+## SSH-Host importieren
+
+OpenChamber kann Hosts aus deiner lokalen SSH-Konfiguration lesen, also aus demselben Ort, den auch Befehle wie `ssh work-server` verwenden.
+
+1. Öffne **Settings → Remote Instances**.
+2. Wähle einen Host unter **Saved SSH hosts**.
+3. Wenn es sich um ein Muster handelt, gib das tatsächliche Ziel ein, zum Beispiel `deploy@app.example.com`.
+4. Speichern und verbinden.
+
+OpenChamber erstellt mit diesem SSH-Befehl eine Remote-Instanz. Wenn sie **ready** erreicht, öffnet sich die entfernte OpenChamber-UI in der Desktop-App.
+
+## Zusätzliche Portweiterleitungen hinzufügen
+
+Jede Remote-Instanz hat den Bereich **Port Forwards**. Verwende ihn, wenn etwas auf einer Seite der SSH-Verbindung einen Port auf der anderen Seite erreichen muss.
+
+OpenChamber unterstützt drei Weiterleitungstypen:
+
+- **Local (-L)** — öffne einen Port auf deinem Rechner, der mit etwas auf dem entfernten Rechner verbunden ist.
+- **Remote (-R)** — öffne einen Port auf dem entfernten Rechner, der zurück zu deinem Rechner verbindet.
+- **Dynamic (-D)** — öffne einen lokalen SOCKS-Proxy über die SSH-Verbindung.
+
+Für die meisten App-Vorschauen und Dashboards, die auf dem entfernten Rechner laufen, verwende **Local (-L)**.
+
+## Den SOCKS-Proxy verwenden
+
+Wähle **Dynamic (-D)**, wenn andere Tools auf deinem Rechner über den entfernten Rechner browsen sollen. OpenChamber öffnet dafür einen lokalen SOCKS-Proxy-Port für diese SSH-Verbindung.
+
+Sobald die Verbindung bereit ist, kopiere oder verwende die lokale Proxy-Adresse aus der Weiterleitungszeile. Konfiguriere deinen Browser oder dein Tool so, dass es sie als SOCKS5-Proxy verwendet.
+
+## Privat halten
+
+Verwende `127.0.0.1` oder `localhost` für den lokalen Bind-Host, es sei denn, du möchtest ausdrücklich, dass andere Geräte in deinem Netzwerk den weitergeleiteten Port erreichen.
+
+## Verwandt
+
+- [Remote Instances](/remote-instances/) — die Desktop-App mit OpenChamber auf einem anderen Rechner verbinden
+- [Remote access](/troubleshooting/remote-access/) — wenn SSH oder Remote-Zugriff keine Verbindung herstellen
diff --git a/packages/docs/content/docs/de/themes.mdx b/packages/docs/content/docs/de/themes.mdx
new file mode 100644
index 00000000..2d4a3c4c
--- /dev/null
+++ b/packages/docs/content/docs/de/themes.mdx
@@ -0,0 +1,30 @@
+---
+title: Themes
+description: Passe OpenChamber mit eingebauten und benutzerdefinierten Themes an.
+---
+
+# Themes
+
+OpenChamber unterstützt eingebaute Themes und benutzerdefinierte Theme-JSON-Dateien.
+
+## Ein benutzerdefiniertes Theme hinzufügen
+
+1. Erstelle das Themes-Verzeichnis:
+
+```bash
+mkdir -p ~/.config/openchamber/themes
+```
+
+2. Füge deine JSON-Datei in dieses Verzeichnis ein (zum Beispiel `my-theme.json`).
+3. Öffne OpenChamber und gehe dann zu **Einstellungen -> Theme -> Themes neu laden**.
+4. Wähle dein Theme im Dropdown aus. Es wird sofort angewendet.
+
+## Speicherort der Themes
+
+- macOS/Linux: `~/.config/openchamber/themes/`
+
+## Vollständige Referenz des JSON-Formats
+
+Verwende die vollständige Formatbeschreibung in den Haupt-Repository-Dokumenten:
+
+- [`docs/CUSTOM_THEMES.md`](https://github.com/openchamber/openchamber/blob/main/docs/CUSTOM_THEMES.md)
diff --git a/packages/docs/content/docs/de/troubleshooting.mdx b/packages/docs/content/docs/de/troubleshooting.mdx
new file mode 100644
index 00000000..4e83f2d5
--- /dev/null
+++ b/packages/docs/content/docs/de/troubleshooting.mdx
@@ -0,0 +1,40 @@
+---
+title: Fehlerbehebung
+description: Häufige Einrichtungs- und Laufzeitprobleme mit schnellen Lösungen.
+---
+
+# Fehlerbehebung
+
+Hakt es irgendwo? Suchen Sie unten das Symptom und probieren Sie die Lösung.
+
+## OpenChamber-Befehl beendet sich oder startet nicht
+
+- bestätigen Sie Node.js `>=22`
+- führen Sie `openchamber --version` aus
+- installieren Sie die neueste CLI bei Bedarf neu
+
+## Web-UI ist nicht erreichbar
+
+- prüfen Sie die Server-Logs mit `openchamber logs`
+- verifizieren Sie den aktiven Port (standardmäßig `3000`)
+- öffnen Sie `http://localhost:3000` zuerst direkt, bevor Sie Tunnel-Links testen
+
+## Remote-/Tunnel-Link funktioniert nicht
+
+- führen Sie `openchamber tunnel status --all` aus
+- starten Sie den Tunnel von derselben Instanz / demselben Port neu
+- erzeugen Sie den Connect-Link neu, wenn das vorherige Token bereits verwendet wurde
+
+Die vollständige Einrichtung steht unter [Tunnel](/tunnels/) und [Reverse Proxy](/reverse-proxy/), falls Sie einen nutzen.
+
+## VS-Code-Erweiterung verbindet sich nicht
+
+- bestätigen Sie, dass der OpenChamber-Server läuft
+- prüfen Sie, ob die Erweiterung aktualisiert ist
+- laden Sie das VS-Code-Fenster neu und versuchen Sie die Verbindung erneut
+
+## Verwandt
+
+- [Schnellstart](/quickstart/)
+- [Tunnel](/tunnels/)
+- [Reverse Proxy](/reverse-proxy/)
diff --git a/packages/docs/content/docs/de/troubleshooting/opencode-connection.mdx b/packages/docs/content/docs/de/troubleshooting/opencode-connection.mdx
new file mode 100644
index 00000000..dd14cdc6
--- /dev/null
+++ b/packages/docs/content/docs/de/troubleshooting/opencode-connection.mdx
@@ -0,0 +1,34 @@
+---
+title: OpenCode-Verbindung
+description: Beheben Sie, dass OpenChamber keine Verbindung zu seinem OpenCode-Server herstellt.
+---
+
+# OpenCode-Verbindung
+
+Wenn OpenChamber lädt, aber nie über „OpenCode is restarting“ hinauskommt, oder der Chat nicht antwortet, ist der Server, mit dem es spricht, nicht erreichbar. Gehen Sie diese Punkte durch.
+
+## Es hängt bei „OpenCode is restarting“
+
+- geben Sie ihm direkt nach dem Start einen Moment — dieser Zustand ist normal, während der Server hochfährt
+- prüfen Sie mit `openchamber status`, ob der Server noch läuft
+- starten Sie ihn mit `openchamber restart` neu
+- sehen Sie sich mit `openchamber logs` die Startdetails an
+
+## Sie verbinden sich mit Ihrem eigenen Server
+
+Wenn Sie OpenChamber so konfiguriert haben, dass es einen vorhandenen Server nutzt, prüfen Sie die Einrichtung aus [OpenCode Server](/opencode-server/) noch einmal:
+
+- `OPENCODE_HOST` muss den Port enthalten, aber keinen Pfad — zum Beispiel `http://localhost:4096`
+- setzen Sie `OPENCODE_SKIP_START=true`, damit OpenChamber nicht auch noch seinen eigenen Server startet
+- wenn die Adresse ungültig ist, ignoriert OpenChamber sie und startet stattdessen seinen eigenen Server — achten Sie in den Logs auf eine `[config]`-Warnung
+
+## Es schlägt immer noch fehl
+
+- bestätigen Sie, dass Node.js Version `20` oder neuer ist
+- installieren Sie die neueste CLI neu
+- öffnen Sie `http://localhost:3000` direkt, bevor Sie einen Tunnel- oder Remote-Link testen
+
+## Verwandt
+
+- [OpenCode Server](/opencode-server/) — wie OpenChamber den Server findet und verwaltet
+- [Fehlerbehebung](/troubleshooting/) — weitere häufige Probleme
diff --git a/packages/docs/content/docs/de/troubleshooting/remote-access.mdx b/packages/docs/content/docs/de/troubleshooting/remote-access.mdx
new file mode 100644
index 00000000..377c6eaa
--- /dev/null
+++ b/packages/docs/content/docs/de/troubleshooting/remote-access.mdx
@@ -0,0 +1,47 @@
+---
+title: Remote-Zugriff
+description: Beheben Sie Tunnel, Remote-Instanzen und den Zugriff auf OpenChamber von einem anderen Gerät aus.
+---
+
+# Remote-Zugriff
+
+Wenn Sie OpenChamber von Ihrem Telefon oder einem anderen Rechner aus nicht erreichen, hängt die Lösung davon ab, wie Sie sich verbinden.
+
+## Prüfen Sie zuerst die Grundlagen
+
+- öffnen Sie zuerst `http://localhost:3000` auf demselben Computer — wenn das fehlschlägt, ist es kein Remote-Problem; sehen Sie unter [OpenCode-Verbindung](/troubleshooting/opencode-connection/) nach
+- bestätigen Sie mit `openchamber status`, dass der Server läuft
+
+## Gekoppeltes Gerät verbindet sich nicht
+
+- der QR-Code / Pairing-Link ist **nur einmal nutzbar** — wenn er bereits gescannt wurde (oder abgelaufen ist), erstellen Sie über **Gerät hinzufügen** einen neuen
+- wenn das Gerät mit **Nur Heimnetzwerk** gekoppelt wurde, kann es sich von außerhalb dieses Netzwerks nicht verbinden — koppeln Sie es erneut mit **Überall**
+- prüfen Sie bei **Überall**-Pairing auf dem Server **Einstellungen → Remote-Instanzen → OpenChamber Relay**: Dort sollte **Verbunden** stehen; wenn nicht, deaktivieren und reaktivieren Sie es
+- wenn ein Gerät **widerrufen** wurde, ist sein Token endgültig weg — koppeln Sie es mit einem neuen QR-Code erneut
+
+Wie diese Verbindungen funktionieren, steht unter [Ein Gerät verbinden](/connect-devices/) und [Private Relay](/private-relay/).
+
+## Tunnel-Link funktioniert nicht
+
+- führen Sie `openchamber tunnel status --all` aus
+- starten Sie den Tunnel von derselben Instanz und demselben Port neu
+- erzeugen Sie den Connect-Link neu, wenn der vorherige bereits verwendet wurde
+
+Die vollständige Einrichtung steht unter [Tunnel](/tunnels/).
+
+## Remote-Instanz verbindet sich nicht (Desktop)
+
+Wenn eine [Remote-Instanz](/remote-instances/) hängen bleibt, nennt OpenChamber den fehlgeschlagenen Schritt:
+
+- **auth** — Ihr SSH- oder UI-Passwort wurde abgelehnt; geben Sie es erneut ein
+- **install / start** — OpenChamber konnte den Server auf dem entfernten Rechner nicht einrichten oder starten; prüfen Sie die Anforderungen dieses Rechners
+- **forwarding** — die Verbindung steht, aber der Port erreicht Sie nicht; versuchen Sie einen anderen lokalen Port
+
+## Hinter Ihrem eigenen Server
+
+Wenn Sie OpenChamber hinter einen Reverse Proxy setzen und es seltsam lädt oder keine Verbindung herstellt, sehen Sie sich [Reverse Proxy](/reverse-proxy/) an.
+
+## Verwandt
+
+- [Ein Gerät verbinden](/connect-devices/) · [Private Relay](/private-relay/) · [Tunnel](/tunnels/) · [Remote-Instanzen](/remote-instances/) · [Reverse Proxy](/reverse-proxy/)
+- [Sicherheit](/security/) — schützen Sie die UI, bevor Sie sie freigeben
diff --git a/packages/docs/content/docs/de/troubleshooting/worktrees-git.mdx b/packages/docs/content/docs/de/troubleshooting/worktrees-git.mdx
new file mode 100644
index 00000000..4f36d1ac
--- /dev/null
+++ b/packages/docs/content/docs/de/troubleshooting/worktrees-git.mdx
@@ -0,0 +1,35 @@
+---
+title: Worktrees & Git
+description: Häufige Probleme mit Worktrees und Git beheben.
+---
+
+# Worktrees & Git
+
+Probleme, die bei [Worktree-Sitzungen](/worktrees/) und der [Git-Ansicht](/git/) auftreten, und wie Sie sie beheben.
+
+## Ein Worktree braucht Aufmerksamkeit
+
+OpenChamber markiert einen Worktree, wenn etwas nicht stimmt:
+
+- **Ordner fehlt** — der Ordner des Worktrees wurde gelöscht oder außerhalb von OpenChamber verschoben; entfernen Sie die Sitzung und erstellen Sie einen frischen Worktree
+- **abgetrennter oder noch nicht angelegter Branch** — der Worktree liegt nicht auf einem normalen Branch; checken Sie ihn auf einen aus
+- **Merge, Rebase oder Cherry-Pick läuft noch** — eine Operation wurde halb fertig gelassen; beenden oder abbrechen Sie sie in der Git-Ansicht
+
+## Worktree lässt sich nicht erstellen
+
+- **Branch existiert bereits** — wählen Sie einen anderen Branchnamen oder verwenden Sie die Option für einen bestehenden Branch
+- **Name bereits vergeben** — wählen Sie einen anderen Worktree-Namen
+
+## Commit- oder PR-Erstellung schlägt fehl
+
+Das Erzeugen einer Commit-Nachricht oder einer PR-Beschreibung läuft in Ihrer aktiven Sitzung, daher brauchen Sie eine geöffnete Sitzung mit ausgewähltem Arbeitsmodell. Öffnen oder wählen Sie eine Sitzung und versuchen Sie es erneut.
+
+## SSH- oder Windows-Pfadprobleme
+
+- stellen Sie sicher, dass der SSH-Schlüssel, den das Repo verwendet, derselbe ist, den Sie in Ihrer [Git-Identität](/git-identities/) gesetzt haben
+- unter Windows verwendet Git Unix-ähnliche Pfade (wie `/c/Users/...`) — OpenChamber handhabt das, aber benutzerdefinierte SSH-Schlüsselpfade sollten dieselbe Form haben
+
+## Verwandt
+
+- [Worktree-Sitzungen](/worktrees/) — wie Worktrees erstellt und entfernt werden
+- [Git-Identitäten](/git-identities/) — für jedes Repo den richtigen Schlüssel und die richtige Identität setzen
diff --git a/packages/docs/content/docs/de/tunnels.mdx b/packages/docs/content/docs/de/tunnels.mdx
new file mode 100644
index 00000000..69475a93
--- /dev/null
+++ b/packages/docs/content/docs/de/tunnels.mdx
@@ -0,0 +1,120 @@
+---
+title: Tunnel
+description: Stelle OpenChamber sicher für Remote- und Mobilzugriff bereit.
+---
+
+# Tunnel
+
+Ein Tunnel ist ein öffentlicher Link zu deinem OpenChamber, damit du ihn von einem normalen Browser in einem anderen Netzwerk aus erreichen kannst. Nutze `openchamber tunnel`, um einen für eine laufende Instanz zu erstellen.
+
+> Wenn du **deine eigenen Geräte** verbindest (die Mobile App, einen anderen Desktop), brauchst du normalerweise keinen Tunnel — [kopple sie](/connect-devices/) stattdessen und lass das Ende-zu-Ende-verschlüsselte [Private Relay](/private-relay/) den Zugriff von unterwegs ohne zusätzliche Einrichtung übernehmen.
+
+## Voraussetzungen
+
+OpenChamber startet das CLI des Tunnel-Anbieters auf deinem Rechner. Installiere zuerst den Anbieter, den du verwenden möchtest:
+
+```bash
+brew install cloudflared
+brew install ngrok
+```
+
+Cloudflare Quick Tunnels können mit `cloudflared` laufen. Ngrok benötigt ein ngrok-Konto und ein Authtoken aus dem ngrok-Dashboard:
+
+```bash
+ngrok config add-authtoken
+```
+
+## Schnellstart
+
+1. Starte OpenChamber:
+
+```bash
+openchamber
+```
+
+Wenn du diesen Schritt überspringst, kann `openchamber tunnel start` automatisch einen CLI-Server starten. Beim automatischen Start kannst du Serveroptionen wie `--port`, `--host`, `--lan`, `--ui-password` und `--api-only` mitgeben.
+
+2. Starte einen Cloudflare-Tunnel:
+
+```bash
+openchamber tunnel start --provider cloudflare --mode quick
+```
+
+Oder starte einen Ngrok-Tunnel:
+
+```bash
+openchamber tunnel start --provider ngrok --mode quick
+```
+
+3. Status prüfen:
+
+```bash
+openchamber tunnel status
+```
+
+Sobald der Tunnel aktiv ist, zeigt `status` eine öffentliche URL. Öffne sie oder scanne den QR-Code, um OpenChamber von überall aus zu erreichen.
+
+Standardmäßig druckt OpenChamber in interaktiven TTY-Sitzungen einen QR-Code. Mit `--qr` erzwingst du die QR-Ausgabe, mit `--no-qr` deaktivierst du sie.
+
+## Anbieter
+
+- `cloudflare`: Quick-, Managed-Remote- und Managed-Local-Modi
+- `ngrok`: Quick-Modus
+
+## Verwaltete Modi
+
+### Managed Remote
+
+Verwende ein von Cloudflare verwaltetes Token und einen Hostnamen:
+
+```bash
+openchamber tunnel start --provider cloudflare --mode managed-remote --token-file ~/.secrets/cf-token --hostname app.example.com
+```
+
+### Managed Local
+
+Verwende eine lokale `cloudflared`-Konfiguration:
+
+```bash
+openchamber tunnel start --provider cloudflare --mode managed-local --config ~/.cloudflared/config.yml
+```
+
+## Profile (managed-remote)
+
+Ein wiederverwendbares Profil speichern:
+
+```bash
+openchamber tunnel profile add --provider cloudflare --mode managed-remote --name prod-main --hostname app.example.com --token-file ~/.secrets/cf-token
+```
+
+Mit dem gespeicherten Profil starten:
+
+```bash
+openchamber tunnel start --profile prod-main
+```
+
+## Nützliche Befehle
+
+```bash
+openchamber tunnel providers
+openchamber tunnel ready --provider cloudflare
+openchamber tunnel ready --provider ngrok
+openchamber tunnel doctor --provider cloudflare
+openchamber tunnel doctor --provider ngrok
+openchamber tunnel stop --port 3000
+```
+
+## Hinweise zum Verhalten
+
+- ein aktiver Tunnel pro OpenChamber-Instanz (Port)
+- wenn auf derselben Instanz ein neuer Modus oder Anbieter startet, ersetzt er den vorherigen Tunnel
+- das Erstellen eines neuen Verbindungslinks widerruft den vorherigen unbenutzten Link
+- das automatische Starten des Tunnels bewahrt Server-Flags wie `--ui-password` und `--api-only` in den Instanzeinstellungen auf, die von Neustart-/Update-Flows verwendet werden
+
+## Verwandt
+
+- [Connect a Device](/connect-devices/) — eigene Geräte ohne öffentliche URL koppeln
+- [Security](/security/) — die UI schützen, bevor du sie freigibst
+- [Desktop Tunnels](/desktop-tunnels/) — Tunnel-Einrichtung in der Desktop-App ohne CLI-Start
+- [PWA & Mobile](/mobile/) — OpenChamber vom Telefon aus erreichen
+- [Troubleshooting](/troubleshooting/) — wenn der Tunnel-Link nicht funktioniert
diff --git a/packages/docs/content/docs/de/updates.mdx b/packages/docs/content/docs/de/updates.mdx
new file mode 100644
index 00000000..725de9e1
--- /dev/null
+++ b/packages/docs/content/docs/de/updates.mdx
@@ -0,0 +1,31 @@
+---
+title: Updates
+description: Halten Sie OpenChamber auf Desktop, Web und VS Code auf dem neuesten Stand.
+---
+
+# Updates
+
+Wie Sie OpenChamber aktualisieren, hängt davon ab, wie Sie es installiert haben. In jedem Fall können Sie Ihre aktuelle Version unter **Einstellungen → OpenChamber → Über** prüfen.
+
+## Desktop-App
+
+Die Desktop-App prüft GitHub-Releases auf Updates. Wenn eines verfügbar ist, informiert OpenChamber Sie, lädt es auf Wunsch herunter und installiert es beim nächsten Neustart. Sie behalten immer die Kontrolle — nichts wird ohne Ihr Zutun installiert.
+
+## Web / CLI
+
+Wenn Sie die CLI installiert haben, aktualisieren Sie sie im Bereich **Über** mit den Schaltflächen zum Prüfen und Aktualisieren oder im Terminal:
+
+```bash
+openchamber update
+```
+
+OpenChamber erkennt, wie es installiert wurde (npm, pnpm, yarn oder bun), und führt das passende Update für Sie aus.
+
+## Der OpenCode-Server
+
+OpenChamber und OpenCode werden getrennt aktualisiert. Wenn eine neue OpenCode-Version verfügbar ist, bietet OpenChamber an, sie zu aktualisieren, und startet den Server danach neu. Wie dieser Server verwaltet wird, steht unter [OpenCode Server](/opencode-server/).
+
+## Verwandt
+
+- [Installieren](/install/) — wie die jeweilige App überhaupt installiert wird
+- [OpenCode Server](/opencode-server/) — den zugrunde liegenden Server aktualisieren
diff --git a/packages/docs/content/docs/de/usage.mdx b/packages/docs/content/docs/de/usage.mdx
new file mode 100644
index 00000000..d0129fbf
--- /dev/null
+++ b/packages/docs/content/docs/de/usage.mdx
@@ -0,0 +1,28 @@
+---
+title: Nutzung & Kontingente
+description: Verfolge, wie viel deines Provider-Tarifs du bereits genutzt hast.
+---
+
+# Nutzung & Kontingente
+
+Die Seite Nutzung zeigt, wie viel du von den Tarifen der einzelnen Provider bereits verbraucht hast, damit du sehen kannst, wie nah du an einem Limit bist. Du öffnest sie unter **Einstellungen → Nutzung**.
+
+## Was du siehst
+
+Für jeden verbundenen Provider zeigt OpenChamber:
+
+- wie viel des aktuellen Zeitfensters du bereits genutzt hast, als Balken
+- eine Aufschlüsselung nach Modell
+- einen Tempoindikator, damit du siehst, ob du rechtzeitig am Limit ankommen wirst
+
+Du kannst auswählen, welche Provider angezeigt werden, und dieselbe Zusammenfassung ist auch über ein Dropdown in der App-Kopfzeile verfügbar.
+
+## Unterstützte Provider
+
+Die Nutzung funktioniert für die Provider, die ein Kontingent veröffentlichen, darunter Claude, Codex, GitHub Copilot, Google, OpenRouter, Kimi, NanoGPT, z.ai, Zhipu, MiniMax, Ollama Cloud und Wafer.
+
+Ein Anbieter zeigt Nutzung erst dann an, wenn du dich auf der [Seite „Anbieter“](/providers/) dort angemeldet hast. Einige Anbieter brauchen noch einen zusätzlichen Schritt — Ollama Cloud liest zum Beispiel eine Sitzungsdatei, die du separat einrichtest. Wenn ein Anbieter keine Daten anzeigt, fehlt meist diese zusätzliche Anmeldeinformation.
+
+## Weiterführend
+
+- [Provider, Modelle & Agents](/providers/) — zuerst anmelden, damit Nutzung angezeigt wird
diff --git a/packages/docs/content/docs/de/voice.mdx b/packages/docs/content/docs/de/voice.mdx
new file mode 100644
index 00000000..02f174bd
--- /dev/null
+++ b/packages/docs/content/docs/de/voice.mdx
@@ -0,0 +1,36 @@
+---
+title: Sprachmodus
+description: Sprich mit OpenChamber und lass dir Antworten vorlesen.
+---
+
+# Sprachmodus
+
+Mit dem Sprachmodus kannst du Nachrichten diktieren und dir Antworten vorlesen lassen. Schalte ihn unter **Einstellungen → OpenChamber → Sprache** ein.
+
+## Antworten vorlesen lassen (Text-zu-Sprache)
+
+Wähle aus, wie Antworten gesprochen werden:
+
+- **Browser** — die integrierten Stimmen deines Browsers, keine Einrichtung nötig
+- **OpenAI** — die Stimmen von OpenAI; füge deinen API-Schlüssel ein und wähle eine Stimme
+- **OpenAI-kompatibel** — jeder Dienst, der das OpenAI-Format unterstützt; gib seine URL und, falls nötig, einen API-Schlüssel an
+- **macOS say** — der eingebaute `say`-Befehl, auf Macs mit dieser Funktion
+
+Sobald es aktiviert ist, erscheint bei Nachrichten eine Abspieltaste, mit der du sie vorlesen lassen kannst.
+
+## Nachrichten diktieren (Sprache-zu-Text)
+
+Wähle aus, wie deine Sprache transkribiert wird:
+
+- **Browser** — die integrierte Spracherkennung deines Browsers, keine Einrichtung nötig
+- **Server** — ein OpenAI-kompatibler Transkriptionsdienst; gib seine URL und, falls nötig, einen API-Schlüssel an
+- **Gerätebasiert** — ein Sprachmodell, das in deinem Browser läuft und beim ersten Verwenden heruntergeladen wird
+
+## Hinweis für Telefone
+
+Beim Vorlesen auf einem Telefon sind die Optionen OpenAI oder OpenAI-kompatibel am zuverlässigsten — mobile Browser begrenzen die integrierten Stimmen.
+
+## Weiterführend
+
+- [Benachrichtigungen](/notifications/) — lasse dich statt durch Zuhören per Ping informieren
+- [Provider, Modelle & Agents](/providers/) — dort liegt möglicherweise bereits dein OpenAI-Schlüssel
diff --git a/packages/docs/content/docs/de/walkthrough.mdx b/packages/docs/content/docs/de/walkthrough.mdx
new file mode 100644
index 00000000..04744a4f
--- /dev/null
+++ b/packages/docs/content/docs/de/walkthrough.mdx
@@ -0,0 +1,71 @@
+---
+title: Änderungen durchgehen
+description: Lesen Sie einen Diff in der Reihenfolge, in der er Sinn ergibt, nicht alphabetisch.
+---
+
+# Änderungen durchgehen
+
+Ein Diff ist nach Dateipfad sortiert, und das ist fast nie die Reihenfolge, in der die Änderung Sinn ergibt. Das Walkthrough ordnet ihn neu: Zusammengehörige Änderungen werden in **Stops** gruppiert, jeder Stop erklärt, was der Code jetzt anders macht, und die Stops sind so angeordnet, dass jeder auf dem vorherigen aufbaut.
+
+Es erklärt und ordnet. Es bewertet Ihren Code nicht und fällt kein Urteil — dafür ist [Review](/git/) da.
+
+Öffnen Sie es über das **Walkthrough**-Symbol in der rechten Leiste oder über die Schaltfläche **AI walkthrough** in den Bereichen Changes und Pull Request. Beides öffnet nur das Panel; generiert wird erst, wenn Sie **Generate walkthrough** drücken.
+
+## Was es prüfen kann
+
+| Bereich | Was enthalten ist |
+| --- | --- |
+| Alle uncommitteten | Alles, was noch nicht committet ist: gestagte, ungestagte und neue Dateien |
+| Gestaged | Nur das, was jetzt in einen Commit gehen würde |
+| Ungestaged | Arbeitsbaum und neue Dateien |
+| Dieser Branch | Jeder Commit auf diesem Branch, der nicht auf seinem Basis-Stand ist |
+| Pull Request | Die Änderung so, wie sie auf GitHub existiert |
+
+**Dieser Branch** bedeutet nicht „nicht gepushte Commits“ — es ist alles, was der Branch gegenüber seiner Basis hinzufügt, egal ob gepusht oder nicht. Nach einem Commit, aber vor dem Push, unterscheiden sich also Branch und Pull Request absichtlich: Der eine zeigt, was Sie getan haben, der andere, was Reviewer gerade sehen.
+
+Jeder Bereich wird separat gespeichert, sodass der Wechsel zwischen ihnen nichts verliert.
+
+## Das Modell wählen
+
+Walkthroughs nutzen standardmäßig Ihr kleines Modell. Wählen Sie unter **Einstellungen → Sitzungen → Modell für Änderungen durchgehen** ein anderes aus oder für eine einzelne Prüfung im Kopfbereich des Panels — nützlich, wenn eine Änderung riskant genug ist, ein stärkeres Modell zu brauchen.
+
+Die Auswahl zeigt nur Modelle an, die strukturierten Output zurückgeben können, weil sich das Walkthrough ohne ihn nicht zusammensetzen lässt. Wenn ein Modell für den Diff zu klein ist, wird die Generierung mit einer Erklärung abgelehnt, statt die Eingabe stillschweigend zu kürzen: Ein Walkthrough über einen halben Diff wirkt sicher und ist falsch.
+
+Wenn Sie ein Panel erneut öffnen, sehen Sie das Modell, das den aktuellen Inhalt erzeugt hat, sodass **Regenerate** mit demselben Modell wiederholt, sofern Sie es nicht ändern.
+
+## Die Sprache wählen
+
+Walkthroughs werden standardmäßig in Ihrer UI-Sprache geschrieben. Der Sprachwähler im Panelkopf startet dort, und Sie können für eine einzelne Prüfung jede andere Sprache wählen, in die OpenChamber übersetzt ist — eine geführte Erklärung ist nur in einer Sprache nützlich, die Sie bequem lesen.
+
+Übersetzt wird nur der Fließtext. Bezeichner, Dateipfade und API-Namen bleiben genau so, wie sie im Code erscheinen, damit das, was ein Stop nennt, weiterhin suchbar bleibt.
+
+Wenn in der von Ihnen gewählten Sprache noch nichts erzeugt wurde, zeigt das Panel weiterhin das vorhandene Walkthrough an und sagt das auch, statt leer zu werden. Drücken Sie **Generate walkthrough**, um eines in der neuen Sprache zu erhalten.
+
+## Kosten und Caching
+
+Nichts wird von selbst generiert. Die Generierung startet nur, wenn Sie sie anfordern, und auch das erneute Generieren ist manuell.
+
+Ergebnisse werden gegen den exakten Inhalt des Diffs gecacht. Wenn Sie den Arbeitsbaum auf einen früheren Stand zurücksetzen, erscheint das frühere Walkthrough kostenlos wieder, ohne Modellaufruf. Sprache und Modell sind ebenfalls Teil dieses Schlüssels, also wird jede Kombination separat gespeichert: Hat ein Diff einmal Walkthroughs in zwei Sprachen, ist das Umschalten zwischen ihnen sofort und kostenlos.
+
+Die Generierung läuft auf dem OpenChamber-Server, nicht in Ihrem Browser-Tab. Laden Sie die Seite neu oder schließen Sie das Panel, und sie läuft weiter; wenn Sie zurückkommen, wartet das Ergebnis. Nur **Cancel** beendet sie.
+
+## Ehrlich mit Aktualität umgehen
+
+Jeder Stop ist an den exakten Codeinhalt gebunden, den er beschreibt, damit das Panel Ihnen sagen kann, wenn sich dieser Code weiterentwickelt hat:
+
+- **Veraltete Schritte** — der Code, den ein Stop beschrieben hat, wurde geändert oder ist verschwunden. Das Walkthrough bleibt sichtbar und markiert, damit Sie entscheiden können, ob Sie es neu generieren.
+- **Nicht abgedeckt** — Änderungen im aktuellen Diff, die kein Stop beschreibt. Dazu gehören spätere Bearbeitungen nach der Generierung, Änderungen, die das Walkthrough als Routine eingestuft hat, sowie Lockfiles und andere generierte Dateien, die absichtlich aus der Modelleingabe herausgehalten werden. Sie werden alle am Ende des Streams aufgelistet, damit nichts stillschweigend verschwindet.
+
+Neu generieren bedeutet neu schreiben statt patchen: Das vorherige Walkthrough geht als Kontext an das Modell, damit richtige Teile erhalten bleiben, und alles wird neu an den aktuellen Code angeheftet.
+
+## Hinweise
+
+- Kommentieren Sie im Walkthrough jede Zeile genau wie in der Diff-Ansicht; Kommentare werden an den Chat-Composer angehängt.
+- Verfügbar auf Desktop- und Tablet-Breiten. In der VS-Code-Erweiterung oder der mobilen App nicht angeboten.
+- Eine Pull-Request-Review benötigt ein verbundenes GitHub-Konto — siehe [GitHub Issues & PRs](/github/).
+
+## Verwandt
+
+- [Git & GitHub](/git/) — das Changes-Panel, aus dem dies liest, und die Review-Aktion, die tatsächlich Code bewertet
+- [GitHub Issues & PRs](/github/) — GitHub verbinden, um Pull Requests zu prüfen
+- [Anbieter, Modelle & Agents](/providers/) — woher das kleine Modell kommt
diff --git a/packages/docs/content/docs/de/worktrees.mdx b/packages/docs/content/docs/de/worktrees.mdx
new file mode 100644
index 00000000..eabdda54
--- /dev/null
+++ b/packages/docs/content/docs/de/worktrees.mdx
@@ -0,0 +1,36 @@
+---
+title: Worktree-Sitzungen
+description: Gib einer Sitzung einen eigenen Branch und Ordner, damit die Arbeit isoliert bleibt.
+---
+
+# Worktree-Sitzungen
+
+Eine Worktree-Sitzung läuft in einer eigenen ausgecheckten Kopie deines Repos auf einem eigenen Branch (einem Git-Worktree). So kommen sich parallele Sitzungen nicht in die Quere — die eine kann refaktorieren, während eine andere einen Fehler behebt, ohne ständiges Hin- und Herwechseln.
+
+## Eine erstellen
+
+1. Öffne den Dialog für einen neuen Worktree über die Schaltfläche oben in der Sitzungs-Seitenleiste.
+2. Wähle einen Startpunkt:
+ - **new branch** — benenne den Branch und wähle, von welchem Branch aus gestartet werden soll
+ - **existing branch** — checke einen bereits vorhandenen Branch aus
+3. Bestätige den Worktree-Ordner (OpenChamber schlägt einen anhand des Branchnamens vor).
+4. Erstelle ihn.
+
+OpenChamber legt den Branch an, richtet den Ordner ein und startet dort eine Sitzung. Du kannst auch direkt von einer [todo](/notes-todos-plans/) oder einem [GitHub issue or PR](/github/) aus damit beginnen.
+
+## Die Arbeit zurückbringen
+
+Wenn die Arbeit gut ist, verwende **Integrate** in der Git-Ansicht, um die Commits des Worktrees auf einen anderen Branch (etwa `main`) zu übertragen. Wenn ein Konflikt auftritt, kannst du den Konflikt dem Agenten zur Lösung geben.
+
+## Aufräumen
+
+Das Löschen oder Archivieren der Sitzung kann den Worktree entfernen. Du entscheidest, ob auch der Branch gelöscht werden soll — lokal und, falls vorhanden, remote. Nichts wird gelöscht, ohne dass du es anforderst.
+
+## Wenn etwas seltsam aussieht
+
+Ein Worktree braucht möglicherweise Aufmerksamkeit, wenn sein Ordner fehlt, sein Branch in einem detached-Zustand ist oder ein Merge oder Rebase noch nicht abgeschlossen wurde. OpenChamber markiert das, damit du es beheben kannst — siehe [Worktrees & Git](/troubleshooting/worktrees-git/).
+
+## Verwandt
+
+- [Multi-run](/multi-run/) — viele Worktree-Sitzungen gleichzeitig starten
+- [Git- & GitHub-Workflows](/git/) — von innen in OpenChamber committen und integrieren
diff --git a/packages/docs/content/docs/es/walkthrough.mdx b/packages/docs/content/docs/es/walkthrough.mdx
new file mode 100644
index 00000000..a8df7498
--- /dev/null
+++ b/packages/docs/content/docs/es/walkthrough.mdx
@@ -0,0 +1,71 @@
+---
+title: Recorrido por los cambios
+description: Lee un diff en el orden que tiene sentido, no en orden alfabético.
+---
+
+# Recorrido por los cambios
+
+Un diff está ordenado por ruta de archivo, que casi nunca es el orden en el que el cambio cobra sentido. El recorrido lo reordena: las ediciones relacionadas se agrupan en **paradas**, cada parada explica qué hace ahora el código de forma distinta, y las paradas se ordenan para que cada una se apoye en la anterior.
+
+Explica y ordena. No juzga tu código ni emite veredictos — para eso está [Review](/git/).
+
+Ábrelo con el icono **Recorrido** en la barra derecha, o con el botón **Recorrido con IA** en los paneles de cambios y de pull request. Ambos solo abren el panel; no se genera nada hasta que pulsas **Generar recorrido**.
+
+## Qué puede recorrer
+
+| Ámbito | Qué incluye |
+| --- | --- |
+| Todo sin confirmar | Todo lo que aún no está en un commit: preparado, sin preparar y archivos nuevos |
+| Preparados | Solo lo que iría a un commit ahora mismo |
+| Sin preparar | Árbol de trabajo y archivos nuevos |
+| Esta rama | Todos los commits de la rama que no están en su base |
+| Pull request | El cambio tal como existe en GitHub |
+
+**Esta rama** no significa "commits sin subir": es todo lo que la rama añade a su base, se haya subido o no. Por eso, tras hacer commit pero antes de subirlo, esta y el pull request difieren a propósito: una muestra lo que hiciste, el otro lo que ven ahora quienes revisan.
+
+Cada ámbito se guarda por separado, así que cambiar entre ellos nunca pierde nada.
+
+## Elegir el modelo
+
+Los recorridos usan tu modelo pequeño por defecto. Elige otro en **Ajustes → Sesiones → Modelo del recorrido de cambios**, o solo para una revisión desde la cabecera del panel — útil cuando un cambio es lo bastante delicado como para merecer un modelo más potente.
+
+El selector solo ofrece modelos capaces de devolver salida estructurada, porque sin ella el recorrido no se puede montar. Si un modelo se queda corto para el diff, la generación se rechaza con una explicación en vez de recortar la entrada en silencio: un recorrido escrito sobre medio diff suena seguro y se equivoca.
+
+Al reabrir el panel verás el modelo que produjo lo que tienes delante, así que **Regenerar** repite con el mismo salvo que lo cambies.
+
+## Elegir el idioma
+
+Los recorridos se escriben en el idioma de tu interfaz por defecto. El selector de idioma de la cabecera del panel arranca ahí, y puedes elegir cualquier otro idioma al que esté traducido OpenChamber para una sola revisión: una explicación guiada solo sirve en un idioma que leas con soltura.
+
+Solo se traduce la prosa. Los identificadores, las rutas de archivo y los nombres de API se quedan tal cual aparecen en tu código, así que lo que nombra una parada sigue siendo lo que puedes buscar.
+
+Si todavía no hay nada generado en el idioma que elegiste, el panel no se vacía: sigue mostrando el recorrido que tiene y lo dice. Pulsa **Generar recorrido** para obtenerlo en el idioma nuevo.
+
+## Coste y caché
+
+Nada se genera por su cuenta. La generación solo empieza cuando la pides, y regenerar también es manual.
+
+Los resultados se guardan en caché según el contenido exacto del diff. Devuelve el árbol de trabajo a un estado anterior y el recorrido anterior vuelve gratis, sin llamar al modelo. El idioma y el modelo forman parte de esa clave, así que cada combinación se guarda por separado: cuando un diff ya tiene recorrido en dos idiomas, cambiar entre ellos es instantáneo y no cuesta nada.
+
+La generación se ejecuta en el servidor de OpenChamber, no en la pestaña del navegador. Recarga la página o cierra el panel y continúa; al volver, el resultado te espera. Solo **Cancelar** la detiene.
+
+## Ser honesto sobre lo desactualizado
+
+Cada parada está anclada al contenido exacto del código que describe, así que el panel puede avisarte cuando ese código ha cambiado:
+
+- **Pasos desactualizados** — el código que describía una parada cambió o desapareció. El recorrido se sigue mostrando, marcado, para que decidas si regenerar.
+- **Sin cubrir** — cambios del diff actual que ninguna parada describe. Ahí entran las ediciones hechas después de generar, los cambios que el recorrido consideró rutinarios y los archivos de bloqueo u otra salida generada, que se dejan fuera del modelo a propósito. Todo aparece al final para que nada desaparezca en silencio.
+
+Regenerar no parchea, reescribe: el recorrido anterior va al modelo como contexto, así que lo que sigue siendo cierto se conserva, y todo se reancla al código actual.
+
+## Notas
+
+- Puedes comentar cualquier línea igual que en la vista de diff; los comentarios se adjuntan al campo del chat.
+- Disponible en escritorio y anchos de tableta. No se ofrece en la extensión de VS Code ni en la app móvil.
+- Recorrer un pull request requiere una cuenta de GitHub conectada — consulta [Issues y PR de GitHub](/github/).
+
+## Relacionado
+
+- [Git y GitHub](/git/) — el panel de cambios del que lee, y la acción Review que sí juzga el código
+- [Issues y PR de GitHub](/github/) — conecta GitHub para recorrer pull requests
+- [Proveedores, modelos y agentes](/providers/) — de dónde sale el modelo pequeño
diff --git a/packages/docs/content/docs/fr/walkthrough.mdx b/packages/docs/content/docs/fr/walkthrough.mdx
new file mode 100644
index 00000000..39262b71
--- /dev/null
+++ b/packages/docs/content/docs/fr/walkthrough.mdx
@@ -0,0 +1,71 @@
+---
+title: Parcours des modifications
+description: Lisez un diff dans l’ordre qui a du sens, pas dans l’ordre alphabétique.
+---
+
+# Parcours des modifications
+
+Un diff est trié par chemin de fichier, ce qui n’est presque jamais l’ordre dans lequel la modification prend son sens. Le parcours le réorganise : les changements liés sont regroupés en **étapes**, chaque étape explique ce que le code fait désormais différemment, et les étapes s’enchaînent pour que chacune s’appuie sur la précédente.
+
+Il explique et ordonne. Il ne juge pas votre code et ne rend aucun verdict — c’est le rôle de [Review](/git/).
+
+Ouvrez-le par l’icône **Parcours** dans la barre de droite, ou par le bouton **Parcours IA** dans les panneaux des modifications et de la pull request. Les deux se contentent d’ouvrir le panneau ; rien n’est généré tant que vous n’appuyez pas sur **Générer le parcours**.
+
+## Ce qu’il peut parcourir
+
+| Portée | Ce qu’elle couvre |
+| --- | --- |
+| Tout non validé | Tout ce qui n’est pas encore dans un commit : indexé, non indexé et nouveaux fichiers |
+| Indexées | Uniquement ce qui partirait dans un commit maintenant |
+| Non indexées | Copie de travail et nouveaux fichiers |
+| Cette branche | Tous les commits de la branche absents de sa base |
+| Pull request | La modification telle qu’elle existe sur GitHub |
+
+**Cette branche** ne veut pas dire « commits non poussés » : c’est tout ce que la branche ajoute à sa base, poussé ou non. Après un commit mais avant un push, elle et la pull request diffèrent donc volontairement : l’une montre ce que vous avez fait, l’autre ce que voient les relecteurs.
+
+Chaque portée est stockée séparément : passer de l’une à l’autre ne perd jamais rien.
+
+## Choisir le modèle
+
+Les parcours utilisent votre petit modèle par défaut. Choisissez-en un autre dans **Paramètres → Sessions → Modèle du parcours des modifications**, ou pour une seule relecture depuis l’en-tête du panneau — utile quand une modification est assez risquée pour mériter un modèle plus solide.
+
+Le sélecteur ne propose que des modèles capables de sortie structurée, sans laquelle le parcours ne peut pas être assemblé. Si un modèle est trop petit pour le diff, la génération est refusée avec une explication plutôt que de tronquer l’entrée en silence : un parcours écrit sur la moitié d’un diff sonne assuré et se trompe.
+
+En rouvrant le panneau, vous voyez le modèle qui a produit ce que vous avez sous les yeux ; **Régénérer** reprend donc le même tant que vous n’en changez pas.
+
+## Choisir la langue
+
+Les parcours sont rédigés dans la langue de votre interface par défaut. Le sélecteur de langue dans l’en-tête du panneau démarre là, et vous pouvez choisir n’importe quelle autre langue dans laquelle OpenChamber est traduit pour une seule relecture : une explication guidée ne sert que dans une langue que vous lisez à l’aise.
+
+Seule la prose est traduite. Les identifiants, les chemins de fichiers et les noms d’API restent exactement tels qu’ils apparaissent dans votre code, si bien que ce qu’une étape nomme reste ce que vous pouvez rechercher.
+
+Si rien n’a encore été généré dans la langue choisie, le panneau ne se vide pas : il continue d’afficher le parcours qu’il a et le signale. Appuyez sur **Générer le parcours** pour l’obtenir dans la nouvelle langue.
+
+## Coût et cache
+
+Rien ne se génère tout seul. La génération ne démarre que sur votre demande, et la régénération est manuelle elle aussi.
+
+Les résultats sont mis en cache d’après le contenu exact du diff. Ramenez la copie de travail à un état antérieur et le parcours d’alors revient gratuitement, sans appel au modèle. La langue et le modèle font partie de cette clé, donc chaque combinaison est conservée séparément : dès qu’un diff a un parcours en deux langues, passer de l’une à l’autre est instantané et gratuit.
+
+La génération tourne sur le serveur OpenChamber, pas dans votre onglet. Rechargez la page ou fermez le panneau : le travail continue et le résultat vous attend. Seul **Annuler** l’interrompt.
+
+## Rester honnête sur l’obsolescence
+
+Chaque étape est ancrée au contenu exact du code qu’elle décrit, ce qui permet au panneau de signaler quand ce code a bougé :
+
+- **Étapes obsolètes** — le code décrit par une étape a changé ou disparu. Le parcours reste affiché, marqué, pour que vous décidiez s’il faut régénérer.
+- **Non traité** — des modifications du diff actuel qu’aucune étape ne décrit. On y trouve les changements faits après la génération, ceux que le parcours a jugés courants, ainsi que les fichiers de verrouillage et autres sorties générées, délibérément tenus hors du modèle. Tout est listé à la fin pour que rien ne disparaisse en silence.
+
+Régénérer ne rapièce pas, cela réécrit : le parcours précédent est fourni au modèle comme contexte, ce qui reste vrai est conservé, et tout est réancré sur le code actuel.
+
+## Notes
+
+- Vous pouvez commenter n’importe quelle ligne comme dans la vue diff ; les commentaires se rattachent au champ du chat.
+- Disponible sur ordinateur et sur les largeurs de tablette. Non proposé dans l’extension VS Code ni dans l’application mobile.
+- Parcourir une pull request exige un compte GitHub connecté — voir [Issues et PR GitHub](/github/).
+
+## Voir aussi
+
+- [Git et GitHub](/git/) — le panneau des modifications qu’il lit, et l’action Review qui, elle, juge le code
+- [Issues et PR GitHub](/github/) — connectez GitHub pour parcourir les pull requests
+- [Fournisseurs, modèles et agents](/providers/) — d’où vient le petit modèle
diff --git a/packages/docs/content/docs/ja/walkthrough.mdx b/packages/docs/content/docs/ja/walkthrough.mdx
new file mode 100644
index 00000000..ad12a3d3
--- /dev/null
+++ b/packages/docs/content/docs/ja/walkthrough.mdx
@@ -0,0 +1,71 @@
+---
+title: 変更のウォークスルー
+description: 差分をアルファベット順ではなく、意味の通る順序で読みます。
+---
+
+# 変更のウォークスルー
+
+差分はファイルパス順に並びますが、それは変更の意味が通る順序であることはほとんどありません。ウォークスルーはこれを並べ替えます。関連する編集を**ステップ**にまとめ、各ステップはコードが今までと何が違う動きをするのかを説明し、前のステップの上に次が積み上がる順序で並びます。
+
+説明し、順序を与えるものです。コードを評価したり判定を下したりはしません。それは [Review](/git/) の役割です。
+
+右側のレールの**ウォークスルー**アイコン、または変更パネルとプルリクエストパネルの **AI ウォークスルー**ボタンから開きます。どちらもパネルを開くだけで、**ウォークスルーを生成**を押すまで何も生成されません。
+
+## 対象にできる範囲
+
+| 範囲 | 含まれるもの |
+| --- | --- |
+| 未コミットすべて | まだコミットされていないもの全部: ステージ済み、未ステージ、新規ファイル |
+| ステージ済み | 今コミットすれば入るものだけ |
+| 未ステージ | 作業ツリーと新規ファイル |
+| このブランチ | ベースに無い、このブランチのすべてのコミット |
+| プルリクエスト | GitHub 上に存在する形の変更 |
+
+**このブランチ**は「未プッシュのコミット」ではなく、プッシュの有無に関わらずブランチがベースに追加したすべてです。そのためコミット後・プッシュ前には、これとプルリクエストは意図的に食い違います。前者はあなたが何をしたかを、後者はレビュアーが今何を見ているかを示します。
+
+範囲ごとに別々に保存されるため、切り替えても失われるものはありません。
+
+## モデルの選択
+
+ウォークスルーは既定でスモールモデルを使います。**設定 → セッション → 変更ウォークスルーのモデル**で別のモデルを選べます。一度だけならパネルのヘッダーからも選べます。リスクの高い変更を、より強いモデルに任せたいときに便利です。
+
+選択肢に出るのは構造化出力を返せるモデルだけです。それが無ければウォークスルーは組み立てられません。差分に対してモデルが小さすぎる場合は、入力を黙って切り詰めるのではなく、理由を示して生成を拒否します。差分の半分だけを見て書かれたウォークスルーは、自信ありげに間違えるからです。
+
+パネルを開き直すと、目の前の内容を生成したモデルが表示されます。したがって**再生成**は、変更しない限り同じモデルで繰り返します。
+
+## 言語の選択
+
+ウォークスルーは既定でインターフェースの言語で書かれます。パネル上部の言語セレクターはその言語から始まり、1 回のレビューだけ OpenChamber が翻訳されている他の言語に切り替えることもできます。案内は、無理なく読める言語でなければ意味がありません。
+
+翻訳されるのは文章だけです。識別子、ファイルパス、API 名はコードにあるままなので、ストップが指し示すものはそのまま検索できます。
+
+選んだ言語でまだ何も生成されていない場合、パネルは空にならず、手元にあるウォークスルーを表示したままその旨を伝えます。**ウォークスルーを生成** を押すと、新しい言語で生成されます。
+
+## コストとキャッシュ
+
+勝手に生成されることはありません。生成はあなたが求めたときだけ始まり、再生成も手動です。
+
+結果は差分の正確な内容に対してキャッシュされます。作業ツリーを以前の状態に戻せば、そのときのウォークスルーがモデル呼び出し無しで戻ります。言語とモデルもこのキーの一部なので、組み合わせごとに別々に保存されます。ある差分に 2 つの言語のウォークスルーができれば、その切り替えは即座で無料です。
+
+生成はブラウザのタブではなく OpenChamber サーバー上で動きます。ページを再読み込みしてもパネルを閉じても処理は続き、戻れば結果が待っています。止められるのは**キャンセル**だけです。
+
+## 古くなったことを正直に示す
+
+各ステップは説明対象のコードの正確な内容に紐づいているため、そのコードが動いたことをパネルが伝えられます。
+
+- **古くなったステップ** — ステップが説明していたコードが変わった、あるいは無くなった。ウォークスルーは印を付けたまま表示され、再生成するかはあなたが決めます。
+- **未対応** — 現在の差分のうち、どのステップも説明していない変更。生成後に加えた編集、ウォークスルーが定型的と判断した変更、そして意図的にモデルへ渡していないロックファイルなどの生成物が含まれます。すべて末尾に一覧されるので、黙って消えるものはありません。
+
+再生成は継ぎ当てではなく書き直しです。前回のウォークスルーが文脈としてモデルに渡るため、まだ正しい部分は残り、すべてが現在のコードに紐づけ直されます。
+
+## 補足
+
+- 差分ビューと同じように任意の行にコメントできます。コメントはチャットの入力欄に添付されます。
+- デスクトップとタブレット幅で利用できます。VS Code 拡張とモバイルアプリでは提供されません。
+- プルリクエストのウォークスルーには GitHub アカウントの接続が必要です。[GitHub の Issue と PR](/github/) を参照してください。
+
+## 関連
+
+- [Git と GitHub](/git/) — 読み取り元となる変更パネルと、実際にコードを評価する Review アクション
+- [GitHub の Issue と PR](/github/) — プルリクエストを扱うために GitHub を接続する
+- [プロバイダー・モデル・エージェント](/providers/) — スモールモデルの出どころ
diff --git a/packages/docs/content/docs/ko/walkthrough.mdx b/packages/docs/content/docs/ko/walkthrough.mdx
new file mode 100644
index 00000000..33f23ba7
--- /dev/null
+++ b/packages/docs/content/docs/ko/walkthrough.mdx
@@ -0,0 +1,71 @@
+---
+title: 변경 워크스루
+description: diff를 알파벳순이 아니라 이해되는 순서로 읽습니다.
+---
+
+# 변경 워크스루
+
+diff는 파일 경로순으로 정렬되지만, 그 순서가 변경을 이해하기 좋은 순서인 경우는 거의 없습니다. 워크스루는 이를 다시 배열합니다. 관련된 수정들을 **단계**로 묶고, 각 단계는 코드가 이제 무엇을 다르게 하는지 설명하며, 앞 단계 위에 다음 단계가 쌓이도록 순서를 정합니다.
+
+설명하고 순서를 부여할 뿐, 코드를 심사하거나 판정을 내리지 않습니다. 그건 [Review](/git/)의 역할입니다.
+
+오른쪽 레일의 **워크스루** 아이콘이나, 변경 패널과 풀 리퀘스트 패널의 **AI 워크스루** 버튼으로 엽니다. 둘 다 패널을 열기만 하며, **워크스루 생성**을 누르기 전에는 아무것도 생성되지 않습니다.
+
+## 다룰 수 있는 범위
+
+| 범위 | 포함되는 것 |
+| --- | --- |
+| 커밋되지 않은 전체 | 아직 커밋되지 않은 모든 것: 스테이지됨, 스테이지 안 됨, 새 파일 |
+| 스테이지됨 | 지금 커밋하면 들어갈 것만 |
+| 스테이지 안 됨 | 작업 트리와 새 파일 |
+| 이 브랜치 | 베이스에 없는 이 브랜치의 모든 커밋 |
+| 풀 리퀘스트 | GitHub에 존재하는 형태의 변경 |
+
+**이 브랜치**는 "푸시하지 않은 커밋"이 아니라, 푸시 여부와 무관하게 브랜치가 베이스에 더한 전부입니다. 그래서 커밋한 뒤 푸시하기 전에는 이것과 풀 리퀘스트가 의도적으로 달라집니다. 하나는 당신이 한 일을, 다른 하나는 리뷰어가 지금 보는 것을 보여줍니다.
+
+범위마다 따로 저장되므로 전환해도 잃는 것이 없습니다.
+
+## 모델 선택
+
+워크스루는 기본적으로 스몰 모델을 사용합니다. **설정 → 세션 → 변경 워크스루 모델**에서 다른 모델을 고르거나, 한 번만 쓸 모델은 패널 헤더에서 고를 수 있습니다. 변경이 충분히 위험해서 더 강한 모델에 맡기고 싶을 때 유용합니다.
+
+선택 목록에는 구조화된 출력을 반환할 수 있는 모델만 나옵니다. 그것 없이는 워크스루를 구성할 수 없기 때문입니다. 모델이 diff에 비해 작으면 입력을 조용히 잘라내는 대신 이유를 설명하며 생성을 거부합니다. diff의 절반만 보고 쓴 워크스루는 자신 있게 틀리기 때문입니다.
+
+패널을 다시 열면 지금 보고 있는 결과를 만든 모델이 표시되므로, 바꾸지 않는 한 **다시 생성**은 같은 모델로 반복합니다.
+
+## 언어 선택
+
+워크스루는 기본적으로 인터페이스 언어로 작성됩니다. 패널 헤더의 언어 선택기가 그 언어에서 시작하며, 한 번의 리뷰에 한해 OpenChamber가 번역된 다른 언어를 고를 수 있습니다. 안내는 편하게 읽을 수 있는 언어여야 쓸모가 있습니다.
+
+번역되는 것은 서술뿐입니다. 식별자, 파일 경로, API 이름은 코드에 있는 그대로 남으므로, 각 지점이 가리키는 이름을 그대로 검색할 수 있습니다.
+
+선택한 언어로 아직 생성된 것이 없으면 패널은 비워지지 않고, 가지고 있는 워크스루를 계속 보여주면서 그 사실을 알립니다. **워크스루 생성**을 누르면 새 언어로 만들어집니다.
+
+## 비용과 캐시
+
+저절로 생성되는 것은 없습니다. 생성은 요청할 때만 시작되고, 재생성도 수동입니다.
+
+결과는 diff의 정확한 내용을 기준으로 캐시됩니다. 작업 트리를 이전 상태로 되돌리면 그때의 워크스루가 모델 호출 없이 그대로 돌아옵니다. 언어와 모델도 이 키의 일부라서 조합마다 따로 보관됩니다. 한 diff에 두 언어의 워크스루가 생기면 그 사이를 오가는 것은 즉시 이루어지고 비용도 들지 않습니다.
+
+생성은 브라우저 탭이 아니라 OpenChamber 서버에서 실행됩니다. 페이지를 새로 고치거나 패널을 닫아도 작업은 계속되고, 돌아오면 결과가 기다립니다. 멈추는 것은 **취소**뿐입니다.
+
+## 오래됨을 정직하게 알리기
+
+각 단계는 설명 대상 코드의 정확한 내용에 묶여 있어서, 그 코드가 변했을 때 패널이 알려줄 수 있습니다.
+
+- **오래된 단계** — 단계가 설명하던 코드가 바뀌었거나 사라졌습니다. 워크스루는 표시된 채로 계속 보이며, 다시 생성할지는 당신이 정합니다.
+- **미포함** — 현재 diff에서 어떤 단계도 설명하지 않는 변경입니다. 생성 이후에 한 수정, 워크스루가 일상적이라고 판단한 변경, 그리고 의도적으로 모델에 넘기지 않는 잠금 파일 등 생성물이 여기에 들어갑니다. 모두 끝에 나열되므로 조용히 사라지는 것은 없습니다.
+
+재생성은 기우는 것이 아니라 다시 쓰는 것입니다. 이전 워크스루가 맥락으로 모델에 전달되어 여전히 맞는 부분은 살아남고, 전체가 현재 코드에 다시 묶입니다.
+
+## 참고
+
+- diff 보기와 똑같이 아무 줄에나 코멘트할 수 있고, 코멘트는 채팅 입력창에 첨부됩니다.
+- 데스크톱과 태블릿 너비에서 사용할 수 있습니다. VS Code 확장과 모바일 앱에서는 제공되지 않습니다.
+- 풀 리퀘스트 워크스루에는 연결된 GitHub 계정이 필요합니다 — [GitHub 이슈와 PR](/github/)을 참고하세요.
+
+## 관련 문서
+
+- [Git과 GitHub](/git/) — 이 기능이 읽어오는 변경 패널, 그리고 실제로 코드를 심사하는 Review 액션
+- [GitHub 이슈와 PR](/github/) — 풀 리퀘스트를 다루려면 GitHub를 연결하세요
+- [프로바이더, 모델, 에이전트](/providers/) — 스몰 모델이 어디서 오는지
diff --git a/packages/docs/content/docs/pl/walkthrough.mdx b/packages/docs/content/docs/pl/walkthrough.mdx
new file mode 100644
index 00000000..2215808e
--- /dev/null
+++ b/packages/docs/content/docs/pl/walkthrough.mdx
@@ -0,0 +1,71 @@
+---
+title: Przewodnik po zmianach
+description: Czytaj różnice w kolejności, która ma sens, a nie alfabetycznie.
+---
+
+# Przewodnik po zmianach
+
+Różnice są posortowane po ścieżkach plików, a to prawie nigdy nie jest kolejność, w której zmiana staje się zrozumiała. Przewodnik układa je na nowo: powiązane edycje trafiają do wspólnych **kroków**, każdy krok tłumaczy, co kod robi teraz inaczej, a kolejność kroków jest taka, by każdy opierał się na poprzednim.
+
+Tłumaczy i porządkuje. Nie ocenia kodu i nie wydaje werdyktów — od tego jest [Review](/git/).
+
+Otwórz go ikoną **Przewodnik** na prawym pasku albo przyciskiem **Przewodnik AI** w panelach zmian i pull requestu. Oba tylko otwierają panel; nic nie powstaje, dopóki nie naciśniesz **Wygeneruj przewodnik**.
+
+## Co można przejrzeć
+
+| Zakres | Co obejmuje |
+| --- | --- |
+| Wszystko niezatwierdzone | Wszystko, czego nie ma jeszcze w commicie: poczekalnia, drzewo robocze i nowe pliki |
+| W poczekalni | Tylko to, co trafiłoby teraz do commita |
+| Poza poczekalnią | Drzewo robocze i nowe pliki |
+| Ta gałąź | Wszystkie commity gałęzi, których nie ma w jej bazie |
+| Pull request | Zmiana w postaci, w jakiej istnieje na GitHubie |
+
+**Ta gałąź** to nie „commity bez pusha", lecz wszystko, co gałąź dokłada do swojej bazy — niezależnie od pusha. Dlatego po commicie, a przed pushem, ona i pull request celowo się różnią: jedno pokazuje, co zrobiłeś, drugie to, co widzą teraz recenzenci.
+
+Każdy zakres jest zapisywany osobno, więc przełączanie między nimi niczego nie gubi.
+
+## Wybór modelu
+
+Przewodniki domyślnie używają małego modelu. Inny wybierzesz w **Ustawienia → Sesje → Model przewodnika po zmianach** albo — na jeden raz — w nagłówku panelu. Przydaje się, gdy zmiana jest na tyle ryzykowna, że zasługuje na mocniejszy model.
+
+Lista pokazuje tylko modele potrafiące zwracać ustrukturyzowaną odpowiedź, bo bez niej przewodnika nie da się złożyć. Jeśli model jest za mały na te różnice, generowanie zostaje odrzucone z wyjaśnieniem, zamiast po cichu obciąć wejście: przewodnik napisany na podstawie połowy różnic brzmi pewnie i się myli.
+
+Po ponownym otwarciu panelu zobaczysz model, który stworzył to, co masz przed sobą, więc **Wygeneruj ponownie** powtórzy tym samym, dopóki go nie zmienisz.
+
+## Wybór języka
+
+Przewodniki są domyślnie pisane w języku Twojego interfejsu. Selektor języka w nagłówku panelu zaczyna właśnie od niego, a dla pojedynczego przeglądu możesz wybrać dowolny inny język, na który przetłumaczono OpenChamber — prowadzone wyjaśnienie ma sens tylko w języku, który czytasz swobodnie.
+
+Tłumaczona jest wyłącznie proza. Identyfikatory, ścieżki plików i nazwy API pozostają dokładnie takie, jakie są w Twoim kodzie, więc to, co nazywa dany przystanek, nadal da się wyszukać.
+
+Jeśli w wybranym języku nic jeszcze nie powstało, panel się nie opróżnia: nadal pokazuje przewodnik, który ma, i informuje o tym. Naciśnij **Wygeneruj przewodnik**, aby otrzymać go w nowym języku.
+
+## Koszt i pamięć podręczna
+
+Nic nie generuje się samo. Generowanie zaczyna się wyłącznie na Twoje żądanie, ponowne również jest ręczne.
+
+Wyniki są zapisywane w pamięci podręcznej według dokładnej treści różnic. Przywróć drzewo robocze do wcześniejszego stanu, a tamten przewodnik wróci za darmo, bez wywołania modelu. Język i model są częścią tego klucza, więc każda kombinacja jest przechowywana osobno: gdy różnice mają już przewodnik w dwóch językach, przełączanie między nimi jest natychmiastowe i nic nie kosztuje.
+
+Generowanie działa na serwerze OpenChamber, nie w karcie przeglądarki. Odśwież stronę albo zamknij panel, a praca trwa dalej; po powrocie wynik czeka. Zatrzymuje ją tylko **Anuluj**.
+
+## Uczciwość wobec nieaktualności
+
+Każdy krok jest przypięty do dokładnej treści kodu, który opisuje, więc panel potrafi powiedzieć, kiedy ten kod się zmienił:
+
+- **Nieaktualne kroki** — kod opisywany przez krok zmienił się albo zniknął. Przewodnik nadal się wyświetla, z oznaczeniem, żebyś sam zdecydował o ponownym wygenerowaniu.
+- **Nieuwzględnione** — zmiany w bieżących różnicach, których nie opisuje żaden krok. Trafiają tu edycje zrobione po wygenerowaniu, zmiany uznane przez przewodnik za rutynowe oraz pliki blokad i inne wyniki narzędzi, celowo trzymane poza modelem. Wszystko jest wypisane na końcu, żeby nic nie zniknęło po cichu.
+
+Ponowne wygenerowanie nie łata, lecz pisze od nowa: poprzedni przewodnik trafia do modelu jako kontekst, więc to, co nadal jest prawdą, zostaje, a całość zostaje przypięta do bieżącego kodu.
+
+## Uwagi
+
+- Możesz komentować dowolną linię tak samo jak w widoku różnic; komentarze dołączają się do pola czatu.
+- Dostępne na komputerze i przy szerokościach tabletu. Nie ma tego w rozszerzeniu VS Code ani w aplikacji mobilnej.
+- Przewodnik po pull requeście wymaga połączonego konta GitHub — zobacz [Issues i PR na GitHubie](/github/).
+
+## Powiązane
+
+- [Git i GitHub](/git/) — panel zmian, z którego to czyta, oraz akcja Review, która faktycznie ocenia kod
+- [Issues i PR na GitHubie](/github/) — połącz GitHub, aby przeglądać pull requesty
+- [Dostawcy, modele i agenci](/providers/) — skąd bierze się mały model
diff --git a/packages/docs/content/docs/pt-br/walkthrough.mdx b/packages/docs/content/docs/pt-br/walkthrough.mdx
new file mode 100644
index 00000000..d541ace8
--- /dev/null
+++ b/packages/docs/content/docs/pt-br/walkthrough.mdx
@@ -0,0 +1,71 @@
+---
+title: Percurso pelas mudanças
+description: Leia um diff na ordem que faz sentido, não em ordem alfabética.
+---
+
+# Percurso pelas mudanças
+
+Um diff é ordenado por caminho de arquivo, que quase nunca é a ordem em que a mudança faz sentido. O percurso reorganiza isso: edições relacionadas viram **paradas**, cada parada explica o que o código passa a fazer de diferente, e as paradas seguem uma ordem em que cada uma se apoia na anterior.
+
+Ele explica e ordena. Não julga o seu código nem dá veredictos — isso é papel do [Review](/git/).
+
+Abra pelo ícone **Percurso** na barra direita ou pelo botão **Percurso com IA** nos painéis de mudanças e de pull request. Ambos apenas abrem o painel; nada é gerado até você apertar **Gerar percurso**.
+
+## O que dá para percorrer
+
+| Escopo | O que inclui |
+| --- | --- |
+| Tudo sem commit | Tudo que ainda não está em commit: no stage, fora do stage e arquivos novos |
+| No stage | Só o que iria para um commit agora |
+| Fora do stage | Árvore de trabalho e arquivos novos |
+| Este branch | Todos os commits do branch que não estão na base |
+| Pull request | A mudança como ela existe no GitHub |
+
+**Este branch** não quer dizer "commits sem push": é tudo o que o branch acrescenta à sua base, com push ou sem. Por isso, depois do commit e antes do push, ele e o pull request divergem de propósito: um mostra o que você fez, o outro o que os revisores veem agora.
+
+Cada escopo é guardado separadamente, então alternar entre eles nunca perde nada.
+
+## Escolhendo o modelo
+
+Os percursos usam o seu modelo pequeno por padrão. Escolha outro em **Configurações → Sessões → Modelo do percurso de mudanças**, ou apenas para uma revisão no cabeçalho do painel — útil quando a mudança é arriscada o bastante para merecer um modelo mais forte.
+
+O seletor só oferece modelos capazes de devolver saída estruturada, porque sem ela o percurso não se monta. Se o modelo for pequeno demais para o diff, a geração é recusada com explicação em vez de cortar a entrada em silêncio: um percurso escrito sobre metade de um diff soa seguro e está errado.
+
+Ao reabrir o painel você vê o modelo que produziu o que está na tela, então **Gerar novamente** repete com o mesmo, a menos que você troque.
+
+## Escolhendo o idioma
+
+Os percursos são escritos no idioma da sua interface por padrão. O seletor de idioma no cabeçalho do painel começa por ele, e você pode escolher qualquer outro idioma para o qual o OpenChamber esteja traduzido para uma única revisão — uma explicação guiada só serve num idioma que você lê com folga.
+
+Só a prosa é traduzida. Identificadores, caminhos de arquivo e nomes de API continuam exatamente como aparecem no seu código, então o que uma parada nomeia continua sendo o que você consegue buscar.
+
+Se ainda não houver nada gerado no idioma escolhido, o painel não se esvazia: ele continua mostrando o percurso que tem e avisa. Toque em **Gerar percurso** para obtê-lo no novo idioma.
+
+## Custo e cache
+
+Nada é gerado sozinho. A geração só começa quando você pede, e gerar de novo também é manual.
+
+Os resultados ficam em cache pelo conteúdo exato do diff. Volte a árvore de trabalho para um estado anterior e aquele percurso retorna de graça, sem chamar o modelo. O idioma e o modelo fazem parte dessa chave, então cada combinação é guardada separadamente: quando um diff já tem percurso em dois idiomas, alternar entre eles é instantâneo e não custa nada.
+
+A geração roda no servidor do OpenChamber, não na aba do navegador. Recarregue a página ou feche o painel e o trabalho continua; ao voltar, o resultado está esperando. Só **Cancelar** interrompe.
+
+## Honestidade sobre o que ficou velho
+
+Cada parada está ancorada ao conteúdo exato do código que descreve, então o painel consegue avisar quando esse código mudou:
+
+- **Etapas desatualizadas** — o código que a parada descrevia mudou ou sumiu. O percurso continua aparecendo, marcado, para você decidir se regenera.
+- **Sem cobertura** — mudanças do diff atual que nenhuma parada descreve. Entram aí as edições feitas depois de gerar, as mudanças que o percurso considerou rotineiras e os arquivos de lock e outras saídas geradas, mantidas fora do modelo de propósito. Tudo aparece no fim, para que nada suma em silêncio.
+
+Regenerar não remenda, reescreve: o percurso anterior vai ao modelo como contexto, o que ainda é verdade permanece, e tudo é reancorado no código atual.
+
+## Notas
+
+- Você pode comentar qualquer linha como na visão de diff; os comentários se anexam ao campo do chat.
+- Disponível em desktop e larguras de tablet. Não é oferecido na extensão do VS Code nem no app móvel.
+- Percorrer um pull request exige uma conta do GitHub conectada — veja [Issues e PRs do GitHub](/github/).
+
+## Relacionado
+
+- [Git e GitHub](/git/) — o painel de mudanças de onde isso lê, e a ação Review, que de fato julga o código
+- [Issues e PRs do GitHub](/github/) — conecte o GitHub para percorrer pull requests
+- [Provedores, modelos e agentes](/providers/) — de onde vem o modelo pequeno
diff --git a/packages/docs/content/docs/uk/walkthrough.mdx b/packages/docs/content/docs/uk/walkthrough.mdx
new file mode 100644
index 00000000..187d5ff6
--- /dev/null
+++ b/packages/docs/content/docs/uk/walkthrough.mdx
@@ -0,0 +1,71 @@
+---
+title: Розбір змін
+description: Читайте diff у порядку, який має сенс, а не в алфавітному.
+---
+
+# Розбір змін
+
+Diff упорядкований за шляхами файлів, а це майже ніколи не той порядок, у якому зміна стає зрозумілою. Розбір перебудовує його: пов'язані правки збираються в **кроки**, кожен крок пояснює, що саме код тепер робить інакше, а самі кроки йдуть так, щоб кожен спирався на попередній.
+
+Він пояснює й упорядковує. Він не оцінює ваш код і не виносить вердиктів — для цього є [Review](/git/).
+
+Відкрийте його іконкою **Розбір** у правому рейлі або кнопкою **AI-розбір** у панелях змін і pull request. Обидві лише відкривають панель; нічого не генерується, доки ви не натиснете **Створити розбір**.
+
+## Що можна розібрати
+
+| Область | Що охоплює |
+| --- | --- |
+| Усе незакомічене | Усе, що ще не в комітах: індекс, робоче дерево й нові файли |
+| В індексі | Лише те, що зараз пішло б у коміт |
+| Поза індексом | Робоче дерево й нові файли |
+| Ця гілка | Усі коміти гілки, яких немає в базовій |
+| Pull request | Зміна в тому вигляді, у якому вона є на GitHub |
+
+**Ця гілка** — це не «незапушені коміти», а все, що гілка додає до базової, незалежно від пушу. Тому після коміту, але до пушу, вона й pull request навмисно розходяться: одне показує, що ви зробили, друге — що зараз бачать рецензенти.
+
+Кожна область зберігається окремо, тож перемикання між ними нічого не втрачає.
+
+## Вибір моделі
+
+За замовчуванням розбір використовує вашу small model. Іншу можна обрати в **Налаштування → Сесії → Модель для розбору змін** або для одного разу в шапці панелі — корисно, коли зміна достатньо ризикована, щоб віддати її сильнішій моделі.
+
+У списку показані лише моделі, які вміють structured output, бо без нього розбір неможливо зібрати. Якщо модель замала для цього diff, генерація відхиляється з поясненням, а не обрізає вхід мовчки: розбір, написаний за половиною diff, звучить упевнено й при цьому помиляється.
+
+Відкривши панель знову, ви побачите модель, яка створила те, що перед вами, тож **Створити заново** повторить тією самою, доки ви її не зміните.
+
+## Вибір мови
+
+За замовчуванням розбір пишеться мовою вашого інтерфейсу. Саме з неї починає селектор мови в шапці панелі, і для окремого розбору можна обрати будь-яку іншу мову, якою перекладено OpenChamber — пояснення має сенс лише тією мовою, яку ви читаєте вільно.
+
+Перекладається лише проза. Ідентифікатори, шляхи до файлів і назви API лишаються точно такими, як у вашому коді, тож те, що називає зупинка, і далі можна знайти пошуком.
+
+Якщо обраною мовою ще нічого не згенеровано, панель не порожніє: вона й далі показує наявний розбір і повідомляє про це. Натисніть **Створити розбір**, щоб отримати його новою мовою.
+
+## Витрати й кеш
+
+Ніщо не генерується саме. Генерація починається лише на ваш запит, і повторна теж робиться вручну.
+
+Результати кешуються за точним вмістом diff. Поверніть робоче дерево до попереднього стану — і попередній розбір повернеться безкоштовно, без звернення до моделі. Мова й модель — частина цього ключа, тож кожна комбінація зберігається окремо: коли для diff уже є розбір двома мовами, перемикання між ними миттєве й безкоштовне.
+
+Генерація виконується на сервері OpenChamber, а не у вкладці браузера. Перезавантажте сторінку чи закрийте панель — робота триває, а результат чекатиме на вас. Зупиняє її лише кнопка **Скасувати**.
+
+## Чесність щодо застарілого
+
+Кожен крок прив'язаний до точного вмісту коду, який він описує, тож панель може сказати, коли той код змінився:
+
+- **Застарілі кроки** — код, який описував крок, змінився або зник. Розбір усе одно показується, з позначкою, щоб ви самі вирішили, чи перегенеровувати.
+- **Не описано** — зміни в поточному diff, яких не описує жоден крок. Сюди потрапляють правки, зроблені після генерації, зміни, які розбір визнав рутинними, а також lock-файли й інші згенеровані файли, які свідомо не потрапляють до моделі. Усе це перелічено в кінці, щоб нічого не зникло непомітно.
+
+Повторна генерація не латає, а переписує: попередній розбір іде в модель як контекст, тому точні частини зберігаються, а прив'язки заново перераховуються під поточний код.
+
+## Примітки
+
+- Коментувати можна будь-який рядок, так само як у вигляді diff; коментарі чіпляються до поля вводу в чаті.
+- Доступно на десктопі та планшетних ширинах. У розширенні для VS Code і в мобільному застосунку не пропонується.
+- Для розбору pull request потрібен під'єднаний акаунт GitHub — див. [Issues та PR на GitHub](/github/).
+
+## Пов'язане
+
+- [Git і GitHub](/git/) — панель змін, з якої це читається, і дія Review, яка таки оцінює код
+- [Issues та PR на GitHub](/github/) — під'єднайте GitHub, щоб розбирати pull request
+- [Провайдери, моделі та агенти](/providers/) — звідки береться small model
diff --git a/packages/docs/content/docs/walkthrough.mdx b/packages/docs/content/docs/walkthrough.mdx
new file mode 100644
index 00000000..6d372bf5
--- /dev/null
+++ b/packages/docs/content/docs/walkthrough.mdx
@@ -0,0 +1,71 @@
+---
+title: Changes Walkthrough
+description: Read a diff in the order it makes sense, not in alphabetical order.
+---
+
+# Changes Walkthrough
+
+A diff is sorted by file path, which is almost never the order in which the change makes sense. The walkthrough reorders it: related edits are grouped into **stops**, each stop explains what the code now does differently, and the stops are ordered so each one builds on the last.
+
+It explains and orders. It does not judge your code or hand out verdicts — that is what [Review](/git/) is for.
+
+Open it from the **Walkthrough** icon in the right rail, or from the **AI walkthrough** button in the Changes and Pull Request panels. Both just open the panel; nothing is generated until you press **Generate walkthrough**.
+
+## What it can review
+
+| Scope | What it covers |
+| --- | --- |
+| All uncommitted | Everything not yet committed: staged, unstaged, and new files |
+| Staged | Only what would go into a commit right now |
+| Unstaged | Working tree and new files |
+| This branch | Every commit on this branch that is not on its base |
+| Pull request | The change as it exists on GitHub |
+
+**This branch** is not "unpushed commits" — it is everything the branch adds to its base, pushed or not. So after committing but before pushing, it and the pull request deliberately differ: one shows what you did, the other what reviewers currently see.
+
+Each scope is stored separately, so switching between them never loses anything.
+
+## Choosing the model
+
+Walkthroughs use your small model by default. Pick a different one in **Settings → Sessions → Changes Walkthrough Model**, or for a single review in the panel header — useful when a change is risky enough to deserve a stronger model.
+
+The picker only offers models that can return structured output, because the walkthrough cannot be assembled without it. If a model is too small for the diff, generation is refused with an explanation rather than silently truncating the input: a walkthrough written against half a diff reads as confident and is wrong.
+
+Reopening a panel shows the model that produced what you are looking at, so **Regenerate** repeats with the same one unless you change it.
+
+## Choosing the language
+
+Walkthroughs are written in your interface language by default. The language picker in the panel header starts there, and you can pick any other language OpenChamber is translated into for a single review — a guided explanation is only useful in a language you read comfortably.
+
+Only the prose is translated. Identifiers, file paths, and API names stay exactly as they appear in your code, so what a stop names is still what you can search for.
+
+When nothing has been generated yet in the language you picked, the panel keeps showing the walkthrough it has and says so, rather than emptying itself. Press **Generate walkthrough** to get one in the new language.
+
+## Cost and caching
+
+Nothing generates on its own. Generation only ever starts when you ask, and regeneration is manual too.
+
+Results are cached against the exact content of the diff. Return the working tree to an earlier state and the earlier walkthrough comes back for free, no model call. Language and model are both part of that key, so each combination is kept separately: once a diff has a walkthrough in two languages, switching between them is instant and costs nothing.
+
+Generation runs on the OpenChamber server, not in your browser tab. Reload the page or close the panel and it keeps going; come back and the result is waiting. Pressing **Cancel** is the only thing that stops it.
+
+## Staying honest about staleness
+
+Every stop is anchored to the exact content of the code it describes, so the panel can tell you when that code has moved on:
+
+- **Outdated steps** — the code a stop described has changed or is gone. The walkthrough still shows, marked, so you can decide whether to regenerate.
+- **Not covered** — changes in the current diff that no stop describes. That includes edits made after generating, changes the walkthrough judged routine, and lockfiles and other generated files, which are deliberately kept out of the model's input. They are all listed at the end of the stream so nothing disappears silently.
+
+Regenerating re-authors rather than patches: the previous walkthrough goes to the model as context so accurate parts survive, and everything is re-anchored to the current code.
+
+## Notes
+
+- Comment on any line in the walkthrough exactly as in the diff view; comments attach to the chat composer.
+- Available on desktop and tablet widths. Not offered in the VS Code extension or the mobile app.
+- A pull request review needs a connected GitHub account — see [GitHub Issues & PRs](/github/).
+
+## Related
+
+- [Git & GitHub](/git/) — the Changes panel this reads from, and the Review action that does judge code
+- [GitHub Issues & PRs](/github/) — connect GitHub to review pull requests
+- [Providers, Models & Agents](/providers/) — where the small model comes from
diff --git a/packages/docs/content/docs/zh-cn/walkthrough.mdx b/packages/docs/content/docs/zh-cn/walkthrough.mdx
new file mode 100644
index 00000000..24d982d7
--- /dev/null
+++ b/packages/docs/content/docs/zh-cn/walkthrough.mdx
@@ -0,0 +1,71 @@
+---
+title: 改动导读
+description: 按讲得通的顺序读差异，而不是按字母顺序。
+---
+
+# 改动导读
+
+差异按文件路径排序，而这几乎从来不是让改动讲得通的顺序。导读会重新编排：相关的修改被归入一个个**步骤**，每个步骤说明代码现在有什么不同的行为，步骤的先后顺序保证后一步建立在前一步之上。
+
+它负责解释和排序，不评判你的代码，也不给结论——那是 [Review](/git/) 的职责。
+
+从右侧栏的**导读**图标打开，或在改动面板和拉取请求面板中点击 **AI 导读**按钮。两者都只是打开面板；在你按下**生成导读**之前不会生成任何内容。
+
+## 可以导读的范围
+
+| 范围 | 包含内容 |
+| --- | --- |
+| 全部未提交 | 尚未进入提交的一切：已暂存、未暂存和新文件 |
+| 已暂存 | 只包含此刻提交会带上的内容 |
+| 未暂存 | 工作区和新文件 |
+| 当前分支 | 该分支上基线分支所没有的全部提交 |
+| 拉取请求 | GitHub 上现有形态的改动 |
+
+**当前分支**不是“未推送的提交”，而是该分支相对基线新增的全部内容，无论是否推送。因此在提交之后、推送之前，它和拉取请求会有意不同：一个显示你做了什么，另一个显示评审者当前看到什么。
+
+各个范围分别保存，来回切换不会丢失任何内容。
+
+## 选择模型
+
+导读默认使用你的小模型。可在**设置 → 会话 → 改动导读模型**中更换，或只为这一次在面板标题栏中选择——当改动的风险足以交给更强的模型时很有用。
+
+选择列表只提供能返回结构化输出的模型，因为没有它就无法组装导读。如果模型对这份差异来说太小，生成会带着说明被拒绝，而不是悄悄截断输入：只看了半份差异写出的导读听起来笃定，实际却是错的。
+
+重新打开面板时会显示生成当前内容的那个模型，所以只要你不更换，**重新生成**就会沿用它。
+
+## 选择语言
+
+导读默认使用你的界面语言书写。面板顶部的语言选择器从该语言开始，你也可以只为这一次导读改用 OpenChamber 已翻译的任意其他语言——讲解只有用你读起来轻松的语言才有价值。
+
+只有叙述文字会被翻译。标识符、文件路径和 API 名称保持代码中的原样，因此每个停靠点提到的名字仍然可以直接搜索。
+
+如果所选语言还没有生成过内容，面板不会清空：它会继续显示已有的导读并说明这一点。按 **生成导读** 即可得到新语言的版本。
+
+## 开销与缓存
+
+不会自行生成。生成只在你请求时开始，重新生成同样需要手动触发。
+
+结果按差异的确切内容缓存。把工作区恢复到先前状态，当时的导读就会免费回来，不会调用模型。语言和模型都属于这个键的一部分，因此每种组合各自保存：一个差异一旦有了两种语言的导读，在它们之间切换就是即时且免费的。
+
+生成运行在 OpenChamber 服务器上，而不是浏览器标签页里。刷新页面或关闭面板，工作仍在继续；回来时结果已在等你。只有**取消**能停止它。
+
+## 对过时保持诚实
+
+每个步骤都锚定在它所描述代码的确切内容上，因此面板能告诉你那段代码何时发生了变化：
+
+- **过时的步骤**——步骤所描述的代码已改变或不存在。导读仍会显示并加以标记，由你决定是否重新生成。
+- **未涵盖**——当前差异中没有任何步骤描述的改动。其中包括生成之后所做的修改、导读判定为常规的改动，以及锁文件等特意不送入模型的生成产物。它们都列在末尾，不会有内容悄无声息地消失。
+
+重新生成不是打补丁，而是重写：上一版导读会作为上下文交给模型，仍然成立的部分得以保留，整体则重新锚定到当前代码。
+
+## 说明
+
+- 可以像在差异视图中一样对任意行发表评论，评论会附加到聊天输入框。
+- 在桌面和平板宽度下可用。VS Code 扩展和移动应用中不提供。
+- 导读拉取请求需要已连接的 GitHub 账户，参见 [GitHub Issue 与 PR](/github/)。
+
+## 相关
+
+- [Git 与 GitHub](/git/)——它读取的改动面板，以及确实会评判代码的 Review 操作
+- [GitHub Issue 与 PR](/github/)——连接 GitHub 以导读拉取请求
+- [提供方、模型与代理](/providers/)——小模型从何而来
diff --git a/packages/docs/sidebar.config.json b/packages/docs/sidebar.config.json
index a364bf71..15673b20 100644
--- a/packages/docs/sidebar.config.json
+++ b/packages/docs/sidebar.config.json
@@ -10,7 +10,8 @@
"ko": "여기서 시작",
"pl": "Zacznij tutaj",
"fr": "Commencer ici",
- "ja": "ここから開始"
+ "ja": "ここから開始",
+ "de": "Hier starten"
},
"items": [
{
@@ -24,7 +25,8 @@
"ko": "개요",
"pl": "Przegląd",
"fr": "Vue d’ensemble",
- "ja": "概要"
+ "ja": "概要",
+ "de": "Übersicht"
}
},
{
@@ -38,7 +40,8 @@
"ko": "설치",
"pl": "Instalacja",
"fr": "Installation",
- "ja": "インストール"
+ "ja": "インストール",
+ "de": "Installation"
}
},
{
@@ -52,7 +55,8 @@
"ko": "빠른 시작",
"pl": "Szybki start",
"fr": "Démarrage rapide",
- "ja": "クイックスタート"
+ "ja": "クイックスタート",
+ "de": "Schnellstart"
}
},
{
@@ -66,7 +70,8 @@
"ko": "OpenCode 서버",
"pl": "Serwer OpenCode",
"fr": "Serveur OpenCode",
- "ja": "OpenCode サーバー"
+ "ja": "OpenCode サーバー",
+ "de": "OpenCode-Server"
}
},
{
@@ -80,7 +85,8 @@
"ko": "환경 변수",
"pl": "Zmienne środowiskowe",
"fr": "Variables d’environnement",
- "ja": "環境変数"
+ "ja": "環境変数",
+ "de": "Umgebungsvariablen"
}
}
]
@@ -95,7 +101,8 @@
"ko": "워크플로",
"pl": "Przepływy pracy",
"fr": "Workflows",
- "ja": "ワークフロー"
+ "ja": "ワークフロー",
+ "de": "Abläufe"
},
"items": [
{
@@ -109,7 +116,8 @@
"ko": "프로젝트",
"pl": "Projekty",
"fr": "Projets",
- "ja": "プロジェクト"
+ "ja": "プロジェクト",
+ "de": "Projekte"
}
},
{
@@ -123,7 +131,8 @@
"ko": "컨텍스트",
"pl": "Kontekst",
"fr": "Contexte",
- "ja": "コンテキスト"
+ "ja": "コンテキスト",
+ "de": "Kontext"
}
},
{
@@ -137,7 +146,8 @@
"ko": "메모, 할 일, 계획",
"pl": "Notatki, zadania i plany",
"fr": "Notes, todos et plans",
- "ja": "メモ、Todo、計画"
+ "ja": "メモ、Todo、計画",
+ "de": "Notizen, Aufgaben und Pläne"
}
},
{
@@ -151,7 +161,8 @@
"ko": "예약 작업",
"pl": "Zaplanowane zadania",
"fr": "Tâches planifiées",
- "ja": "スケジュールタスク"
+ "ja": "スケジュールタスク",
+ "de": "Geplante Aufgaben"
}
},
{
@@ -165,7 +176,8 @@
"ko": "에이전트 제어 도구",
"pl": "Narzędzie sterowania dla agentów",
"fr": "Outil de contrôle pour les agents",
- "ja": "エージェント制御ツール"
+ "ja": "エージェント制御ツール",
+ "de": "Agenten-Steuerungstool"
}
},
{
@@ -179,7 +191,8 @@
"ko": "세션 목표",
"pl": "Cele sesji",
"fr": "Objectifs de session",
- "ja": "セッションゴール"
+ "ja": "セッションゴール",
+ "de": "Sitzungsziele"
}
},
{
@@ -193,7 +206,8 @@
"ko": "프로젝트 작업",
"pl": "Akcje projektu",
"fr": "Actions de projet",
- "ja": "プロジェクトアクション"
+ "ja": "プロジェクトアクション",
+ "de": "Projektaktionen"
}
},
{
@@ -207,7 +221,8 @@
"ko": "미리보기 및 개발 서버",
"pl": "Podgląd i serwery deweloperskie",
"fr": "Aperçu et serveurs de dev",
- "ja": "プレビューと開発サーバー"
+ "ja": "プレビューと開発サーバー",
+ "de": "Vorschau und Entwicklungsserver"
}
},
{
@@ -221,7 +236,8 @@
"ko": "Worktree 세션",
"pl": "Sesje worktree",
"fr": "Sessions worktree",
- "ja": "Worktree セッション"
+ "ja": "Worktree セッション",
+ "de": "Worktree-Sitzungen"
}
},
{
@@ -229,7 +245,8 @@
"link": "/multi-run/",
"translations": {
"fr": "Multi-run",
- "ja": "Multi-run"
+ "ja": "Multi-run",
+ "de": "Mehrfachausführung"
}
},
{
@@ -237,7 +254,23 @@
"link": "/git/",
"translations": {
"fr": "Git et GitHub",
- "ja": "Git と GitHub"
+ "ja": "Git と GitHub",
+ "de": "Git und GitHub"
+ }
+ },
+ {
+ "label": "Changes Walkthrough",
+ "link": "/walkthrough/",
+ "translations": {
+ "uk": "Розбір змін",
+ "zh-CN": "改动导读",
+ "es": "Recorrido por los cambios",
+ "pt-BR": "Percurso pelas mudanças",
+ "ko": "변경 워크스루",
+ "pl": "Przewodnik po zmianach",
+ "fr": "Parcours des modifications",
+ "ja": "変更のウォークスルー",
+ "de": "Änderungsrundgang"
}
},
{
@@ -251,7 +284,8 @@
"ko": "GitHub 이슈 및 PR",
"pl": "Zgłoszenia i PR-y GitHub",
"fr": "Issues et PR GitHub",
- "ja": "GitHub Issues と PR"
+ "ja": "GitHub Issues と PR",
+ "de": "GitHub-Issues und PRs"
}
},
{
@@ -265,7 +299,8 @@
"ko": "매직 프롬프트",
"pl": "Magiczne prompty",
"fr": "Magic Prompts",
- "ja": "マジックプロンプト"
+ "ja": "マジックプロンプト",
+ "de": "Magische Prompts"
}
},
{
@@ -279,7 +314,8 @@
"ko": "Git 아이덴티티",
"pl": "Tożsamości Git",
"fr": "Identités Git",
- "ja": "Git ID"
+ "ja": "Git ID",
+ "de": "Git-Identitäten"
}
}
]
@@ -294,7 +330,8 @@
"ko": "OpenCode 설정",
"pl": "Konfiguracja OpenCode",
"fr": "Configuration OpenCode",
- "ja": "OpenCode 設定"
+ "ja": "OpenCode 設定",
+ "de": "OpenCode-Einrichtung"
},
"items": [
{
@@ -308,7 +345,8 @@
"ko": "공급자, 모델, 에이전트",
"pl": "Dostawcy, modele i agenci",
"fr": "Fournisseurs, modèles et agents",
- "ja": "プロバイダー、モデル、エージェント"
+ "ja": "プロバイダー、モデル、エージェント",
+ "de": "Anbieter, Modelle und Agenten"
}
},
{
@@ -322,7 +360,8 @@
"ko": "MCP 서버",
"pl": "Serwery MCP",
"fr": "Serveurs MCP",
- "ja": "MCP サーバー"
+ "ja": "MCP サーバー",
+ "de": "MCP-Server"
}
},
{
@@ -336,7 +375,8 @@
"ko": "스킬",
"pl": "Umiejętności",
"fr": "Skills",
- "ja": "スキル"
+ "ja": "スキル",
+ "de": "Fähigkeiten"
}
},
{
@@ -350,7 +390,8 @@
"ko": "스킬 카탈로그",
"pl": "Katalog umiejętności",
"fr": "Catalogue de skills",
- "ja": "スキルカタログ"
+ "ja": "スキルカタログ",
+ "de": "Fähigkeitenkatalog"
}
},
{
@@ -364,7 +405,8 @@
"ko": "명령 및 스니펫",
"pl": "Polecenia i fragmenty",
"fr": "Commandes et snippets",
- "ja": "コマンドとスニペット"
+ "ja": "コマンドとスニペット",
+ "de": "Befehle und Snippets"
}
},
{
@@ -378,7 +420,8 @@
"ko": "사용량 및 할당량",
"pl": "Zużycie i limity",
"fr": "Utilisation et quotas",
- "ja": "使用量とクォータ"
+ "ja": "使用量とクォータ",
+ "de": "Nutzung und Kontingente"
}
}
]
@@ -393,7 +436,8 @@
"ko": "원격 접속",
"pl": "Dostęp zdalny",
"fr": "Accès distant",
- "ja": "リモートアクセス"
+ "ja": "リモートアクセス",
+ "de": "Zugriff von außen"
},
"items": [
{
@@ -407,7 +451,8 @@
"ko": "기기 연결",
"pl": "Podłączanie urządzenia",
"fr": "Connecter un appareil",
- "ja": "デバイスを接続"
+ "ja": "デバイスを接続",
+ "de": "Gerät verbinden"
}
},
{
@@ -421,7 +466,8 @@
"ko": "프라이빗 릴레이",
"pl": "Prywatny relay",
"fr": "Relay privé",
- "ja": "プライベートリレー"
+ "ja": "プライベートリレー",
+ "de": "Privates Relay"
}
},
{
@@ -435,7 +481,8 @@
"ko": "터널",
"pl": "Tunele",
"fr": "Tunnels",
- "ja": "トンネル"
+ "ja": "トンネル",
+ "de": "Tunnel"
}
},
{
@@ -449,7 +496,8 @@
"ko": "리버스 프록시",
"pl": "Reverse proxy",
"fr": "Reverse proxy",
- "ja": "リバースプロキシ"
+ "ja": "リバースプロキシ",
+ "de": "Reverse Proxy"
}
},
{
@@ -463,7 +511,8 @@
"ko": "모바일 앱 및 PWA",
"pl": "Aplikacje mobilne i PWA",
"fr": "Apps mobiles et PWA",
- "ja": "モバイルアプリと PWA"
+ "ja": "モバイルアプリと PWA",
+ "de": "Mobile Apps und PWA"
}
},
{
@@ -477,7 +526,8 @@
"ko": "보안",
"pl": "Bezpieczeństwo",
"fr": "Sécurité",
- "ja": "セキュリティ"
+ "ja": "セキュリティ",
+ "de": "Sicherheit"
}
}
]
@@ -492,7 +542,8 @@
"ko": "맞춤 설정",
"pl": "Dostosuj",
"fr": "Personnaliser",
- "ja": "カスタマイズ"
+ "ja": "カスタマイズ",
+ "de": "Anpassen"
},
"items": [
{
@@ -506,7 +557,8 @@
"ko": "테마",
"pl": "Motywy",
"fr": "Thèmes",
- "ja": "テーマ"
+ "ja": "テーマ",
+ "de": "Designs"
}
},
{
@@ -520,7 +572,8 @@
"ko": "알림",
"pl": "Powiadomienia",
"fr": "Notifications",
- "ja": "通知"
+ "ja": "通知",
+ "de": "Benachrichtigungen"
}
},
{
@@ -534,7 +587,8 @@
"ko": "음성 모드",
"pl": "Tryb głosowy",
"fr": "Mode vocal",
- "ja": "音声モード"
+ "ja": "音声モード",
+ "de": "Sprachmodus"
}
},
{
@@ -548,7 +602,8 @@
"ko": "프로젝트 아이콘",
"pl": "Ikony projektów",
"fr": "Icônes de projet",
- "ja": "プロジェクトアイコン"
+ "ja": "プロジェクトアイコン",
+ "de": "Projektsymbole"
}
}
]
@@ -563,7 +618,8 @@
"ko": "데스크톱",
"pl": "Pulpit",
"fr": "Desktop",
- "ja": "デスクトップ"
+ "ja": "デスクトップ",
+ "de": "Desktop"
},
"items": [
{
@@ -577,7 +633,8 @@
"ko": "원격 인스턴스",
"pl": "Zdalne instancje",
"fr": "Instances distantes",
- "ja": "リモートインスタンス"
+ "ja": "リモートインスタンス",
+ "de": "Entfernte Instanzen"
}
},
{
@@ -591,7 +648,8 @@
"ko": "데스크톱 브라우저",
"pl": "Przeglądarka na pulpicie",
"fr": "Navigateur desktop",
- "ja": "デスクトップブラウザ"
+ "ja": "デスクトップブラウザ",
+ "de": "Desktop-Browser"
}
},
{
@@ -605,7 +663,8 @@
"ko": "데스크톱 터널",
"pl": "Tunele w aplikacji desktopowej",
"fr": "Tunnels desktop",
- "ja": "デスクトップトンネル"
+ "ja": "デスクトップトンネル",
+ "de": "Desktop-Tunnel"
}
},
{
@@ -619,7 +678,8 @@
"ko": "SSH 호스트 및 프록시",
"pl": "Hosty SSH i proxy",
"fr": "Hosts SSH et proxy",
- "ja": "SSH ホストとプロキシ"
+ "ja": "SSH ホストとプロキシ",
+ "de": "SSH-Hosts und Proxying"
}
},
{
@@ -633,7 +693,8 @@
"ko": "업데이트",
"pl": "Aktualizacje",
"fr": "Mises à jour",
- "ja": "更新"
+ "ja": "更新",
+ "de": "Aktualisierungen"
}
}
]
@@ -648,7 +709,8 @@
"ko": "도움말",
"pl": "Pomoc",
"fr": "Aide",
- "ja": "ヘルプ"
+ "ja": "ヘルプ",
+ "de": "Hilfe"
},
"items": [
{
@@ -662,7 +724,8 @@
"ko": "문제 해결",
"pl": "Rozwiązywanie problemów",
"fr": "Dépannage",
- "ja": "トラブルシューティング"
+ "ja": "トラブルシューティング",
+ "de": "Fehlerbehebung"
}
},
{
@@ -676,7 +739,8 @@
"ko": "OpenCode 연결",
"pl": "Połączenie z OpenCode",
"fr": "Connexion à OpenCode",
- "ja": "OpenCode 接続"
+ "ja": "OpenCode 接続",
+ "de": "OpenCode-Verbindung"
}
},
{
@@ -690,7 +754,8 @@
"ko": "Worktree 및 Git",
"pl": "Worktree i Git",
"fr": "Worktrees et Git",
- "ja": "Worktrees と Git"
+ "ja": "Worktrees と Git",
+ "de": "Worktrees und Git"
}
},
{
@@ -704,7 +769,8 @@
"ko": "원격 접속",
"pl": "Dostęp zdalny",
"fr": "Accès distant",
- "ja": "リモートアクセス"
+ "ja": "リモートアクセス",
+ "de": "Externer Zugriff"
}
}
]
diff --git a/packages/mobile/HANDOFF.md b/packages/mobile/HANDOFF.md
index 92fa01e7..47b16577 100644
--- a/packages/mobile/HANDOFF.md
+++ b/packages/mobile/HANDOFF.md
@@ -81,9 +81,10 @@ iOS Simulator helpers: `mobile:sim:{boot,install,launch,run,serve,list,kill}` (s
- **Connection onboarding** — server URL entry, password unlock for locked servers, client-token
issuance, saved connections, `Instances` management sheet, auto-connect to the last instance on
launch. Deleting the active instance resets the runtime to the connect screen.
-- **QR pairing** — `@capacitor-mlkit/barcode-scanning`. Android's Google code scanner module is
- downloaded on first scan (needs Play Services + network); `mobileQrScan.ts` installs/awaits it
- and retries. CAMERA permission + `NSCameraUsageDescription` declared.
+- **QR pairing** — `@capacitor-mlkit/barcode-scanning`. Android uses the CameraX-backed
+ `startScan()` flow with the barcode model bundled in the app, so scanning works offline and
+ without Google Play Services. iOS uses the plugin's native scanner. CAMERA permission +
+ `NSCameraUsageDescription` declared.
- **Secure storage** — `@aparajita/capacitor-secure-storage` for connection tokens.
- **Deep links** — `openchamber://` URL scheme; a reusable intent vocabulary (`apps/deepLinks.ts`)
used by notification taps, widgets, and Control Center. Cold-launch intents are stashed.
@@ -128,8 +129,7 @@ iOS Simulator helpers: `mobile:sim:{boot,install,launch,run,serve,list,kill}` (s
brings `firebase-messaging`.
- Manifest: permissions `INTERNET`, `CAMERA` (+ optional camera feature), `POST_NOTIFICATIONS`
(Android 13+; older versions allow notifications by default). `windowSoftInputMode=adjustResize`.
- ML Kit `com.google.mlkit.vision.DEPENDENCIES=barcode_ui` meta (preloads the code scanner). FCM
- `default_notification_icon=@drawable/ic_stat_notify`.
+ FCM `default_notification_icon=@drawable/ic_stat_notify`.
- Adaptive launcher icon: full-bleed color background + `ic_launcher_foreground` (sources under
`packages/mobile/assets/`, regenerable with `@capacitor/assets`).
diff --git a/packages/mobile/README.md b/packages/mobile/README.md
index eb5f98f4..a06a96d8 100644
--- a/packages/mobile/README.md
+++ b/packages/mobile/README.md
@@ -8,8 +8,10 @@ The mobile package reuses the web build, then rewrites `mobile.html` to `index.h
- The native app bundles the mobile UI only; it does not embed the OpenChamber web server or OpenCode server.
- On first launch in Capacitor, the app shows a connection screen for an existing OpenChamber server.
-- Connections are saved locally in the app and can be managed from the mobile overflow menu under `Instances`.
-- The connection screen and `Instances` menu item are Capacitor-only. Hosted `mobile.html` in a normal browser keeps the regular web behavior.
+- Connections are saved locally in the app and can be managed from `Instances` in the sessions drawer footer (a persistent left sidebar on tablets).
+- The connection screen and the `Instances` entry are Capacitor-only. Hosted `mobile.html` in a normal browser keeps the regular web behavior.
+- Phones and tablets share one navigation model: a sessions drawer/sidebar on the left, the workspace drawer (Changes / Files / Terminal / Notes / MCP) on the right, and no overflow menu. Tablets differ only in that the sessions list is a resizable persistent sidebar and the header dropdowns are anchored popovers.
+- The tablet layout is a live size class (`useTabletLayout`), not a device check: any surface whose short side is at least 600px gets it, and the workspace only becomes a side panel where the width can host the sidebar, the panel and a readable chat at once. Book foldables therefore pick it up when unfolded, keep the portrait layout in both orientations (their long side is barely wider than a tablet's short one), and drop back to the phone layout when folded shut. The Android activity declares the matching `configChanges`, so folding resizes the WebView instead of recreating it.
- Password-protected OpenChamber servers can be unlocked from the mobile app. The app stores the issued client token with the saved connection.
- The Terminal workspace surface runs its PTY on the active OpenChamber server over the shared authenticated runtime transport; it never opens a local shell on the phone or tablet. Closing the surface detaches the renderer while the server session remains available for reattachment. On touch devices, dragging scrolls the buffer while long-pressing and dragging selects terminal text.
diff --git a/packages/mobile/android/app/src/main/AndroidManifest.xml b/packages/mobile/android/app/src/main/AndroidManifest.xml
index d00b87da..dba5d6b5 100644
--- a/packages/mobile/android/app/src/main/AndroidManifest.xml
+++ b/packages/mobile/android/app/src/main/AndroidManifest.xml
@@ -35,13 +35,6 @@
-
-
-
;
}> = ({ side, isResizing, ariaLabel, handleProps }) => (
void }> = ({ onActiveConnectionDeleted }) => {
const { t } = useI18n();
@@ -116,26 +106,20 @@ const MobileShell: React.FC<{ onActiveConnectionDeleted: () => void }> = ({ onAc
// open/close so the right-edge swipe reopens where the user left off.
const [workspaceOpen, setWorkspaceOpen] = React.useState(false);
const [workspaceTab, setWorkspaceTab] = React.useState('changes');
- const [isMcpRefreshing, setIsMcpRefreshing] = React.useState(false);
- // A plan opened from the Project notes surface, shown as a second fullscreen
+ // A plan opened from the workspace drawer's Notes tab, shown as a fullscreen
// layer on top of it (back returns to the notes).
const [openPlan, setOpenPlan] = React.useState<{ path: string; title: string } | null>(null);
const [settingsInitialMobileStage, setSettingsInitialMobileStage] = React.useState<'nav' | 'page-content'>('nav');
- const [overflowOpen, setOverflowOpen] = React.useState(false);
// When set, the Changes surface opens directly into the per-file diff for this path.
const [pendingChangesDiff, setPendingChangesDiff] = React.useState<{ path: string; staged: boolean } | null>(null);
- const currentDirectory = useDirectoryStore((state) => state.currentDirectory);
const setSettingsPage = useUIStore((state) => state.setSettingsPage);
+ const wideChatLayoutEnabled = useUIStore((state) => state.wideChatLayoutEnabled);
const updateAvailable = useUpdateStore((state) => state.available);
const updateRuntimeType = useUpdateStore((state) => state.runtimeType);
const showCapacitorOnlyFeatures = React.useMemo(() => isCapacitorMobileApp(), []);
const mcpServers = useMcpConfigStore((state) => state.mcpServers);
const setMcpDraft = useMcpConfigStore((state) => state.setMcpDraft);
const setSelectedMcp = useMcpConfigStore((state) => state.setSelectedMcp);
- const refreshMcpStatus = useMcpStore((state) => state.refresh);
- const loadMcpConfigs = useMcpConfigStore((state) => state.loadMcpConfigs);
- const gitStatus = useGitStatus(normalizePath(currentDirectory) || null);
- const dirtyChangeCount = gitStatus?.files?.length ?? 0;
// NOTE: pendingChangesDiff is intentionally NOT cleared on close — it keys
// the persistent Changes pane in the workspace drawer, and clearing it would
@@ -158,76 +142,93 @@ const MobileShell: React.FC<{ onActiveConnectionDeleted: () => void }> = ({ onAc
openSurface('settings');
}, [openSurface]);
- // iPad (Capacitor): sessions live in a persistent full-height left sidebar
- // and Changes/Files in a right sidebar, instead of phone sheets/surfaces.
- const isIPad = React.useMemo(() => isIPadApp(), []);
+ // Tablet: sessions live in a persistent full-height left sidebar instead of
+ // the phone's drawer. Everything else — the workspace drawer, the header, the
+ // app-level surfaces — is shared with phones.
+ //
+ // A SIZE class, not a device check: an unfolded book foldable is a tablet
+ // until it is folded shut, and the shell keeps running across that change.
+ const { enabled: isTabletLayout, roomyForPanels } = useTabletLayout();
const orientation = useOrientation();
const isPortrait = orientation === 'portrait';
- const [ipadSidebarOpen, setIpadSidebarOpen] = React.useState(isIPad && !isPortrait);
- const [ipadRightPanel, setIpadRightPanel] = React.useState<'files' | 'changes' | null>(null);
+ const hasHardwareKeyboard = useHardwareKeyboard();
+ const [sidebarOpen, setSidebarOpen] = React.useState(() => readTabletLayout().roomyForPanels);
- const toggleIpadSidebar = React.useCallback(() => {
- const willOpen = !ipadSidebarOpen;
- // Portrait doesn't fit both side panels next to a usable chat column:
- // opening one closes the other (iPadOS behaves the same way).
- if (willOpen && isPortrait) setIpadRightPanel(null);
- setIpadSidebarOpen(willOpen);
- }, [ipadSidebarOpen, isPortrait]);
+ const toggleSidebar = React.useCallback(() => {
+ setSidebarOpen((current: boolean) => !current);
+ }, []);
+
+ // Folding shut (or losing the room for a side-by-side layout) must not leave
+ // a sidebar open over a phone-width screen.
+ React.useEffect(() => {
+ if (!isTabletLayout) setSidebarOpen(false);
+ }, [isTabletLayout]);
const openFilesSurface = React.useCallback(() => {
- if (isIPad) {
- setPendingChangesDiff(null);
- setIpadRightPanel('files');
- if (isPortrait) setIpadSidebarOpen(false);
- return;
- }
+ setPendingChangesDiff(null);
setWorkspaceTab('files');
setWorkspaceOpen(true);
- }, [isIPad, isPortrait]);
+ }, []);
const openChangesSurface = React.useCallback((diff: { path: string; staged: boolean } | null = null) => {
setPendingChangesDiff(diff);
- if (isIPad) {
- setIpadRightPanel('changes');
- if (isPortrait) setIpadSidebarOpen(false);
- return;
- }
setWorkspaceTab('changes');
setWorkspaceOpen(true);
- }, [isIPad, isPortrait]);
-
- const closeIpadRightPanel = React.useCallback(() => {
- setIpadRightPanel(null);
- setPendingChangesDiff(null);
}, []);
- const toggleIpadRightPanel = React.useCallback((panel: 'files' | 'changes') => {
- if (ipadRightPanel === panel) {
- closeIpadRightPanel();
- return;
- }
- if (panel === 'files') openFilesSurface();
- else openChangesSurface();
- }, [closeIpadRightPanel, ipadRightPanel, openChangesSurface, openFilesSurface]);
-
- // Keep the right panel's content mounted through the width-collapse
- // animation; drop it once the panel is fully closed.
- const lastIpadRightPanelRef = React.useRef<'files' | 'changes'>('changes');
- if (ipadRightPanel) lastIpadRightPanelRef.current = ipadRightPanel;
- const [ipadRightContentMounted, setIpadRightContentMounted] = React.useState(false);
- React.useEffect(() => {
- if (!isIPad) return;
- if (ipadRightPanel) {
- setIpadRightContentMounted(true);
- return;
- }
- const id = window.setTimeout(() => setIpadRightContentMounted(false), 240);
- return () => window.clearTimeout(id);
- }, [ipadRightPanel, isIPad]);
- const renderedIpadRightPanel = ipadRightPanel ?? lastIpadRightPanelRef.current;
-
const leftResize = useIpadSidebarResize('left', 'openchamber.ipad.leftSidebarWidth', IPAD_LEFT_SIDEBAR_WIDTH);
- const rightResize = useIpadSidebarResize('right', 'openchamber.ipad.rightSidebarWidth', IPAD_RIGHT_SIDEBAR_WIDTH);
+ const rightResize = useIpadSidebarResize(
+ 'right',
+ 'openchamber.ipad.rightSidebarWidth',
+ IPAD_RIGHT_SIDEBAR_WIDTH,
+ IPAD_WORKSPACE_SIDEBAR_MAX_WIDTH,
+ );
+ // The workspace becomes a real side panel only where the screen can host the
+ // sidebar, the panel AND a readable chat at once. Everywhere else — a tablet
+ // in portrait, and an unfolded foldable in EITHER orientation, since its long
+ // side is barely wider than a tablet's short one — it stays the full-cover
+ // drawer, which is the layout that actually works at that width.
+ const workspaceAsPanel = roomyForPanels;
+ const workspacePanelWidth = workspaceAsPanel && workspaceOpen ? rightResize.width : 0;
+ const sidebarWidth = isTabletLayout && sidebarOpen ? leftResize.width : 0;
+
+ // Publish the chat column's insets so overlays portaled to (model
+ // picker, directory picker, every MobileOverlayPanel) can center on the CHAT
+ // rather than on the window. Zero on phones, where the two are the same.
+ React.useEffect(() => {
+ if (typeof document === 'undefined') return;
+ const root = document.documentElement;
+ root.style.setProperty('--oc-chat-inset-left', `${sidebarWidth}px`);
+ root.style.setProperty('--oc-chat-inset-right', `${workspacePanelWidth}px`);
+ return () => {
+ root.style.removeProperty('--oc-chat-inset-left');
+ root.style.removeProperty('--oc-chat-inset-right');
+ };
+ }, [sidebarWidth, workspacePanelWidth]);
+
+ // Wide chat layout: the shared chat columns key off this root class, but only
+ // the desktop App set it — so on a tablet, where the chat column is finally
+ // wide enough for the setting to mean something, it did nothing. Applied for
+ // every mobile surface; on a phone the viewport is narrower than even the
+ // normal clamp, so it is a no-op there.
+ React.useEffect(() => {
+ if (typeof document === 'undefined') return;
+ const root = document.documentElement;
+ root.classList.toggle('wide-chat-layout', wideChatLayoutEnabled);
+ return () => root.classList.remove('wide-chat-layout');
+ }, [wideChatLayoutEnabled]);
+
+ // The draft screen keeps its starter chips while the keyboard is up when
+ // there is room for both: a tablet in portrait, or any tablet orientation
+ // with a hardware keyboard (then no software keyboard eats the screen at
+ // all). Landscape on the software keyboard still hides them — see mobile.css.
+ React.useEffect(() => {
+ if (typeof document === 'undefined') return;
+ const keep = isTabletLayout && (isPortrait || hasHardwareKeyboard);
+ const root = document.documentElement;
+ root.classList.toggle('oc-keep-draft-starters', keep);
+ return () => root.classList.remove('oc-keep-draft-starters');
+ }, [hasHardwareKeyboard, isTabletLayout, isPortrait]);
const mobileActions = React.useMemo(
() => ({
@@ -246,7 +247,7 @@ const MobileShell: React.FC<{ onActiveConnectionDeleted: () => void }> = ({ onAc
const deepLinkHandlers = React.useMemo(
() => ({
openSessions: () => {
- if (isIPad) setIpadSidebarOpen(true);
+ if (isTabletLayout) setSidebarOpen(true);
else setSessionsSheetOpen(true);
},
openView: (target: 'files' | 'mcp' | 'instances' | 'update') => {
@@ -254,8 +255,7 @@ const MobileShell: React.FC<{ onActiveConnectionDeleted: () => void }> = ({ onAc
openFilesSurface();
return;
}
- // Phones host MCP as a workspace tab now; iPad still uses the surface.
- if (target === 'mcp' && !isIPad) {
+ if (target === 'mcp') {
setWorkspaceTab('mcp');
setWorkspaceOpen(true);
return;
@@ -270,37 +270,25 @@ const MobileShell: React.FC<{ onActiveConnectionDeleted: () => void }> = ({ onAc
openSettingsSurface(section ? 'page-content' : 'nav');
},
}),
- [isIPad, openChangesSurface, openFilesSurface, openSettingsSurface, openSurface, setSettingsPage],
+ [isTabletLayout, openChangesSurface, openFilesSurface, openSettingsSurface, openSurface, setSettingsPage],
);
useDeepLinkHandlers(deepLinkHandlers);
- // Edge swipes on the chat: left edge opens the sessions drawer (the iPad
- // sidebar on iPad), right edge reopens the most recent overflow surface
- // (the last right panel on iPad).
+ // Edge swipes on the chat: left edge opens the sessions drawer (the
+ // persistent sidebar on a tablet), right edge the workspace drawer.
const chatMainRef = React.useRef(null);
useEdgeSwipe(chatMainRef, {
onLeftEdgeSwipe: () => {
- if (isIPad) setIpadSidebarOpen(true);
+ if (isTabletLayout) setSidebarOpen(true);
else setSessionsSheetOpen(true);
},
- onRightEdgeSwipe: () => {
- if (isIPad) {
- if (lastIpadRightPanelRef.current === 'files') openFilesSurface();
- else openChangesSurface();
- return;
- }
- setWorkspaceOpen(true);
- },
+ onRightEdgeSwipe: () => setWorkspaceOpen(true),
});
- // Top-most layer first: a plan or fullscreen surface can now sit ABOVE a
- // drawer (opened from the drawer footer / workspace tabs), so they close
- // before the drawers underneath.
+ // Top-most layer first: a plan or fullscreen surface can sit ABOVE a drawer
+ // (opened from the drawer footer / workspace tabs), so they close before the
+ // drawers underneath.
const handleNativeBack = React.useCallback(() => {
- if (overflowOpen) {
- setOverflowOpen(false);
- return true;
- }
if (openPlan) {
setOpenPlan(null);
return true;
@@ -318,7 +306,7 @@ const MobileShell: React.FC<{ onActiveConnectionDeleted: () => void }> = ({ onAc
return true;
}
return false;
- }, [activeSurface, closeSurface, closeWorkspace, openPlan, overflowOpen, sessionsSheetOpen, workspaceOpen]);
+ }, [activeSurface, closeSurface, closeWorkspace, openPlan, sessionsSheetOpen, workspaceOpen]);
useNativeAndroidBackButton(handleNativeBack);
@@ -329,6 +317,22 @@ const MobileShell: React.FC<{ onActiveConnectionDeleted: () => void }> = ({ onAc
&& updateAvailable
&& (updateRuntimeType === 'desktop' || updateRuntimeType === 'web');
+ // Tablets pack the app-level pages (settings, instances, a plan) into a
+ // centered dialog instead of covering the whole screen.
+ const surfaceVariant = isTabletLayout ? 'dialog' as const : 'fullscreen' as const;
+
+ // App-level footer of the sessions list — the same on a phone drawer and a
+ // tablet sidebar: connected instance, pending web update, settings.
+ const sessionsFooter = React.useMemo(
+ () => ({
+ instanceLabel: showCapacitorOnlyFeatures ? getAutoConnectTargetLabel() : null,
+ onOpenInstances: showCapacitorOnlyFeatures ? () => openSurface('instances') : undefined,
+ onOpenSettings: () => openSettingsSurface('nav'),
+ onOpenUpdate: showUpdateItem ? () => openSurface('update') : undefined,
+ }),
+ [openSettingsSurface, openSurface, showCapacitorOnlyFeatures, showUpdateItem],
+ );
+
const openMcpCreateSettings = React.useCallback(() => {
const baseName = 'new-mcp-server';
let newName = baseName;
@@ -361,70 +365,6 @@ const MobileShell: React.FC<{ onActiveConnectionDeleted: () => void }> = ({ onAc
openSettingsSurface('page-content');
}, [mcpServers, openSettingsSurface, setMcpDraft, setSelectedMcp, setSettingsPage]);
- const refreshMcpOverlay = React.useCallback(() => {
- if (isMcpRefreshing) return;
- setIsMcpRefreshing(true);
- const directory = currentDirectory || null;
- const minSpinPromise = new Promise((resolve) => window.setTimeout(resolve, 500));
- void Promise.all([
- refreshMcpStatus({ directory, silent: true }),
- loadMcpConfigs({ force: true }),
- minSpinPromise,
- ]).finally(() => setIsMcpRefreshing(false));
- }, [currentDirectory, isMcpRefreshing, loadMcpConfigs, refreshMcpStatus]);
-
- const overflowItems: OverflowItem[] = React.useMemo(
- () => {
- const items: OverflowItem[] = [];
- // Phones get Files/Changes/Terminal as workspace-drawer tabs; the iPad
- // exposes Files/Changes as header shortcuts and keeps Terminal here.
- if (isIPad) {
- items.push({
- key: 'terminal',
- icon: 'terminal',
- label: t('mobile.menu.terminal'),
- onSelect: () => openSurface('terminal'),
- });
- }
- items.push({
- key: 'mcp',
- iconNode: ,
- label: t('mobile.menu.mcp'),
- onSelect: () => openSurface('mcp'),
- });
- items.push({
- key: 'notes',
- icon: 'sticky-note',
- label: t('contextRail.surface.notes'),
- onSelect: () => openSurface('notes'),
- });
- if (showCapacitorOnlyFeatures) {
- items.push({
- key: 'instances',
- icon: 'server',
- label: t('mobile.menu.instances'),
- onSelect: () => openSurface('instances'),
- });
- }
- if (showUpdateItem) {
- items.push({
- key: 'update',
- icon: 'download',
- label: t('mobile.menu.update'),
- onSelect: () => openSurface('update'),
- });
- }
- items.push({
- key: 'settings',
- icon: 'settings-3',
- label: t('mobile.menu.settings'),
- onSelect: () => openSettingsSurface('nav'),
- });
- return items;
- },
- [isIPad, openSettingsSurface, openSurface, showCapacitorOnlyFeatures, showUpdateItem, t],
- );
-
return (
void }> = ({ onAc
{/* iPad: persistent full-height sessions sidebar; the chat column and
its header butt against it (iPadOS-style split layout). Always
mounted so open/close animates width, same as the desktop Sidebar. */}
- {isIPad ? (
+ {isTabletLayout ? (
) : null}
(isIPad ? toggleIpadSidebar() : setSessionsSheetOpen(true))}
- // Phones dropped the overflow menu: its items live in the sessions
- // drawer footer and the workspace tabs now. iPad keeps it until
- // the dedicated iPad layout pass.
- onOpenMenu={isIPad ? () => setOverflowOpen(true) : undefined}
- onOpenWorkspace={isIPad ? undefined : () => setWorkspaceOpen(true)}
- surfaceShortcuts={isIPad ? {
- activePanel: ipadRightPanel,
- changesDirty: dirtyChangeCount > 0,
- onToggleFiles: () => toggleIpadRightPanel('files'),
- onToggleChanges: () => toggleIpadRightPanel('changes'),
- } : undefined}
+ onOpenSessions={() => (isTabletLayout ? toggleSidebar() : setSessionsSheetOpen(true))}
+ onOpenWorkspace={() => setWorkspaceOpen(true)}
+ compactTitle={isTabletLayout}
/>
,
+ document.body,
+ );
+};
diff --git a/packages/ui/src/apps/MobileSessionMetadata.tsx b/packages/ui/src/apps/MobileSessionMetadata.tsx
index c2a42ac1..85a93ff5 100644
--- a/packages/ui/src/apps/MobileSessionMetadata.tsx
+++ b/packages/ui/src/apps/MobileSessionMetadata.tsx
@@ -4,8 +4,8 @@ import { Icon } from '@/components/icon/Icon';
import type { IconName } from '@/components/icon/icons';
import { ProviderLogo } from '@/components/ui/ProviderLogo';
import { preloadProviderLogos } from '@/hooks/useProviderLogo';
+import { useTabletLayout } from '@/lib/device';
import { useI18n } from '@/lib/i18n';
-import { isIPadApp } from '@/lib/platform';
import { clampPercent, formatQuotaResetLabel, formatQuotaValueLabel, formatWindowLabel, QUOTA_PROVIDERS, resolveUsageTone } from '@/lib/quota';
import { getDisplayModelName } from '@/lib/quota/model-families';
import { cn } from '@/lib/utils';
@@ -16,7 +16,7 @@ import { useUIStore, type TimeFormatPreference } from '@/stores/useUIStore';
import { useSelectionStore } from '@/sync/selection-store';
import { useSessionMessages } from '@/sync/sync-context';
-const IPAD_METADATA_POPOVER_WIDTH = 380;
+const TABLET_METADATA_POPOVER_WIDTH = 380;
const getNumericLimit = (limit: unknown, key: 'context' | 'output'): number | undefined => {
if (!limit || typeof limit !== 'object') return undefined;
@@ -139,18 +139,18 @@ const SessionMetadataOverlay: React.FC<{
const panelRef = React.useRef(null);
const [shouldRender, setShouldRender] = React.useState(open);
const [isExiting, setIsExiting] = React.useState(false);
- // iPad: a phone-width sheet stretched across the whole chat column looks
+ // Tablet: a phone-width sheet stretched across the whole chat column looks
// broken — render a popover anchored to the metadata button instead.
- const isIPad = React.useMemo(() => isIPadApp(), []);
+ const { enabled: isTabletLayout } = useTabletLayout();
const wrapperRef = React.useRef(null);
- const [ipadAnchorLeft, setIpadAnchorLeft] = React.useState(null);
+ const [anchorLeft, setIpadAnchorLeft] = React.useState(null);
// The shell has transformed ancestors, so the fixed wrapper's containing
// block is the chat column, NOT the viewport. Anchor the popover in the
// wrapper's own coordinate space — viewport-based lefts would double-count
// the sidebar offset.
React.useLayoutEffect(() => {
- if (!open || !isIPad || !shouldRender) return;
+ if (!open || !isTabletLayout || !shouldRender) return;
const compute = () => {
const anchorRect = anchorRef.current?.getBoundingClientRect();
const wrapperRect = wrapperRef.current?.getBoundingClientRect();
@@ -161,7 +161,7 @@ const SessionMetadataOverlay: React.FC<{
const relativeLeft = anchorRect.left - wrapperRect.left;
const left = Math.min(
Math.max(relativeLeft, 8),
- Math.max(8, wrapperRect.width - IPAD_METADATA_POPOVER_WIDTH - 8),
+ Math.max(8, wrapperRect.width - TABLET_METADATA_POPOVER_WIDTH - 8),
);
setIpadAnchorLeft(left);
};
@@ -173,9 +173,9 @@ const SessionMetadataOverlay: React.FC<{
const observer = new ResizeObserver(compute);
observer.observe(wrapper);
return () => observer.disconnect();
- }, [anchorRef, isIPad, open, shouldRender]);
+ }, [anchorRef, isTabletLayout, open, shouldRender]);
- const ipadPopover = isIPad && ipadAnchorLeft !== null;
+ const isPopover = isTabletLayout && anchorLeft !== null;
React.useEffect(() => {
if (open) {
@@ -233,17 +233,17 @@ const SessionMetadataOverlay: React.FC<{
aria-label={t('mobile.header.openMetadataAria')}
className={cn(
'overflow-y-auto overscroll-contain rounded-[20px] border border-border/70 bg-[var(--surface-elevated)] p-2 shadow-[0_12px_32px_rgb(0_0_0_/_0.2)] will-change-transform',
- ipadPopover ? 'absolute origin-top-left' : 'mx-3 mt-2',
+ isPopover ? 'absolute origin-top-left' : 'mx-3 mt-2',
isExiting ? 'pointer-events-none' : 'pointer-events-auto',
)}
style={{
animation: `${isExiting ? 'session-metadata-out' : 'session-metadata-in'} ${isExiting ? 140 : 170}ms cubic-bezier(0.32, 0.72, 0, 1) forwards`,
maxHeight: 'min(72dvh, calc(100dvh - var(--oc-safe-area-top, 0px) - var(--oc-header-height, 56px) - 1rem))',
- ...(ipadPopover
+ ...(isPopover
? {
top: 8,
- left: ipadAnchorLeft ?? 8,
- width: `min(${IPAD_METADATA_POPOVER_WIDTH}px, calc(100% - 16px))`,
+ left: anchorLeft ?? 8,
+ width: `min(${TABLET_METADATA_POPOVER_WIDTH}px, calc(100% - 16px))`,
}
: null),
}}
diff --git a/packages/ui/src/apps/MobileSessionSwitcher.tsx b/packages/ui/src/apps/MobileSessionSwitcher.tsx
index 7f13948c..4e2a44a8 100644
--- a/packages/ui/src/apps/MobileSessionSwitcher.tsx
+++ b/packages/ui/src/apps/MobileSessionSwitcher.tsx
@@ -4,6 +4,7 @@ import type { Session } from '@opencode-ai/sdk/v2';
import { Icon } from '@/components/icon/Icon';
import { formatSessionCompactDateLabel } from '@/components/session/sidebar/utils';
import { useSwitcherItems } from '@/components/session/sidebar/hooks/useSwitcherItems';
+import { useTabletLayout } from '@/lib/device';
import { useI18n } from '@/lib/i18n';
import { cn } from '@/lib/utils';
import { refreshGlobalSessions, resolveGlobalSessionDirectory } from '@/stores/useGlobalSessionsStore';
@@ -13,6 +14,8 @@ import { useSessionUIStore } from '@/sync/session-ui-store';
import { useGlobalSessionStatus } from '@/sync/sync-context';
const RECENT_SESSIONS_LIMIT = 10;
+/** Matches the metadata popover's width so both header dropdowns read as a pair. */
+const TABLET_POPOVER_WIDTH = 380;
const getSessionTitle = (session: Session, fallback: string): string =>
session.title?.trim() || fallback;
@@ -76,6 +79,42 @@ export const MobileSessionSwitcher: React.FC<{
const panelRef = React.useRef(null);
const [shouldRender, setShouldRender] = React.useState(open);
const [isExiting, setIsExiting] = React.useState(false);
+ // Tablet: a phone-width sheet stretched across the whole chat column looks
+ // broken — anchor a popover under the title instead. Mirror image of the
+ // metadata/usage popover, which anchors to the ring on the right.
+ const { enabled: isTabletLayout } = useTabletLayout();
+ const wrapperRef = React.useRef(null);
+ const [anchorLeft, setAnchorLeft] = React.useState(null);
+
+ // The shell has transformed ancestors, so the fixed wrapper's containing
+ // block is the chat column, NOT the viewport — anchor in the wrapper's own
+ // coordinate space (see SessionMetadataOverlay for the same reasoning).
+ React.useLayoutEffect(() => {
+ if (!open || !isTabletLayout || !shouldRender) return;
+ const compute = () => {
+ const anchorRect = anchorRef.current?.getBoundingClientRect();
+ const wrapperRect = wrapperRef.current?.getBoundingClientRect();
+ if (!anchorRect || !wrapperRect) {
+ setAnchorLeft(null);
+ return;
+ }
+ const relativeLeft = anchorRect.left - wrapperRect.left;
+ setAnchorLeft(Math.min(
+ Math.max(relativeLeft, 8),
+ Math.max(8, wrapperRect.width - TABLET_POPOVER_WIDTH - 8),
+ ));
+ };
+ compute();
+ // Re-anchor if the chat column shifts while the popover is open (sidebar
+ // toggle/resize, orientation change) — the header buttons move with it.
+ const wrapper = wrapperRef.current;
+ if (typeof ResizeObserver === 'undefined' || !wrapper) return;
+ const observer = new ResizeObserver(compute);
+ observer.observe(wrapper);
+ return () => observer.disconnect();
+ }, [anchorRef, isTabletLayout, open, shouldRender]);
+
+ const isPopover = isTabletLayout && anchorLeft !== null;
const currentSessionId = useSessionUIStore((state) => state.currentSessionId);
const setCurrentSession = useSessionUIStore((state) => state.setCurrentSession);
const setActiveProjectIdOnly = useProjectsStore((state) => state.setActiveProjectIdOnly);
@@ -132,18 +171,26 @@ export const MobileSessionSwitcher: React.FC<{
if (!shouldRender) return null;
return (
-
+
diff --git a/packages/ui/src/apps/MobileSessionsSheet.tsx b/packages/ui/src/apps/MobileSessionsSheet.tsx
index 30a5ce90..fb85e607 100644
--- a/packages/ui/src/apps/MobileSessionsSheet.tsx
+++ b/packages/ui/src/apps/MobileSessionsSheet.tsx
@@ -1437,8 +1437,11 @@ export const MobileSessionsSheet: React.FC = ({ open,
) : null;
+ // flex-1 + min-h-0 rather than h-full: both hosts put a fixed-height header
+ // above this, so a 100% height overflows by exactly that header — and the
+ // clipped overflow swallowed the footer.
const surfaceContent = (
-
+
{/* The search bar scrolls WITH the list (iOS-style): the open-time
auto-scroll to the current session naturally tucks it away, and
diff --git a/packages/ui/src/apps/MobileWorkspaceDrawer.tsx b/packages/ui/src/apps/MobileWorkspaceDrawer.tsx
index 3d8e6392..b3c94c24 100644
--- a/packages/ui/src/apps/MobileWorkspaceDrawer.tsx
+++ b/packages/ui/src/apps/MobileWorkspaceDrawer.tsx
@@ -85,10 +85,18 @@ const McpWorkspacePane: React.FC<{ onOpenMcpSettings: () => void }> = ({ onOpenM
);
};
-/** Full-width right drawer with the phone workspace surfaces as tabs
- (Changes / Files / Terminal / Notes / MCP). Slides in from the right edge;
- closes via the header X, Escape (unless the terminal tab owns the keys),
- or the Android back button (handled by MobileShell). */
+/** The workspace surfaces as tabs (Changes / Files / Terminal / Notes / MCP).
+
+ Two hosts, same content and same state:
+ - `drawer` (default) covers the app and slides in from the right edge —
+ the phone, and a tablet in portrait where a side panel would leave no
+ usable chat column;
+ - `panel` renders inline so the caller can size it as a real sidebar
+ beside the chat (tablet, landscape). The caller owns the width and the
+ open/close animation there; this component only fills it.
+
+ Closes via the header X, Escape (unless the terminal tab owns the keys), or
+ the Android back button (handled by MobileShell). */
export const MobileWorkspaceDrawer: React.FC<{
open: boolean;
onClose: () => void;
@@ -100,7 +108,8 @@ export const MobileWorkspaceDrawer: React.FC<{
onOpenPlan: (plan: { path: string; title: string }) => void;
/** MCP tab: jump to the MCP settings page pre-seeded with a new server draft. */
onOpenMcpSettings: () => void;
-}> = ({ open, onClose, tab, onTabChange, pendingChangesDiff, onOpenPlan, onOpenMcpSettings }) => {
+ variant?: 'drawer' | 'panel';
+}> = ({ open, onClose, tab, onTabChange, pendingChangesDiff, onOpenPlan, onOpenMcpSettings, variant = 'drawer' }) => {
const { t } = useI18n();
const rootRef = React.useRef(null);
const [entered, setEntered] = React.useState(false);
@@ -150,20 +159,22 @@ export const MobileWorkspaceDrawer: React.FC<{
React.useEffect(() => {
if (!open) return;
+ // Only the full-cover drawer owns the page scroll; the inline panel sits
+ // inside the shell and must leave the chat beside it scrollable.
const previousOverflow = document.body.style.overflow;
- document.body.style.overflow = 'hidden';
+ if (variant === 'drawer') document.body.style.overflow = 'hidden';
const handleKeyDown = (event: KeyboardEvent) => {
// The terminal owns Escape (it goes to the PTY) — don't hijack it.
if (event.key === 'Escape' && tabRef.current !== 'terminal') onCloseRef.current();
};
document.addEventListener('keydown', handleKeyDown);
return () => {
- document.body.style.overflow = previousOverflow;
+ if (variant === 'drawer') document.body.style.overflow = previousOverflow;
document.removeEventListener('keydown', handleKeyDown);
};
- }, [open]);
+ }, [open, variant]);
- if (!rootRef.current) return null;
+ if (variant === 'drawer' && !rootRef.current) return null;
const tabItems: SortableTabsStripItem[] = [
{ id: 'changes', label: t('mobile.menu.changes'), icon: },
@@ -173,23 +184,8 @@ export const MobileWorkspaceDrawer: React.FC<{
{ id: 'mcp', label: t('mobile.menu.mcp'), icon: },
];
- return createPortal(
-
+ const body = (
+ <>
{/* Mounted only while shown; nonCompositedIndicator keeps the active
@@ -268,7 +264,36 @@ export const MobileWorkspaceDrawer: React.FC<{
) : null}
+
+ );
+
+ if (variant === 'panel') {
+ // The caller animates the width; the content itself is plain flow so it
+ // never gets its own compositing layer (iOS clips those to the safe-area
+ // viewport, which is exactly what the drawer's settled `transform: none`
+ // avoids on the other host).
+ return
{body}
;
+ }
+
+ return createPortal(
+
+ {body}
,
- rootRef.current,
+ rootRef.current as HTMLElement,
);
};
diff --git a/packages/ui/src/apps/ipadSidebarResize.ts b/packages/ui/src/apps/ipadSidebarResize.ts
index 87463186..88a3a529 100644
--- a/packages/ui/src/apps/ipadSidebarResize.ts
+++ b/packages/ui/src/apps/ipadSidebarResize.ts
@@ -4,17 +4,25 @@ export const IPAD_LEFT_SIDEBAR_WIDTH = 320;
export const IPAD_RIGHT_SIDEBAR_WIDTH = 380;
const IPAD_SIDEBAR_MIN_WIDTH = 280;
const IPAD_SIDEBAR_MAX_WIDTH = 560;
+/** The workspace panel holds diffs, a file editor and a terminal, so it earns
+ far more room than the sessions list ever needs. */
+export const IPAD_WORKSPACE_SIDEBAR_MAX_WIDTH = 900;
/** Drag-resize for the iPad sidebars: same live-width mechanics as the desktop
Sidebar (imperative styles during the drag, committed to state at the end),
but with a finger-sized grab strip instead of a 3px hover handle. */
-export function useIpadSidebarResize(side: 'left' | 'right', storageKey: string, defaultWidth: number) {
+export function useIpadSidebarResize(
+ side: 'left' | 'right',
+ storageKey: string,
+ defaultWidth: number,
+ maxWidth: number = IPAD_SIDEBAR_MAX_WIDTH,
+) {
const asideRef = React.useRef(null);
const [width, setWidth] = React.useState(() => {
if (typeof window === 'undefined') return defaultWidth;
const stored = Number.parseInt(window.localStorage.getItem(storageKey) ?? '', 10);
if (!Number.isFinite(stored)) return defaultWidth;
- return Math.min(IPAD_SIDEBAR_MAX_WIDTH, Math.max(IPAD_SIDEBAR_MIN_WIDTH, stored));
+ return Math.min(maxWidth, Math.max(IPAD_SIDEBAR_MIN_WIDTH, stored));
});
const [isResizing, setIsResizing] = React.useState(false);
const startXRef = React.useRef(0);
@@ -23,8 +31,8 @@ export function useIpadSidebarResize(side: 'left' | 'right', storageKey: string,
const pointerIdRef = React.useRef(null);
const clampWidth = React.useCallback((value: number) => (
- Math.min(IPAD_SIDEBAR_MAX_WIDTH, Math.max(IPAD_SIDEBAR_MIN_WIDTH, Math.round(value)))
- ), []);
+ Math.min(maxWidth, Math.max(IPAD_SIDEBAR_MIN_WIDTH, Math.round(value)))
+ ), [maxWidth]);
const applyLiveWidth = React.useCallback((nextWidth: number) => {
const aside = asideRef.current;
diff --git a/packages/ui/src/apps/mobileNativeChrome.ts b/packages/ui/src/apps/mobileNativeChrome.ts
index 3c4eb92a..a26c6eb4 100644
--- a/packages/ui/src/apps/mobileNativeChrome.ts
+++ b/packages/ui/src/apps/mobileNativeChrome.ts
@@ -1,5 +1,7 @@
import React from 'react';
+import { observeNativeKeyboardHeight, resetHardwareKeyboardDetection, startHardwareKeyboardBridge } from '@/lib/hardwareKeyboard';
+
/** True when running inside the native Capacitor shell (iOS/Android app). */
export const isCapacitorMobileApp = (): boolean => {
if (typeof window === 'undefined') return false;
@@ -27,6 +29,10 @@ export const useNativeMobileChrome = (): void => {
root.classList.add('oc-platform-android');
}
+ // iOS reports hardware keyboards natively (GCKeyboard); adopting that
+ // answer switches the layout off its keyboard-event inference entirely.
+ cleanup.push(startHardwareKeyboardBridge());
+
const setInset = (px: number) => {
root.style.setProperty('--oc-keyboard-inset', `${Math.max(0, Math.round(px))}px`);
};
@@ -88,7 +94,8 @@ export const useNativeMobileChrome = (): void => {
// oc-keyboard-open drives CSS (draft starters, composer padding), and
// the settled event gives the chat its one deterministic re-pin after
// the native resize (the auto-follow idle gate ignores it otherwise).
- const willShowHandle = await Keyboard.addListener('keyboardWillShow', () => {
+ const willShowHandle = await Keyboard.addListener('keyboardWillShow', (info) => {
+ observeNativeKeyboardHeight(info.keyboardHeight);
root.classList.add('oc-keyboard-open');
// The composer already expanded on tap — re-pin the chat to it now,
// so the native resize that follows is the only remaining movement.
@@ -178,6 +185,7 @@ export const useNativeMobileChrome = (): void => {
const showHandle = await Keyboard.addListener('keyboardWillShow', (info) => {
clearSettle();
+ observeNativeKeyboardHeight(info.keyboardHeight);
keyboardOpen = true;
keyboardHeight = info.keyboardHeight;
if (!layoutApplied) {
@@ -330,6 +338,7 @@ export const useNativeMobileChrome = (): void => {
return () => {
disposed = true;
cleanup.forEach((remove) => remove());
+ resetHardwareKeyboardDetection();
root.classList.remove('oc-capacitor-app', 'oc-keyboard-open', 'oc-kb-animating', 'oc-kb-hide', 'oc-kb-caret-hold', 'oc-platform-android');
root.style.removeProperty('--oc-keyboard-inset');
root.style.removeProperty('--oc-kb-shift');
diff --git a/packages/ui/src/apps/mobileQrScan.test.ts b/packages/ui/src/apps/mobileQrScan.test.ts
index 927461fd..cba12b20 100644
--- a/packages/ui/src/apps/mobileQrScan.test.ts
+++ b/packages/ui/src/apps/mobileQrScan.test.ts
@@ -1,8 +1,8 @@
-import { describe, expect, test } from 'bun:test';
+import { afterEach, describe, expect, mock, test } from 'bun:test';
import { encodePairingConnectionPayload, buildPairingConnectionPayload } from '@/lib/connectionPayload';
-import { parseConnectionPayload } from './mobileQrScan';
+import { parseConnectionPayload, scanConnectionQr } from './mobileQrScan';
const hostEncPubJwk = { kty: 'EC', crv: 'P-256', x: 'eHhY', y: 'eVlZ' } as const;
@@ -40,3 +40,126 @@ describe('parseConnectionPayload', () => {
expect(parseConnectionPayload('openchamber://connect?v=1&mode=relay#offer=eyJ2IjoxfQ')).toBeNull();
});
});
+
+describe('scanConnectionQr on Android', () => {
+ const originalWindow = globalThis.window;
+
+ afterEach(() => {
+ Object.defineProperty(globalThis, 'window', { configurable: true, value: originalWindow });
+ });
+
+ test('uses the bundled startScan flow and cleans up after a result', async () => {
+ const listeners = new Map }) => void>();
+ let removeCalls = 0;
+ let stopCalls = 0;
+ let scanCalls = 0;
+ let startOptions: unknown;
+ const remove = () => { removeCalls += 1; };
+ const stopScan = async () => { stopCalls += 1; };
+ const scan = async () => { scanCalls += 1; return { barcodes: [] }; };
+ const startScan = async (options?: unknown) => {
+ startOptions = options;
+ listeners.get('barcodesScanned')?.({ barcodes: [{ rawValue: 'https://oc.example' }] });
+ };
+ const plugin = {
+ requestPermissions: mock(async () => ({ camera: 'granted' })),
+ scan,
+ startScan,
+ stopScan,
+ addListener: mock((event: string, callback: (info: { barcodes?: Array<{ rawValue?: string }> }) => void) => {
+ listeners.set(event, callback);
+ return Promise.resolve({ remove });
+ }),
+ };
+ Object.defineProperty(globalThis, 'window', {
+ configurable: true,
+ value: { Capacitor: { getPlatform: () => 'android', Plugins: { BarcodeScanner: plugin } } },
+ });
+
+ expect(await scanConnectionQr()).toEqual({ status: 'ok', url: 'https://oc.example' });
+ expect(startOptions).toEqual({ formats: ['QR_CODE'] });
+ expect(scanCalls).toBe(0);
+ expect(stopCalls).toBe(1);
+ expect(removeCalls).toBe(2);
+ });
+
+ test('stops scanning when the caller aborts', async () => {
+ let stopCalls = 0;
+ const stopScan = async () => { stopCalls += 1; };
+ const plugin = {
+ requestPermissions: mock(async () => ({ camera: 'granted' })),
+ startScan: mock(async () => undefined),
+ stopScan,
+ addListener: mock(async () => ({ remove: mock(() => undefined) })),
+ };
+ Object.defineProperty(globalThis, 'window', {
+ configurable: true,
+ value: { Capacitor: { getPlatform: () => 'android', Plugins: { BarcodeScanner: plugin } } },
+ });
+ const controller = new AbortController();
+ const result = scanConnectionQr({ signal: controller.signal });
+ await Promise.resolve();
+ controller.abort();
+
+ expect(await result).toEqual({ status: 'cancelled' });
+ expect(stopCalls).toBe(1);
+ });
+
+ test('waits for listener setup to finish before cleaning up an aborted scan', async () => {
+ let finishListenerSetup: (() => void) | undefined;
+ let removeCalls = 0;
+ let startCalls = 0;
+ let stopCalls = 0;
+ const listenerSetup = new Promise((resolve) => { finishListenerSetup = resolve; });
+ const remove = () => { removeCalls += 1; };
+ const startScan = async () => { startCalls += 1; };
+ const plugin = {
+ requestPermissions: mock(async () => ({ camera: 'granted' })),
+ startScan,
+ stopScan: async () => { stopCalls += 1; },
+ addListener: mock(async () => {
+ await listenerSetup;
+ return { remove };
+ }),
+ };
+ Object.defineProperty(globalThis, 'window', {
+ configurable: true,
+ value: { Capacitor: { getPlatform: () => 'android', Plugins: { BarcodeScanner: plugin } } },
+ });
+ const controller = new AbortController();
+ const result = scanConnectionQr({ signal: controller.signal });
+ await Promise.resolve();
+ controller.abort();
+ finishListenerSetup?.();
+
+ expect(await result).toEqual({ status: 'cancelled' });
+ expect(startCalls).toBe(0);
+ expect(removeCalls).toBe(2);
+ expect(stopCalls).toBe(1);
+ });
+
+ test('cleans up successful listener registration when the other listener fails', async () => {
+ let removeCalls = 0;
+ let startCalls = 0;
+ let stopCalls = 0;
+ const remove = () => { removeCalls += 1; };
+ const plugin = {
+ requestPermissions: mock(async () => ({ camera: 'granted' })),
+ startScan: async () => { startCalls += 1; },
+ stopScan: async () => { stopCalls += 1; },
+ addListener: mock(async (event: string) => {
+ if (event === 'scanError') throw new Error('listener setup failed');
+ return { remove };
+ }),
+ };
+ Object.defineProperty(globalThis, 'window', {
+ configurable: true,
+ value: { Capacitor: { getPlatform: () => 'android', Plugins: { BarcodeScanner: plugin } } },
+ });
+
+ expect(await scanConnectionQr()).toEqual({ status: 'failed' });
+ expect(startCalls).toBe(0);
+ expect(removeCalls).toBe(1);
+ expect(stopCalls).toBe(1);
+ });
+});
diff --git a/packages/ui/src/apps/mobileQrScan.ts b/packages/ui/src/apps/mobileQrScan.ts
index e4b12c3f..e1980e99 100644
--- a/packages/ui/src/apps/mobileQrScan.ts
+++ b/packages/ui/src/apps/mobileQrScan.ts
@@ -1,14 +1,8 @@
// Connection payload parsing + native QR scanning for the dedicated mobile app.
//
-// Pairing v2 links (openchamber://connect?v=2&p=) carry a one-time
-// secret and a list of transport candidates (lan / tunnel / relay); they are
-// redeemed server-side over whichever candidate connects first. We also accept a
-// bare http(s) URL so a QR encoding only the server address works.
-//
-// QR scanning is delegated to a Capacitor barcode-scanner plugin if the native
-// shell registered one (`window.Capacitor.Plugins.BarcodeScanner`). We resolve it
-// at runtime instead of importing the package so the web build stays dependency-free
-// and the browser-hosted mobile UI degrades to `unsupported` cleanly.
+// Android uses the plugin's CameraX-backed startScan() flow. Unlike its ready-made
+// scan() activity, this path bundles the barcode model in the app and does not need
+// Google Play Services. iOS keeps the native ready-made scanner.
import { parsePairingConnectionPayload, type PairingConnectionPayload } from '@/lib/connectionPayload';
@@ -32,74 +26,16 @@ export type QrScanResult =
| { status: 'failed' };
type ScannedBarcode = { rawValue?: string; displayValue?: string };
-
-type ModuleInstallProgress = { state?: number };
-type ListenerHandle = { remove: () => void };
-
+type ListenerHandle = { remove: () => void | Promise };
type BarcodeScannerPlugin = {
requestPermissions?: () => Promise<{ camera?: string } | undefined>;
scan?: (options?: { formats?: string[] }) => Promise<{ barcodes?: ScannedBarcode[] } | undefined>;
- // Android-only: the Google code scanner used by scan() needs the ML Kit barcode module,
- // which Play Services must download once before the first scan. Absent on iOS.
- isGoogleBarcodeScannerModuleAvailable?: () => Promise<{ available?: boolean } | undefined>;
- installGoogleBarcodeScannerModule?: () => Promise;
+ startScan?: (options?: { formats?: string[] }) => Promise;
+ stopScan?: () => Promise;
addListener?: (
- event: 'googleBarcodeScannerModuleInstallProgress',
- cb: (info: ModuleInstallProgress) => void,
- ) => Promise;
-};
-
-// Google's ModuleInstallProgress states: 4 = COMPLETED, 3 = CANCELED, 5 = FAILED.
-const MODULE_STATE_COMPLETED = 4;
-const MODULE_STATE_CANCELED = 3;
-const MODULE_STATE_FAILED = 5;
-const MODULE_INSTALL_TIMEOUT_MS = 90_000;
-
-// Ensure the Android Google barcode module is downloaded before scanning. No-op on platforms
-// where these methods don't exist (iOS) or when it's already available. Resolves once the module
-// is usable; rejects if the install is canceled, fails, or times out.
-const ensureScannerModule = async (plugin: BarcodeScannerPlugin): Promise => {
- const capacitor = (window as typeof window & { Capacitor?: { getPlatform?: () => string } }).Capacitor;
- if (
- capacitor?.getPlatform?.() !== 'android' ||
- !plugin.isGoogleBarcodeScannerModuleAvailable ||
- !plugin.installGoogleBarcodeScannerModule
- ) {
- return;
- }
- const status = await plugin.isGoogleBarcodeScannerModuleAvailable().catch(() => undefined);
- if (status?.available) return;
-
- await new Promise((resolve, reject) => {
- let handle: ListenerHandle | undefined;
- const finish = (fn: () => void) => {
- window.clearTimeout(timer);
- handle?.remove();
- fn();
- };
- const timer = window.setTimeout(
- () => finish(() => reject(new Error('module install timed out'))),
- MODULE_INSTALL_TIMEOUT_MS,
- );
- // addListener may return a handle synchronously OR a Promise depending on the
- // Capacitor proxy — normalize with Promise.resolve so a non-thenable handle doesn't throw
- // and abort the install call below.
- Promise.resolve(
- plugin.addListener?.('googleBarcodeScannerModuleInstallProgress', (info) => {
- if (info?.state === MODULE_STATE_COMPLETED) finish(resolve);
- else if (info?.state === MODULE_STATE_CANCELED || info?.state === MODULE_STATE_FAILED) {
- finish(() => reject(new Error('module install failed')));
- }
- }),
- )
- .then((h) => {
- handle = h as ListenerHandle | undefined;
- })
- .catch(() => undefined);
- Promise.resolve(plugin.installGoogleBarcodeScannerModule?.()).catch((error) =>
- finish(() => reject(error instanceof Error ? error : new Error('module install failed'))),
- );
- });
+ event: 'barcodesScanned' | 'scanError',
+ cb: (info: { barcodes?: ScannedBarcode[]; message?: string }) => void,
+ ) => Promise | ListenerHandle;
};
const getScannerPlugin = (): BarcodeScannerPlugin | null => {
@@ -108,7 +44,12 @@ const getScannerPlugin = (): BarcodeScannerPlugin | null => {
Capacitor?: { Plugins?: Record };
}).Capacitor;
const plugin = capacitor?.Plugins?.BarcodeScanner as BarcodeScannerPlugin | undefined;
- return plugin && typeof plugin.scan === 'function' ? plugin : null;
+ return plugin && (typeof plugin.scan === 'function' || typeof plugin.startScan === 'function') ? plugin : null;
+};
+
+const isAndroid = (): boolean => {
+ const capacitor = (window as typeof window & { Capacitor?: { getPlatform?: () => string } }).Capacitor;
+ return capacitor?.getPlatform?.() === 'android';
};
export const parseConnectionPayload = (raw: string): MobileConnectionPayload | MobilePairingPayload | null => {
@@ -124,54 +65,85 @@ export const parseConnectionPayload = (raw: string): MobileConnectionPayload | M
return null;
};
-// The Google code scanner can briefly still throw "module not available" in the moments right
-// after its install completes. Detect that specific error so we can re-ensure + retry rather
-// than surfacing a failure the user would have to manually tap through.
-const isModuleUnavailableError = (error: unknown): boolean => {
- const message =
- typeof error === 'object' && error && 'message' in error
- ? String((error as { message?: unknown }).message ?? '')
- : String(error ?? '');
- return /module/i.test(message) && /not\s*available|unavailable/i.test(message);
+const resultFromRawValue = (raw: string): QrScanResult => {
+ const payload = parseConnectionPayload(raw);
+ if (!payload) return { status: 'invalid' };
+ if ('pairing' in payload) return { status: 'pairing', ...payload };
+ return { status: 'ok', ...payload };
+};
+
+const scanWithBundledAndroidScanner = async (
+ plugin: BarcodeScannerPlugin,
+ signal?: AbortSignal,
+): Promise => {
+ if (!plugin.startScan || !plugin.stopScan || !plugin.addListener) return { status: 'unsupported' };
+ if (signal?.aborted) return { status: 'cancelled' };
+
+ let barcodeListener: ListenerHandle | undefined;
+ let errorListener: ListenerHandle | undefined;
+ let settled = false;
+ let resolveResult: (result: QrScanResult) => void = () => undefined;
+
+ const result = new Promise((resolve) => {
+ resolveResult = resolve;
+ });
+ const finish = (scanResult: QrScanResult) => {
+ if (settled) return;
+ settled = true;
+ resolveResult(scanResult);
+ };
+ const abort = () => finish({ status: 'cancelled' });
+ signal?.addEventListener('abort', abort, { once: true });
+
+ try {
+ const listenerResults = await Promise.allSettled([
+ Promise.resolve(plugin.addListener('barcodesScanned', ({ barcodes }) => {
+ const barcode = barcodes?.[0];
+ const raw = (barcode?.rawValue ?? barcode?.displayValue ?? '').trim();
+ if (raw) finish(resultFromRawValue(raw));
+ })).then((handle) => { barcodeListener = handle; }),
+ Promise.resolve(plugin.addListener('scanError', () => finish({ status: 'failed' })))
+ .then((handle) => { errorListener = handle; }),
+ ]);
+
+ if (listenerResults.some(({ status }) => status === 'rejected')) {
+ finish({ status: 'failed' });
+ } else if (!settled) {
+ void plugin.startScan({ formats: ['QR_CODE'] }).catch(() => finish({ status: 'failed' }));
+ }
+
+ return await result;
+ } finally {
+ signal?.removeEventListener('abort', abort);
+ await Promise.allSettled([
+ Promise.resolve(barcodeListener?.remove()),
+ Promise.resolve(errorListener?.remove()),
+ plugin.stopScan(),
+ ]);
+ }
};
export const isQrScanSupported = (): boolean => getScannerPlugin() !== null;
-export const scanConnectionQr = async (): Promise => {
+export const scanConnectionQr = async (options?: { signal?: AbortSignal }): Promise => {
const plugin = getScannerPlugin();
- if (!plugin?.scan) return { status: 'unsupported' };
+ if (!plugin) return { status: 'unsupported' };
try {
if (plugin.requestPermissions) {
const permission = await plugin.requestPermissions();
const camera = permission?.camera;
- if (camera && camera !== 'granted' && camera !== 'limited') {
- return { status: 'permission-denied' };
- }
+ if (camera && camera !== 'granted' && camera !== 'limited') return { status: 'permission-denied' };
}
- // First scan on Android downloads the Google barcode module (the button stays in its
- // scanning state for the whole wait). The module can still report "not available" for a
- // moment right after install, so re-ensure + retry within this same call instead of erroring
- // out — the user shouldn't have to guess to tap again.
- for (let attempt = 0; attempt < 3; attempt++) {
- try {
- await ensureScannerModule(plugin);
- const result = await plugin.scan({ formats: ['QR_CODE'] });
- const barcode = result?.barcodes?.[0];
- const raw = (barcode?.rawValue ?? barcode?.displayValue ?? '').trim();
- if (!raw) return { status: 'cancelled' };
+ if (options?.signal?.aborted) return { status: 'cancelled' };
+ if (isAndroid()) return scanWithBundledAndroidScanner(plugin, options?.signal);
+ if (!plugin.scan) return { status: 'unsupported' };
- const payload = parseConnectionPayload(raw);
- if (!payload) return { status: 'invalid' };
- if ('pairing' in payload) return { status: 'pairing', ...payload };
- return { status: 'ok', ...payload };
- } catch (error) {
- if (!isModuleUnavailableError(error) || attempt === 2) return { status: 'failed' };
- await new Promise((resolve) => window.setTimeout(resolve, 600));
- }
- }
- return { status: 'failed' };
+ const result = await plugin.scan({ formats: ['QR_CODE'] });
+ const barcode = result?.barcodes?.[0];
+ const raw = (barcode?.rawValue ?? barcode?.displayValue ?? '').trim();
+ return raw ? resultFromRawValue(raw) : { status: 'cancelled' };
} catch {
return { status: 'failed' };
}
diff --git a/packages/ui/src/apps/useEdgeSwipe.ts b/packages/ui/src/apps/useEdgeSwipe.ts
index 5247c00f..5aa1d5d8 100644
--- a/packages/ui/src/apps/useEdgeSwipe.ts
+++ b/packages/ui/src/apps/useEdgeSwipe.ts
@@ -15,6 +15,10 @@ import React from 'react';
*/
const EDGE_ZONE = 32; // px from a side where the swipe must begin
+// Android reserves the physical screen edge for system navigation. Accept a
+// wider start area so both OpenChamber drawers can be invoked beyond the
+// system Back gesture region without changing the browser/iOS gesture.
+const ANDROID_EDGE_ZONE = 80;
const MIN_DISTANCE = 64; // px of horizontal travel required to commit
const MAX_OFF_AXIS_RATIO = 0.7; // |dy| must stay below |dx| * this (keep it horizontal)
@@ -36,6 +40,8 @@ export const useEdgeSwipe = (
React.useEffect(() => {
const element = ref.current;
if (!element) return;
+ const platform = (window as typeof window & { Capacitor?: { getPlatform?: () => string } }).Capacitor?.getPlatform?.();
+ const edgeZone = platform === 'android' ? ANDROID_EDGE_ZONE : EDGE_ZONE;
let tracking = false;
let fromLeftEdge = false;
@@ -49,8 +55,8 @@ export const useEdgeSwipe = (
}
const touch = event.touches[0];
const width = element.clientWidth;
- const nearLeft = touch.clientX <= EDGE_ZONE;
- const nearRight = touch.clientX >= width - EDGE_ZONE;
+ const nearLeft = touch.clientX <= edgeZone;
+ const nearRight = touch.clientX >= width - edgeZone;
tracking = nearLeft || nearRight;
fromLeftEdge = nearLeft;
startX = touch.clientX;
diff --git a/packages/ui/src/components/chat/ChatInput.tsx b/packages/ui/src/components/chat/ChatInput.tsx
index b1cda99e..feda2c44 100644
--- a/packages/ui/src/components/chat/ChatInput.tsx
+++ b/packages/ui/src/components/chat/ChatInput.tsx
@@ -52,6 +52,8 @@ import { useCurrentSessionActivity } from '@/hooks/useSessionActivity';
import { toast } from '@/components/ui';
// useMessageStore removed — messages now come from sync system
import { isVSCodeRuntime } from '@/lib/desktop';
+import { useTabletLayout } from '@/lib/device';
+import { useHardwareKeyboard } from '@/lib/hardwareKeyboard';
import { isIMECompositionEvent } from '@/lib/ime';
import { getCycledPrimaryAgentName, type MobileControlsPanel } from './mobileControlsUtils';
import { MobileOverlayPanel } from '@/components/ui/MobileOverlayPanel';
@@ -349,6 +351,8 @@ const ChatInputComponent: React.FC = ({ onOpenSettings, scrollTo
const getVisibleAgents = useConfigStore((state) => state.getVisibleAgents);
const agents = getVisibleAgents();
const isMobile = useUIStore((state) => state.isMobile);
+ const hasHardwareKeyboard = useHardwareKeyboard();
+ const { enabled: isTabletLayout } = useTabletLayout();
const setImagePreviewOpen = useUIStore((state) => state.setImagePreviewOpen);
const inputBarOffset = useUIStore((state) => state.inputBarOffset);
const persistChatDraft = useUIStore((state) => state.persistChatDraft);
@@ -369,6 +373,7 @@ const ChatInputComponent: React.FC = ({ onOpenSettings, scrollTo
);
const ensureGitStatus = useGitStore((state) => state.ensureStatus);
const fetchGitStatus = useGitStore((state) => state.fetchStatus);
+ const clearGitDiffCache = useGitStore((state) => state.clearDiffCache);
const [showAbortStatus, setShowAbortStatus] = React.useState(false);
const setSessionAutoAccept = usePermissionStore((state) => state.setSessionAutoAccept);
const [isNarrowComposer, setIsNarrowComposer] = React.useState(false);
@@ -445,9 +450,12 @@ const ChatInputComponent: React.FC = ({ onOpenSettings, scrollTo
if (!currentDirectory || !runtimeGit) return;
return sessionEvents.onGitRefreshHint((hint) => {
if (normalizePath(hint.directory) !== normalizePath(currentDirectory)) return;
- void fetchGitStatus(currentDirectory, runtimeGit);
+ if (hint.paths?.length) {
+ clearGitDiffCache(currentDirectory, hint.paths);
+ }
+ void fetchGitStatus(currentDirectory, runtimeGit, { silent: true });
});
- }, [currentDirectory, runtimeGit, fetchGitStatus]);
+ }, [clearGitDiffCache, currentDirectory, runtimeGit, fetchGitStatus]);
const handleStartReviewFlow = React.useCallback(async (execution: ReviewFlowExecution) => {
if (!currentSessionId) return;
@@ -2233,6 +2241,10 @@ const ChatInputComponent: React.FC = ({ onOpenSettings, scrollTo
editorRef: composerRef,
formRef: composerFormRef,
setExpandedInput,
+ // The pill exists to buy screen back from the soft keyboard. A tablet
+ // has the room regardless, and with a hardware keyboard there is no
+ // soft keyboard to buy it back from — keep the real composer up.
+ alwaysExpanded: hasHardwareKeyboard || isTabletLayout,
holders: {
controlsPanelOpen: Boolean(mobileControlsPanel),
attachMenuOpen: mobileAttachMenuOpen,
diff --git a/packages/ui/src/components/chat/composer/language/__tests__/mentions.test.ts b/packages/ui/src/components/chat/composer/language/__tests__/mentions.test.ts
index effd1cd7..d36ee901 100644
--- a/packages/ui/src/components/chat/composer/language/__tests__/mentions.test.ts
+++ b/packages/ui/src/components/chat/composer/language/__tests__/mentions.test.ts
@@ -138,6 +138,11 @@ describe('classifyMention', () => {
expect(classifyMention('', classifier)).toBeNull();
});
+ test('HTML fragments do not classify as file references', () => {
+ expect(classifyMention('import', classifier)).toBeNull();
+ expect(classifyMention('src/ {
const shadowed = {
knownAgentNames: new Set(['a.ts']),
@@ -152,4 +157,3 @@ describe('classifyMention', () => {
expect(looksLikeFilePath('plain', new Set(['plain']))).toBe(true);
});
});
-
diff --git a/packages/ui/src/components/chat/composer/language/mentions.ts b/packages/ui/src/components/chat/composer/language/mentions.ts
index 7bedd7cc..ed79d68d 100644
--- a/packages/ui/src/components/chat/composer/language/mentions.ts
+++ b/packages/ui/src/components/chat/composer/language/mentions.ts
@@ -116,6 +116,9 @@ export function classifyMention(
classifier: MentionClassifier,
): MentionKind | null {
if (!name) return null;
+ // HTML fragments are prompt text, never references. In particular, do not
+ // interpret CSS syntax such as `@import` as a local file path.
+ if (name.includes('<') || name.includes('>')) return null;
if (classifier.knownAgentNames.has(name.toLowerCase())) return 'agent';
if (looksLikeFilePath(name, classifier.confirmedMentions)) return 'file';
return null;
diff --git a/packages/ui/src/components/chat/composer/state/useMobileComposerShell.ts b/packages/ui/src/components/chat/composer/state/useMobileComposerShell.ts
index 7f46bf66..32b15868 100644
--- a/packages/ui/src/components/chat/composer/state/useMobileComposerShell.ts
+++ b/packages/ui/src/components/chat/composer/state/useMobileComposerShell.ts
@@ -18,6 +18,7 @@
import React from 'react';
import { flushSync } from 'react-dom';
+import { observeEditorFocus } from '@/lib/hardwareKeyboard';
import { isCapacitorApp } from '@/lib/platform';
import type { ComposerEditorHandle } from '../editor/ComposerEditor';
@@ -41,6 +42,13 @@ export interface MobileComposerShellOptions {
formRef: React.RefObject;
setExpandedInput: (expanded: boolean) => void;
holders: MobileComposerHolders;
+ /**
+ * Keep the full composer up permanently and never fall back to the pill.
+ * The pill exists to buy screen back from the soft keyboard; with a
+ * hardware keyboard on a tablet there is no soft keyboard to hide from,
+ * and collapsing between keystrokes would only cost the user a tap.
+ */
+ alwaysExpanded?: boolean;
}
export interface MobileComposerShell {
@@ -65,9 +73,9 @@ export interface MobileComposerShell {
export function useMobileComposerShell(
options: MobileComposerShellOptions,
): MobileComposerShell {
- const { isMobile, editorRef, formRef, setExpandedInput, holders } = options;
+ const { isMobile, editorRef, formRef, setExpandedInput, holders, alwaysExpanded = false } = options;
- const [expanded, setExpanded] = React.useState(false);
+ const [expanded, setExpanded] = React.useState(alwaysExpanded && isMobile);
const [focused, setFocused] = React.useState(false);
const [overlayHostBusy, setOverlayHostBusy] = React.useState(false);
const [dictationActive, setDictationActive] = React.useState(false);
@@ -88,6 +96,16 @@ export function useMobileComposerShell(
expandedRef.current = expanded;
});
+ // A hardware keyboard can be attached (or detached) at any moment, so this
+ // is a live condition rather than a mount-time one. Detaching does NOT
+ // force a collapse — the normal idle/keyboard-hide paths take over again.
+ const alwaysExpandedRef = React.useRef(alwaysExpanded);
+ alwaysExpandedRef.current = alwaysExpanded;
+ React.useEffect(() => {
+ if (!isMobile || !alwaysExpanded) return;
+ setExpanded(true);
+ }, [alwaysExpanded, isMobile]);
+
// The draft screen restructures itself around the composer: its starter
// chips leave once the full composer is up, and its centered title
// re-centers over whatever room remains. Announced as a root class from a
@@ -95,12 +113,16 @@ export function useMobileComposerShell(
// swap — keyed on the keyboard instead (oc-keyboard-open arrives with the
// keyboardWillShow bridge event, ~100ms later), the chips vanished
// mid-rise as a second visible jump.
+ //
+ // Not announced while `alwaysExpanded`: there the full composer is the
+ // resting state, not a keyboard takeover, so claiming otherwise would hide
+ // the starters permanently. The keyboard classes still cover that case.
React.useLayoutEffect(() => {
if (!isMobile || typeof document === 'undefined') return;
const root = document.documentElement;
- root.classList.toggle('oc-composer-expanded', expanded);
+ root.classList.toggle('oc-composer-expanded', expanded && !alwaysExpanded);
return () => root.classList.remove('oc-composer-expanded');
- }, [expanded, isMobile]);
+ }, [alwaysExpanded, expanded, isMobile]);
const expand = React.useCallback(() => {
expandIntentRef.current = 'focus';
@@ -151,7 +173,7 @@ export function useMobileComposerShell(
// insert-and-send) collapse straight back to the pill rather than
// parking on the normal composer for the usual grace period.
window.setTimeout(() => {
- if (!expandedRef.current) return;
+ if (!expandedRef.current || alwaysExpandedRef.current) return;
if (editorRef.current?.isFocused()) return;
setExpanded(false);
setExpandedInput(false);
@@ -288,7 +310,7 @@ export function useMobileComposerShell(
|| holders.isDragging;
React.useEffect(() => {
- if (!isMobile || !expanded || busy) return;
+ if (!isMobile || !expanded || busy || alwaysExpanded) return;
const timer = window.setTimeout(() => {
// Authoritative DOM check: the React focus state can lag a
// programmatic refocus (the overlay-close restore above).
@@ -299,7 +321,7 @@ export function useMobileComposerShell(
setExpandedInput(false);
}, 250);
return () => window.clearTimeout(timer);
- }, [busy, editorRef, expanded, isMobile, setExpandedInput]);
+ }, [alwaysExpanded, busy, editorRef, expanded, isMobile, setExpandedInput]);
const busyRef = React.useRef(false);
busyRef.current = busy;
@@ -344,7 +366,7 @@ export function useMobileComposerShell(
const handleIntent = (event: Event) => {
const detail = (event as CustomEvent<{ open?: boolean }>).detail;
if (!detail || detail.open !== false) return;
- if (!expandedRef.current) return;
+ if (!expandedRef.current || alwaysExpandedRef.current) return;
// Something still holds the composer open (dictation, an overlay
// that closed the keyboard, a drag) — the fallback path handles it.
if (busyRef.current) return;
@@ -360,6 +382,9 @@ export function useMobileComposerShell(
const onEditorFocus = React.useCallback(() => {
if (!isMobile) return;
+ // Focus is the only moment a soft keyboard would be presented, so it is
+ // also the only moment its ABSENCE tells us a hardware one is attached.
+ if (isCapacitorApp()) observeEditorFocus();
if (blurTimerRef.current !== null) {
window.clearTimeout(blurTimerRef.current);
blurTimerRef.current = null;
diff --git a/packages/ui/src/components/chat/markdown/markdownCore.test.ts b/packages/ui/src/components/chat/markdown/markdownCore.test.ts
new file mode 100644
index 00000000..86db0bbd
--- /dev/null
+++ b/packages/ui/src/components/chat/markdown/markdownCore.test.ts
@@ -0,0 +1,18 @@
+import { describe, expect, test } from 'bun:test';
+
+import { escapeRawMarkdownHtml, MARKDOWN_FORBIDDEN_TAGS } from './markdownSecurity';
+
+describe('markdown sanitization', () => {
+ test('turns raw assistant HTML into inert visible text', () => {
+ const payload = '';
+
+ expect(escapeRawMarkdownHtml(payload)).toBe(
+ '<style>@import url("https://example.test/theme.css");</style>',
+ );
+ });
+
+ test('forbids script and stylesheet elements as active content', () => {
+ expect(MARKDOWN_FORBIDDEN_TAGS).toContain('script');
+ expect(MARKDOWN_FORBIDDEN_TAGS).toContain('style');
+ });
+});
diff --git a/packages/ui/src/components/chat/markdown/markdownCore.ts b/packages/ui/src/components/chat/markdown/markdownCore.ts
index 250fc1cd..ad906d99 100644
--- a/packages/ui/src/components/chat/markdown/markdownCore.ts
+++ b/packages/ui/src/components/chat/markdown/markdownCore.ts
@@ -5,6 +5,7 @@ import DOMPurify from 'dompurify';
import { buildAgentMentionUrl, parseAgentHref, parseSkillHref } from '@/lib/messages/inlineMessageLinks';
import { isVSCodeRuntime } from '@/lib/desktop';
import { highlightCodeInWorker } from './markdown-worker';
+import { escapeRawMarkdownHtml, MARKDOWN_FORBIDDEN_TAGS } from './markdownSecurity';
const escapeAttr = (value: string): string =>
value.replace(/&/g, '&').replace(/"/g, '"').replace(//g, '>');
@@ -166,6 +167,12 @@ const parser = marked.use({
breaks: false,
extensions: [inlineMathExtension, blockMathExtension],
renderer: {
+ // Assistant output is untrusted. Markdown constructs still render as HTML,
+ // but raw HTML must remain visible text so it cannot introduce active DOM
+ // such as stylesheets or positioned overlays into the application shell.
+ html({ text }) {
+ return escapeRawMarkdownHtml(text);
+ },
link({ href, title, text }) {
const target = href ?? '';
const agentName = parseAgentHref(target);
@@ -283,8 +290,10 @@ const SANITIZE_CONFIG = {
USE_PROFILES: { html: true, mathMl: true, svg: true },
ADD_TAGS: ['svg', 'path', 'g', 'rect', 'line', 'polygon', 'polyline', 'circle', 'ellipse', 'text', 'tspan', 'defs', 'marker'],
ADD_ATTR: ['d', 'viewBox', 'preserveAspectRatio', 'xmlns', 'target', 'fill', 'stroke', 'stroke-width', 'transform', 'points', 'x', 'y', 'x1', 'y1', 'x2', 'y2', 'cx', 'cy', 'r', 'rx', 'ry', 'style'],
- FORBID_TAGS: ['script'],
- FORBID_CONTENTS: ['script'],
+ // Defense in depth for generated/highlighter HTML after raw markdown HTML
+ // has been escaped by the marked renderer above.
+ FORBID_TAGS: [...MARKDOWN_FORBIDDEN_TAGS],
+ FORBID_CONTENTS: [...MARKDOWN_FORBIDDEN_TAGS],
};
let sanitizeHookInstalled = false;
diff --git a/packages/ui/src/components/chat/markdown/markdownSecurity.ts b/packages/ui/src/components/chat/markdown/markdownSecurity.ts
new file mode 100644
index 00000000..158ffa0b
--- /dev/null
+++ b/packages/ui/src/components/chat/markdown/markdownSecurity.ts
@@ -0,0 +1,6 @@
+/** Raw HTML in assistant markdown is untrusted and must stay inert text. */
+export const escapeRawMarkdownHtml = (value: string): string =>
+ value.replace(/&/g, '&').replace(/"/g, '"').replace(//g, '>');
+
+/** Active elements forbidden again at the final DOMPurify boundary. */
+export const MARKDOWN_FORBIDDEN_TAGS = ['script', 'style'] as const;
diff --git a/packages/ui/src/components/chat/message/MessageBody.tsx b/packages/ui/src/components/chat/message/MessageBody.tsx
index ee65064d..ae701111 100644
--- a/packages/ui/src/components/chat/message/MessageBody.tsx
+++ b/packages/ui/src/components/chat/message/MessageBody.tsx
@@ -34,7 +34,6 @@ import { copyTextToClipboard } from '@/lib/clipboard';
import { useChatSurfaceMode } from '@/components/chat/useChatSurfaceMode';
import { isVSCodeRuntime } from '@/lib/desktop';
import { useRuntimeAPIs } from '@/hooks/useRuntimeAPIs';
-import { toPng } from 'html-to-image';
import { toast } from '@/components/ui';
import { Icon } from "@/components/icon/Icon";
import { formatTimestampForDisplay } from './timeFormat';
@@ -1532,6 +1531,9 @@ const AssistantMessageBody = React.memo(({
let wrapper: HTMLDivElement | null = null;
try {
+ // Load the exporter before attaching its temporary clone so a slow
+ // chunk request cannot leave export-only content in the page layout.
+ const { toPng } = await import('html-to-image');
const originalElement = sourceElement;
const computedStyle = window.getComputedStyle(originalElement);
const rootStyle = window.getComputedStyle(document.documentElement);
diff --git a/packages/ui/src/components/chat/message/parts/ApplyPatchFileButtons.test.tsx b/packages/ui/src/components/chat/message/parts/ApplyPatchFileButtons.test.tsx
new file mode 100644
index 00000000..5dad5d58
--- /dev/null
+++ b/packages/ui/src/components/chat/message/parts/ApplyPatchFileButtons.test.tsx
@@ -0,0 +1,94 @@
+import { describe, expect, test } from 'bun:test';
+import React from 'react';
+import { renderToStaticMarkup } from 'react-dom/server';
+
+import type { EditorAPI } from '@/lib/api/types';
+
+import { ApplyPatchFileButtons } from './ApplyPatchFileButtons';
+import { openApplyPatchFileInEditor } from './applyPatchEditorAction';
+
+const makePatch = (path: string, line: number, before: string, after: string) => [
+ `--- a/${path}`,
+ `+++ b/${path}`,
+ `@@ -${line} +${line} @@`,
+ `-${before}`,
+ `+${after}`,
+].join('\n');
+
+const files = [
+ {
+ filePath: '/workspace/project/src/first.ts',
+ relativePath: 'src/first.ts',
+ patch: makePatch('src/first.ts', 4, 'first old', 'first new'),
+ additions: 1,
+ deletions: 1,
+ type: 'update',
+ },
+ {
+ filePath: '/workspace/project/src/second.ts',
+ relativePath: 'src/second.ts',
+ patch: makePatch('src/second.ts', 12, 'second old', 'second new'),
+ additions: 1,
+ deletions: 1,
+ type: 'update',
+ },
+];
+
+describe('ApplyPatchFileButtons', () => {
+ test('renders one labeled button per non-deleted file', () => {
+ const markup = renderToStaticMarkup(
+ undefined}
+ />,
+ );
+
+ expect(markup.match(/
diff --git a/packages/ui/src/components/session/DirectoryExplorerDialog.tsx b/packages/ui/src/components/session/DirectoryExplorerDialog.tsx
index e91d49fd..81d998a4 100644
--- a/packages/ui/src/components/session/DirectoryExplorerDialog.tsx
+++ b/packages/ui/src/components/session/DirectoryExplorerDialog.tsx
@@ -711,7 +711,9 @@ export const DirectoryExplorerDialog: React.FC = (
open={open}
onClose={handleClose}
title={t('directoryExplorerDialog.title')}
- className="h-[88dvh] max-h-[720px] max-w-full"
+ // Height only — the width stays on MobileOverlayPanel's shared max-w-lg
+ // so this sheet matches every other mobile overlay on wide screens.
+ className="h-[88dvh] max-h-[720px]"
contentMaxHeightClassName="flex-1"
footer={
{renderFooter()}
}
>
diff --git a/packages/ui/src/components/session/SessionDialogs.tsx b/packages/ui/src/components/session/SessionDialogs.tsx
index ce3128e7..daed832b 100644
--- a/packages/ui/src/components/session/SessionDialogs.tsx
+++ b/packages/ui/src/components/session/SessionDialogs.tsx
@@ -413,13 +413,7 @@ export const SessionDialogs: React.FC = () => {
const target = deleteDialog.sessions[0];
const success = isWorktreeDelete
? await archiveSession(target.id)
- : await deleteSession(target.id, {
- // In "worktree" mode, remove the selected worktree explicitly below.
- // Don't try to derive worktree removal from per-session metadata (may be missing).
- archiveWorktree: false,
- deleteRemoteBranch: removeRemoteBranch,
- deleteLocalBranch,
- });
+ : await deleteSession(target.id);
if (!success) {
toast.error(isWorktreeDelete
? t('sessions.sidebar.session.archive.error')
diff --git a/packages/ui/src/components/session/sidebar/SessionNodeItem.tsx b/packages/ui/src/components/session/sidebar/SessionNodeItem.tsx
index 904feb29..a518777f 100644
--- a/packages/ui/src/components/session/sidebar/SessionNodeItem.tsx
+++ b/packages/ui/src/components/session/sidebar/SessionNodeItem.tsx
@@ -1204,7 +1204,7 @@ function SessionNodeItemComponent(props: Props): React.ReactNode {
handleSessionDoubleClick(session.id, sessionTitle);
}}
className={cn(
- 'flex min-w-0 flex-1 cursor-pointer flex-col gap-0 overflow-hidden rounded-md text-left focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary/50 text-foreground select-none transition-[padding]',
+ 'flex min-w-0 flex-1 cursor-pointer flex-col gap-0 overflow-hidden text-left focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary/50 text-foreground select-none transition-[padding]',
isTouchPressed && 'bg-interactive-hover/70',
alwaysShowActions
? (isVSCode ? revealPaddingClass : alwaysActionPaddingClass)
diff --git a/packages/ui/src/components/ui/MobileOverlayPanel.tsx b/packages/ui/src/components/ui/MobileOverlayPanel.tsx
index 8151f2d9..c1d56392 100644
--- a/packages/ui/src/components/ui/MobileOverlayPanel.tsx
+++ b/packages/ui/src/components/ui/MobileOverlayPanel.tsx
@@ -119,6 +119,15 @@ export const MobileOverlayPanel: React.FC = ({
role="dialog"
aria-modal="true"
onClick={onClose}
+ // The panel centers over the CHAT column, not the whole app: on a tablet
+ // the shell keeps a persistent sessions sidebar, and a sheet centered on
+ // the window reads as belonging to nothing. The shell publishes the
+ // column's insets; on phones they are 0 and this is a no-op. The scrim
+ // deliberately still covers everything.
+ style={{
+ paddingLeft: 'var(--oc-chat-inset-left, 0px)',
+ paddingRight: 'var(--oc-chat-inset-right, 0px)',
+ }}
>
+ );
+};
diff --git a/packages/ui/src/components/views/walkthrough/WalkthroughHunkRun.tsx b/packages/ui/src/components/views/walkthrough/WalkthroughHunkRun.tsx
new file mode 100644
index 00000000..f26d9605
--- /dev/null
+++ b/packages/ui/src/components/views/walkthrough/WalkthroughHunkRun.tsx
@@ -0,0 +1,50 @@
+import { memo, useMemo } from 'react';
+import { PierreDiffViewer } from '@/components/views/PierreDiffViewer';
+import { fileDiffFromPatch } from '@/lib/diff/patchFileDiff';
+import { getLanguageFromExtension } from '@/lib/toolHelpers';
+import { mergeRunPatch } from '@/lib/walkthrough/model';
+import type { WalkthroughHunk } from '@/lib/walkthrough/types';
+
+interface WalkthroughHunkRunProps {
+ path: string;
+ hunks: WalkthroughHunk[];
+ renderSideBySide: boolean;
+ wrapLines: boolean;
+}
+
+/**
+ * One file's contribution to a stop. Consecutive hunks are merged back into a
+ * single patch so the reader sees continuous code rather than a stack of
+ * one-hunk cards.
+ *
+ * Inline comments are on: a review you cannot annotate is a reader, not a tool.
+ * They work here because the merged patch keeps the original `@@` headers, so
+ * the line numbers a comment captures are the file's real ones and not offsets
+ * into an excerpt.
+ */
+export const WalkthroughHunkRun = memo(function WalkthroughHunkRun({
+ path,
+ hunks,
+ renderSideBySide,
+ wrapLines,
+}: WalkthroughHunkRunProps) {
+ const fileDiff = useMemo(() => {
+ const patch = mergeRunPatch(hunks);
+ return patch ? fileDiffFromPatch(path, patch) : undefined;
+ }, [hunks, path]);
+
+ if (!fileDiff) return null;
+
+ return (
+
+ );
+});
diff --git a/packages/ui/src/components/views/walkthrough/WalkthroughStages.tsx b/packages/ui/src/components/views/walkthrough/WalkthroughStages.tsx
new file mode 100644
index 00000000..c601d278
--- /dev/null
+++ b/packages/ui/src/components/views/walkthrough/WalkthroughStages.tsx
@@ -0,0 +1,61 @@
+import { Icon } from '@/components/icon/Icon';
+import { useI18n } from '@/lib/i18n';
+import type { I18nKey } from '@/lib/i18n';
+import { cn } from '@/lib/utils';
+import type { WalkthroughStageProgress } from './useWalkthroughStageProgress';
+
+interface WalkthroughStagesProps {
+ progress: WalkthroughStageProgress;
+}
+
+/**
+ * The wait is long and uneven — collecting a pull request diff is seconds of
+ * network, the model call is minutes — and a lone spinner makes those look
+ * identical. Naming the phase says which one you are waiting on, and that the
+ * cost has been committed once it reads "waiting on the model".
+ *
+ * No durations: a stopwatch on a step nobody can hurry adds pressure, not
+ * information. And no mention of the schema fallback — from out here it is the
+ * same wait, and naming our plumbing only invites the question of what it is.
+ */
+const STAGES: Array<{ labelKey: I18nKey }> = [
+ { labelKey: 'walkthrough.stage.collecting' },
+ { labelKey: 'walkthrough.stage.asking' },
+ { labelKey: 'walkthrough.stage.assembling' },
+];
+
+export const WalkthroughStages = ({ progress }: WalkthroughStagesProps) => {
+ const { t } = useI18n();
+ const { completedCount, activeIndex } = progress;
+
+ return (
+
+ {/* Same height as the step badge, so a row with an importance pill is
+ exactly as tall as one without: vertical padding on a smaller type
+ size was pushing past the tallest element in the row. */}
+ {stop.importance !== 'normal' && (
+
+ {stop.importance === 'critical'
+ ? t('walkthrough.importance.critical')
+ : t('walkthrough.importance.context')}
+
+ )}
+
+ )}
+
+ );
+};
+
+/**
+ * Sticky so the file you are reading stays named while you scroll through its
+ * hunks — the path is the main orientation cue in a long stream, and as a plain
+ * caption it was easy to scroll straight past.
+ */
+const FileHeader = ({ path }: { path: string }) => (
+
+ ))}
+
+ );
+};
+
+/**
+ * Everything the walkthrough covers, plus everything it does not, in one
+ * continuous scroll: a stop's explanation sits directly above the code it
+ * explains.
+ */
+export const WalkthroughStream = memo(function WalkthroughStream({
+ view,
+ activeStopId,
+ scrollToStopId,
+ onActiveStopChange,
+ onScrollHandled,
+ renderSideBySide,
+ wrapLines,
+}: WalkthroughStreamProps) {
+ const { t } = useI18n();
+ const scrollRef = useRef(null);
+ const [uncoveredOpen, setUncoveredOpen] = useState(false);
+
+ // Set while a click-driven jump is in flight. Without it the observer reports
+ // every stop the viewport passes over on the way to the target and the
+ // highlight ends up on whichever one happened to be reported last — the
+ // sidebar showing step 5 while the stream shows step 6.
+ const navigatingRef = useRef(null);
+ const navigationTimerRef = useRef(null);
+
+ useEffect(() => () => {
+ if (navigationTimerRef.current !== null) window.clearTimeout(navigationTimerRef.current);
+ }, []);
+
+ // Scrolling is driven by the DOM rather than a virtualizer: only the visible
+ // stops mount their diff viewers, and each stop is its own element, so there
+ // is nothing to translate between index space and pixel space.
+ useEffect(() => {
+ if (!scrollToStopId) return;
+ const element = document.getElementById(stopElementId(scrollToStopId));
+ if (element) {
+ navigatingRef.current = scrollToStopId;
+ // Instant, not smooth: picking a step is a jump to a known destination,
+ // and a long animation only creates a window for the highlight to drift
+ // through everything in between.
+ element.scrollIntoView({ behavior: 'auto', block: 'start' });
+
+ // The observer fires asynchronously after the jump, and an element that
+ // was already in view may not fire at all — so the mute is released on a
+ // timer as well as on arrival.
+ if (navigationTimerRef.current !== null) window.clearTimeout(navigationTimerRef.current);
+ navigationTimerRef.current = window.setTimeout(() => {
+ navigatingRef.current = null;
+ navigationTimerRef.current = null;
+ }, 250);
+ }
+ onScrollHandled();
+ }, [scrollToStopId, onScrollHandled]);
+
+ const handleIntersection = useCallback(
+ (entries: IntersectionObserverEntry[]) => {
+ const visible = entries
+ .filter((entry) => entry.isIntersecting)
+ .sort((a, b) => a.boundingClientRect.top - b.boundingClientRect.top)[0];
+ if (!visible) return;
+ const stopId = visible.target.getAttribute('data-stop-id');
+ if (!stopId) return;
+
+ const navigatingTo = navigatingRef.current;
+ if (navigatingTo) {
+ // Arrived: hand control back to free scrolling.
+ if (stopId === navigatingTo) navigatingRef.current = null;
+ return;
+ }
+
+ onActiveStopChange(stopId);
+ },
+ [onActiveStopChange]
+ );
+
+ useEffect(() => {
+ const root = scrollRef.current;
+ if (!root) return;
+
+ const observer = new IntersectionObserver(handleIntersection, {
+ root,
+ // Only count a stop as active once its header reaches the upper band of
+ // the viewport, so scrolling through a long diff does not flicker the
+ // active step back and forth.
+ rootMargin: '0px 0px -70% 0px',
+ threshold: 0,
+ });
+
+ for (const stopView of view.stops) {
+ const element = document.getElementById(stopElementId(stopView.stop.id));
+ if (element) observer.observe(element);
+ }
+
+ return () => observer.disconnect();
+ }, [handleIntersection, view.stops]);
+
+ const uncoveredRuns = useMemo(() => groupHunksByFile(view.uncoveredHunks), [view.uncoveredHunks]);
+
+ return (
+
+ );
+};
+
+export const WalkthroughToc = memo(function WalkthroughToc({
+ view,
+ activeStopId,
+ visitedStopIds,
+ onSelectStop,
+ width,
+}: WalkthroughTocProps) {
+ const { t } = useI18n();
+ const activeRef = useRef(null);
+
+ // Scrolling the stream moves the active step, and past a certain point the
+ // highlighted row leaves the contents column entirely — the reader loses
+ // their place in the very thing meant to hold it. `nearest` keeps the move
+ // minimal, so clicking a row that is already visible does not jolt the list.
+ useEffect(() => {
+ activeRef.current?.scrollIntoView({ block: 'nearest' });
+ }, [activeStopId]);
+
+ return (
+
+ );
+});
diff --git a/packages/ui/src/components/views/walkthrough/WalkthroughView.tsx b/packages/ui/src/components/views/walkthrough/WalkthroughView.tsx
new file mode 100644
index 00000000..c0403b75
--- /dev/null
+++ b/packages/ui/src/components/views/walkthrough/WalkthroughView.tsx
@@ -0,0 +1,761 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { Icon } from '@/components/icon/Icon';
+import { Button } from '@/components/ui/button';
+import {
+ DropdownMenu,
+ DropdownMenuContent,
+ DropdownMenuLabel,
+ DropdownMenuRadioGroup,
+ DropdownMenuRadioItem,
+ DropdownMenuSeparator,
+ DropdownMenuTrigger,
+} from '@/components/ui/dropdown-menu';
+import { useI18n, type Locale } from '@/lib/i18n';
+import { buildWalkthroughView } from '@/lib/walkthrough/model';
+import type { WalkthroughSource, WalkthroughWorkingTreeScope } from '@/lib/walkthrough/types';
+import { ModelSelector } from '@/components/sections/agents/ModelSelector';
+import { deriveBaseBranch } from '@/components/views/git/baseBranch';
+import { runtimeFetch } from '@/lib/runtime-fetch';
+import { useConfigStore } from '@/stores/useConfigStore';
+import { useGitBranches, useGitStatus } from '@/stores/useGitStore';
+import { useGitHubAuthStore } from '@/stores/useGitHubAuthStore';
+import {
+ getFreshestPrStatusForBranch,
+ getGitHubPrStatusKey,
+ useGitHubPrStatusStore,
+} from '@/stores/useGitHubPrStatusStore';
+import { useRuntimeAPIs } from '@/hooks/useRuntimeAPIs';
+import { useUIStore } from '@/stores/useUIStore';
+import { useWalkthroughStore } from '@/stores/useWalkthroughStore';
+import { cn } from '@/lib/utils';
+import { WalkthroughBlocker } from './WalkthroughBlocker';
+import { WALKTHROUGH_ACTION_CLASS } from './walkthroughAction';
+import { WalkthroughStages } from './WalkthroughStages';
+import { useWalkthroughStageProgress } from './useWalkthroughStageProgress';
+import { WalkthroughStream } from './WalkthroughStream';
+import { WalkthroughToc } from './WalkthroughToc';
+
+interface WalkthroughViewProps {
+ directory: string;
+}
+
+const SCOPES: WalkthroughWorkingTreeScope[] = ['all', 'staged', 'working'];
+
+// DropdownMenuLabel defaults to the same size and weight as its items, which
+// makes a heading read as another choice. This matches SelectLabel, the
+// treatment used by the worktree picker.
+const SCOPE_GROUP_LABEL_CLASS = 'typography-meta font-normal text-muted-foreground';
+
+// Below this the table of contents would squeeze the diff into uselessness, so
+// the stream takes the whole panel and the header arrows carry navigation.
+const TOC_MIN_PANEL_WIDTH = 720;
+const TOC_MIN_WIDTH = 180;
+// The diff is the point of the surface; the contents column may never take more
+// than half the panel no matter how far the user drags.
+const TOC_MAX_FRACTION = 0.5;
+
+// Below this the header controls wrap onto a second row and the labels squeeze
+// to two letters and an ellipsis, which reads as broken rather than dense. The
+// controls drop their text instead: every one of them carries an icon that
+// already identifies it.
+//
+// Every control in this row is 32px tall — `Button` size `sm` and the dropdown
+// trigger's `default` size are both h-8, so this is the design system's form
+// scale rather than a number picked here. Three heights in one row (28px
+// pickers, 32px action, 36px arrows) read as misalignment, not hierarchy.
+const HEADER_COMPACT_WIDTH = 680;
+
+export const WalkthroughView = ({ directory }: WalkthroughViewProps) => {
+ const { t, locale, locales, label } = useI18n();
+ const rootRef = useRef(null);
+ const [panelWidth, setPanelWidth] = useState(0);
+
+ // Panel width, not viewport width: this surface is resizable independently of
+ // the window.
+ useEffect(() => {
+ const element = rootRef.current;
+ if (!element || typeof ResizeObserver === 'undefined') return;
+ const observer = new ResizeObserver((entries) => {
+ setPanelWidth(entries[0]?.contentRect.width ?? 0);
+ });
+ observer.observe(element);
+ return () => observer.disconnect();
+ }, []);
+
+ const storedTocWidth = useUIStore((state) => state.walkthroughTocWidth);
+ const setStoredTocWidth = useUIStore((state) => state.setWalkthroughTocWidth);
+ const [draggingToc, setDraggingToc] = useState(false);
+
+ const showToc = panelWidth === 0 || panelWidth >= TOC_MIN_PANEL_WIDTH;
+ // Zero means the observer has not reported yet; assume there is room rather
+ // than rendering a compact header for one frame on every open.
+ const compactHeader = panelWidth > 0 && panelWidth < HEADER_COMPACT_WIDTH;
+ // Clamped on read rather than on write: the panel can be resized after the
+ // width was stored, and a remembered 400px column must not swallow a narrow
+ // panel.
+ const tocWidth = Math.min(
+ Math.max(storedTocWidth, TOC_MIN_WIDTH),
+ Math.max(TOC_MIN_WIDTH, (panelWidth || TOC_MIN_PANEL_WIDTH) * TOC_MAX_FRACTION)
+ );
+
+ const handleTocResizeStart = useCallback(
+ (event: React.PointerEvent) => {
+ event.preventDefault();
+ const startX = event.clientX;
+ const startWidth = tocWidth;
+ const maxWidth = Math.max(TOC_MIN_WIDTH, (rootRef.current?.clientWidth ?? 0) * TOC_MAX_FRACTION);
+ setDraggingToc(true);
+
+ const onMove = (moveEvent: PointerEvent) => {
+ const next = Math.min(maxWidth, Math.max(TOC_MIN_WIDTH, startWidth + moveEvent.clientX - startX));
+ setStoredTocWidth(next);
+ };
+ const onUp = () => {
+ setDraggingToc(false);
+ window.removeEventListener('pointermove', onMove);
+ window.removeEventListener('pointerup', onUp);
+ window.removeEventListener('pointercancel', onUp);
+ };
+
+ window.addEventListener('pointermove', onMove);
+ window.addEventListener('pointerup', onUp);
+ window.addEventListener('pointercancel', onUp);
+ },
+ [setStoredTocWidth, tocWidth]
+ );
+
+ const handleTocResizeKey = useCallback(
+ (event: React.KeyboardEvent) => {
+ const step = event.shiftKey ? 40 : 10;
+ const delta = event.key === 'ArrowLeft' ? -step : event.key === 'ArrowRight' ? step : 0;
+ if (delta === 0) return;
+ event.preventDefault();
+ const maxWidth = Math.max(TOC_MIN_WIDTH, (rootRef.current?.clientWidth ?? 0) * TOC_MAX_FRACTION);
+ setStoredTocWidth(Math.min(maxWidth, Math.max(TOC_MIN_WIDTH, tocWidth + delta)));
+ },
+ [setStoredTocWidth, tocWidth]
+ );
+ const [scope, setScope] = useState('all');
+ const [activeStopId, setActiveStopId] = useState(null);
+ const [scrollToStopId, setScrollToStopId] = useState(null);
+ const [visitedStopIds, setVisitedStopIds] = useState>(() => new Set());
+
+ const diffLayoutPreference = useUIStore((state) => state.diffLayoutPreference);
+ const wrapLines = useUIStore((state) => state.diffWrapLines);
+ // The walkthrough column is narrower than the diff surface and stops are read
+ // top-to-bottom, so `dynamic` resolves to inline here rather than guessing
+ // from the window width.
+ const renderSideBySide = diffLayoutPreference === 'side-by-side';
+
+ const requestedSource = useWalkthroughStore((state) => state.requestedSource[directory]);
+ const clearRequestedSource = useWalkthroughStore((state) => state.clearRequestedSource);
+
+ const status = useGitStatus(directory || null);
+ const branches = useGitBranches(directory || null);
+
+ // The branch source reviews everything on this branch that is not on its
+ // base. Three-dot semantics server-side mean merges from the base are
+ // already excluded.
+ const currentBranch = status?.current ?? null;
+ const branchSource = useMemo(() => {
+ const headRef = currentBranch;
+ if (!headRef) return null;
+ const all = branches?.all ?? [];
+ const localBranches = all.filter((name) => !name.startsWith('remotes/'));
+ const remoteNames = new Set(
+ all
+ .filter((name) => name.startsWith('remotes/'))
+ .map((name) => name.slice('remotes/'.length).split('/')[0])
+ .filter(Boolean)
+ );
+ const baseRef = deriveBaseBranch({ remoteNames, localBranches });
+ if (!baseRef || baseRef === headRef) return null;
+ return { kind: 'branch', baseRef, headRef };
+ }, [branches, currentBranch]);
+
+ // The pull request for this branch used to appear only after visiting the PR
+ // panel, because nothing else asked GitHub about it. Ask here too: the status
+ // store already dedupes by signature and throttles by TTL, so several panels
+ // wanting the same answer produce one request.
+ const { github } = useRuntimeAPIs();
+ const githubConnected = useGitHubAuthStore((state) => state.status?.connected ?? false);
+ const githubAuthChecked = useGitHubAuthStore((state) => state.hasChecked);
+ const ensurePrStatusEntry = useGitHubPrStatusStore((state) => state.ensureEntry);
+ const setPrStatusParams = useGitHubPrStatusStore((state) => state.setParams);
+ const refreshPrStatusTargets = useGitHubPrStatusStore((state) => state.refreshTargets);
+
+ useEffect(() => {
+ if (!directory || !currentBranch || !githubAuthChecked || !githubConnected) return;
+ const key = getGitHubPrStatusKey(directory, currentBranch);
+ ensurePrStatusEntry(key);
+ setPrStatusParams(key, {
+ directory,
+ branch: currentBranch,
+ remoteName: null,
+ canShow: true,
+ github,
+ githubAuthChecked,
+ githubConnected,
+ });
+ void refreshPrStatusTargets([{ directory, branch: currentBranch, remoteName: null }]);
+ }, [
+ currentBranch,
+ directory,
+ ensurePrStatusEntry,
+ github,
+ githubAuthChecked,
+ githubConnected,
+ refreshPrStatusTargets,
+ setPrStatusParams,
+ ]);
+
+ // Selecting the number rather than the entry map: a primitive keeps this
+ // panel out of every unrelated PR status update.
+ const branchPrNumber = useGitHubPrStatusStore((state) => (
+ directory && currentBranch
+ ? getFreshestPrStatusForBranch(state.entries, directory, currentBranch)?.pr?.number ?? null
+ : null
+ ));
+
+ const source = useMemo(
+ () => requestedSource ?? { kind: 'working-tree', scope },
+ [requestedSource, scope]
+ );
+
+ // Offer whichever pull request we know about: the one already selected, or
+ // the one this branch has.
+ const prSource = useMemo | null>(() => {
+ if (source.kind === 'pr') return source;
+ return branchPrNumber ? { kind: 'pr', number: branchPrNumber } : null;
+ }, [branchPrNumber, source]);
+
+ const selectWorkingTree = useCallback(
+ (value: WalkthroughWorkingTreeScope) => {
+ clearRequestedSource(directory);
+ setScope(value);
+ },
+ [clearRequestedSource, directory]
+ );
+ const entry = useWalkthroughStore((state) => state.getEntry(directory, source));
+ const load = useWalkthroughStore((state) => state.load);
+ const generate = useWalkthroughStore((state) => state.generate);
+ const cancel = useWalkthroughStore((state) => state.cancel);
+ const requestSource = useWalkthroughStore((state) => state.requestSource);
+ const selectModel = useWalkthroughStore((state) => state.selectModel);
+ const selectedModel = useWalkthroughStore((state) => state.getSelectedModel(directory, source));
+ const selectLanguage = useWalkthroughStore((state) => state.selectLanguage);
+ const selectedLanguage = useWalkthroughStore((state) => state.getSelectedLanguage(directory, source));
+
+ // Explicit pick first, then the language the walkthrough on screen is
+ // actually written in, then the interface locale. The middle step matters for
+ // the same reason it does for the model: reopening a review should describe
+ // what is there, not what a fresh one would be.
+ const generatedLanguage = entry.result?.language;
+ const activeLanguage: Locale = (
+ selectedLanguage && locales.includes(selectedLanguage as Locale)
+ ? (selectedLanguage as Locale)
+ : generatedLanguage && locales.includes(generatedLanguage as Locale)
+ ? (generatedLanguage as Locale)
+ : locale
+ );
+
+ // Reloads on a model or language change: whether this diff fits, and whether
+ // the model can produce structured output, are answers about a specific
+ // request — and the language instruction is part of that request.
+ useEffect(() => {
+ void load(directory, source, { language: activeLanguage });
+ }, [activeLanguage, directory, load, source, selectedModel]);
+
+ const view = useMemo(() => buildWalkthroughView(entry.result), [entry.result]);
+
+ // A new walkthrough is a new reading path: keeping the old progress would
+ // mark stops as visited that the user has never seen.
+ const generatedAt = entry.result?.generatedAt;
+ const lastGeneratedAt = useRef(undefined);
+ useEffect(() => {
+ if (lastGeneratedAt.current === generatedAt) return;
+ lastGeneratedAt.current = generatedAt;
+ setVisitedStopIds(new Set());
+ setActiveStopId(view?.stops[0]?.stop.id ?? null);
+ }, [generatedAt, view]);
+
+ const handleActiveStopChange = useCallback((stopId: string) => {
+ setActiveStopId(stopId);
+ setVisitedStopIds((visited) => {
+ if (visited.has(stopId)) return visited;
+ const next = new Set(visited);
+ next.add(stopId);
+ return next;
+ });
+ }, []);
+
+ const handleSelectStop = useCallback(
+ (stopId: string) => {
+ handleActiveStopChange(stopId);
+ setScrollToStopId(stopId);
+ },
+ [handleActiveStopChange]
+ );
+
+ const step = useCallback(
+ (delta: number) => {
+ if (!view || view.stops.length === 0) return;
+ const currentIndex = view.stops.findIndex((stop) => stop.stop.id === activeStopId);
+ const nextIndex = Math.min(view.stops.length - 1, Math.max(0, (currentIndex < 0 ? 0 : currentIndex) + delta));
+ handleSelectStop(view.stops[nextIndex].stop.id);
+ },
+ [activeStopId, handleSelectStop, view]
+ );
+
+ const [sourceMenuOpen, setSourceMenuOpen] = useState(false);
+ const [languageMenuOpen, setLanguageMenuOpen] = useState(false);
+ const sourceValue = source.kind === 'working-tree' ? source.scope : source.kind;
+ const sourceLabel = source.kind === 'branch'
+ ? t('walkthrough.scope.branch')
+ : source.kind === 'pr'
+ ? t('walkthrough.scope.pullRequest', { number: source.number })
+ : scope === 'all'
+ ? t('walkthrough.scope.all')
+ : scope === 'staged'
+ ? t('walkthrough.scope.staged')
+ : t('walkthrough.scope.working');
+
+ // Explicit pick first, then the model that actually produced what is on
+ // screen, then whatever settings resolve to. The middle step is what makes
+ // reopening a review show the model behind it rather than the default.
+ const activeModel = selectedModel
+ ?? (entry.result?.model ? `${entry.result.model.providerID}/${entry.result.model.modelID}` : undefined)
+ ?? (entry.readiness?.model ? `${entry.readiness.model.providerID}/${entry.readiness.model.modelID}` : undefined);
+ const [activeProviderId, ...activeModelParts] = (activeModel ?? '').split('/');
+ const activeModelId = activeModelParts.join('/');
+
+ const modelsMetadata = useConfigStore((state) => state.modelsMetadata);
+ const [modelProviders, setModelProviders] = useState(undefined);
+
+ useEffect(() => {
+ if (modelProviders !== undefined) return;
+ let cancelled = false;
+ (async () => {
+ try {
+ const response = await runtimeFetch('/api/small-model', {
+ method: 'GET',
+ headers: { Accept: 'application/json' },
+ });
+ if (!response.ok) return;
+ const payload = (await response.json().catch(() => null)) as { authenticatedProviders?: unknown } | null;
+ if (!cancelled && Array.isArray(payload?.authenticatedProviders)) {
+ setModelProviders(payload.authenticatedProviders.filter((id): id is string => typeof id === 'string'));
+ }
+ } catch {
+ // Leave undefined: the picker then offers every provider, which is
+ // worse but not broken.
+ }
+ })();
+ return () => {
+ cancelled = true;
+ };
+ }, [modelProviders]);
+
+ const isStructuredOutputCapable = useCallback(
+ (providerId: string, modelId: string) =>
+ modelsMetadata.get(`${providerId}/${modelId}`)?.structured_output !== false,
+ [modelsMetadata]
+ );
+
+ // Only generation is worth interrupting. A read is a few hundred milliseconds
+ // of git with nothing to cancel, and offering a Cancel button for it made the
+ // action flicker every time the model or language changed.
+ const isGeneratingEntry = entry.status === 'generating';
+
+ // What is on screen versus what is being asked for. A read that has settled
+ // is the only thing that can answer this: while one is in flight the panel is
+ // still showing the previous answer, and a banner claiming something is
+ // missing before we know would be the same flicker in another place.
+ const shownModel = entry.result?.model
+ ? `${entry.result.model.providerID}/${entry.result.model.modelID}`
+ : undefined;
+ const shownLanguage = entry.result?.language;
+ const shownLocale = shownLanguage && locales.includes(shownLanguage as Locale)
+ ? (shownLanguage as Locale)
+ : undefined;
+ const settled = entry.status === 'ready' && Boolean(view);
+ // An entry written before walkthroughs had a language carries none. Unknown
+ // is not the same as different, so it is not reported as missing.
+ const languageMissing = settled && Boolean(shownLocale) && shownLocale !== activeLanguage;
+ const modelMissing = settled && Boolean(shownModel) && Boolean(activeModel) && shownModel !== activeModel;
+
+ // The stage list outlives the work by a beat. Assembling takes milliseconds,
+ // so without this the result replaces the list before the last step is ever
+ // seen finishing — the user is told about a step they never observe.
+ const stageProgress = useWalkthroughStageProgress(entry.stage, entry.status === 'generating');
+
+ // Only a generation that started from an empty panel gets held: regenerating
+ // over an existing walkthrough keeps the stream on screen with a banner, and
+ // hiding readable content to show a progress list would be a downgrade.
+ const startedFromEmptyRef = useRef(false);
+ const previousStatusRef = useRef(entry.status);
+ useEffect(() => {
+ if (previousStatusRef.current !== 'generating' && entry.status === 'generating') {
+ startedFromEmptyRef.current = !view;
+ }
+ previousStatusRef.current = entry.status;
+ }, [entry.status, view]);
+
+ const showStages = startedFromEmptyRef.current
+ && (entry.status === 'generating' || stageProgress.holding);
+ const blockedReason = entry.error?.code === 'context-too-small'
+ || entry.error?.code === 'structured-output-unsupported'
+ || entry.error?.code === 'no-model'
+ || entry.error?.code === 'empty-diff'
+ || entry.error?.code === 'only-generated'
+ || entry.error?.code === 'output-exhausted'
+ ? entry.error.code
+ : entry.readiness && !entry.readiness.ready && !view
+ ? entry.readiness.reason
+ : undefined;
+
+ // Both sources carry the model that was tried; the error is the more specific
+ // one when generation actually ran.
+ const blockedModel = entry.error?.model ?? entry.readiness?.model;
+ const blockedRequiredChars = entry.error?.requiredChars ?? entry.readiness?.requiredChars;
+ const blockedAvailableChars = entry.error?.availableChars ?? entry.readiness?.availableChars;
+
+ const handleGenerate = useCallback(
+ (force: boolean) => {
+ void generate(directory, source, { force, language: activeLanguage });
+ },
+ [activeLanguage, directory, generate, source]
+ );
+
+ return (
+
+
+
+
+
+
+
+ {
+ setSourceMenuOpen(false);
+ if (value === 'branch') {
+ if (branchSource) requestSource(directory, branchSource);
+ return;
+ }
+ if (value === 'pr') {
+ if (prSource) requestSource(directory, prSource);
+ return;
+ }
+ selectWorkingTree(value as WalkthroughWorkingTreeScope);
+ }}
+ >
+ {/* Grouped so "everything" is visibly scoped to uncommitted work:
+ on its own next to "This branch" it read as "all changes that
+ exist", which is the opposite of what it selects. */}
+
+ {t('walkthrough.scope.group.workingTree')}
+
+ {SCOPES.map((value) => (
+
+ {value === 'all'
+ ? t('walkthrough.scope.all')
+ : value === 'staged'
+ ? t('walkthrough.scope.staged')
+ : t('walkthrough.scope.working')}
+
+ ))}
+ {(branchSource || prSource) && (
+ <>
+
+
+ {t('walkthrough.scope.group.committed')}
+
+
+ )}
+ {branchSource && (
+
+ {t('walkthrough.scope.branch')}
+
+ )}
+ {prSource && (
+
+ {t('walkthrough.scope.pullRequest', { number: prSource.number })}
+
+ )}
+
+
+
+
+
+ {/* A walkthrough nobody can read is worth nothing, so the prose
+ language is a per-review choice like the model — defaulting to the
+ interface language, which is the best evidence of what the reader
+ reads. */}
+
+
+
+
+
+
+ {t('walkthrough.language.menuLabel')}
+
+ {
+ setLanguageMenuOpen(false);
+ selectLanguage(directory, source, value);
+ }}
+ >
+ {locales.map((value) => (
+
+ {label(value)}
+
+ ))}
+
+
+
+
+ {/* Choosing a roomier model for a risky change is a per-review call,
+ so this is panel state rather than a settings edit. */}
+ {
+ selectModel(directory, source, providerId && modelId ? `${providerId}/${modelId}` : null);
+ }}
+ allowedProviderIds={modelProviders}
+ isModelAllowed={isStructuredOutputCapable}
+ tooltipsEnabled={false}
+ dropdownPortalToBody
+ compact={compactHeader}
+ className={cn('h-8 min-w-0', !compactHeader && 'max-w-48')}
+ />
+ {view && (
+ <>
+
+
+
+ )}
+
+ {isGeneratingEntry ? (
+
+ ) : (
+
+ )}
+
+
+
+ {/* While regenerating over an existing walkthrough the stream keeps showing
+ the old content, so the only other signal would be the button swapping
+ to Cancel — far too quiet for something that runs for tens of seconds. */}
+ {entry.status === 'generating' && view && (
+
+ )}
+
+ {/* Switching the model or the language is a request for a walkthrough
+ that may not exist yet. Falling back to the last one is better than an
+ empty panel, but only if the panel says so — otherwise the picker
+ claims Ukrainian over English prose. */}
+ {(languageMissing || modelMissing) && (
+
+
+ {/* Provider errors arrive as raw JSON bodies. Show a readable amount
+ and keep the rest reachable rather than filling the panel. */}
+
+ {entry.error.message}
+
+
-
+