feat(ui): add command notifications, terminal search, and command palette (#68)

## Summary

Implements all 3 open UI enhancement issues in a single PR:

### Command Completion Notification (#62)
- Browser notifications when commands finish in background tabs
- Silence-timer heuristic (3s idle after output burst)
- 🔔 toggle in top bar, persisted in localStorage
- Opt-in via Notification API permission prompt

### Terminal Search (#64)
- In-terminal text search using xterm.js SearchAddon
- `Ctrl+F` / `Cmd+F` opens floating search bar overlay
- Input field, match count, prev/next navigation, regex toggle
- Styled with theme system CSS variables

### Command Palette (#65)
- Slide-out tool panel from right edge
- `Ctrl+K` / `Cmd+K` or floating ⚙️ FAB button
- 6 categories: Session, Search, View, Share, Notifications, System
- Integrates with search (#64) and notifications (#62)

### Additional
- Fixed silenceTimer memory leak on session cleanup
- 20 new integration tests (346 total, all passing)
- Updated all documentation (README, getting-started, architecture,
configuration, security)

Closes #62
Closes #64
Closes #65

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: dorlugasigal

README.md

@@ -79,6 +79,9 @@ termbeam --no-password          # disable password protection
 - **Initial command** — optionally launch a session straight into `htop`, `vim`, or any command
 - **Shell detection** — auto-detects your shell on all platforms (PowerShell, cmd, bash, zsh, Git Bash, WSL)
 - **QR code on startup** for instant phone connection
+- **Command completion notifications** — get browser notifications when a command finishes in a background tab; toggle with the bell icon in the toolbar (opt-in, requires browser permission)
+- **Terminal search** — press <kbd>Ctrl+F</kbd> / <kbd>Cmd+F</kbd> to open a search overlay with regex support, powered by xterm.js SearchAddon
+- **Command palette** — press <kbd>Ctrl+K</kbd> / <kbd>Cmd+K</kbd> (or tap the ⚙️ button) to open a slide-out tool panel with categorized actions: Session, Search, View, Share, Notifications, and System
 - **Light/dark theme** with persistent preference
 - **Adjustable font size** via status bar controls, saved across sessions
 - **Port preview** — reverse-proxy a single local web server port and preview it in the browser (HTTP only; no WebSocket/HMR; best with server-rendered apps)

docs/architecture.md

@@ -21,7 +21,7 @@ termbeam/
 │   └── version.js           # Smart version detection
 ├── public/
 │   ├── index.html           # Session manager (mobile UI)
-│   ├── terminal.html        # Terminal view (xterm.js)
+│   ├── terminal.html        # Terminal view (xterm.js, search, notifications, command palette)
 │   ├── sw.js                # Service worker (PWA caching)
 │   ├── manifest.json        # Web app manifest
 │   └── icons/               # PWA icons
@@ -93,6 +93,14 @@ Handles automatic installation of the DevTunnel CLI when it's not found on the s
 
 Smart version that shows `1.0.0` for npm installs and `1.0.0-dev (git-hash)` for local development.
 
+### Client-Side Features (`terminal.html`)
+
+The terminal page includes several client-side features that run entirely in the browser:
+
+- **Terminal search** — <kbd>Ctrl+F</kbd> / <kbd>Cmd+F</kbd> opens a search bar overlay powered by the xterm.js `SearchAddon`. Supports regex matching with next/previous navigation.
+- **Command completion notifications** — uses the browser Notification API to alert when a command finishes in a background tab. Toggled via a bell icon; preference stored in `localStorage` (`termbeam-notifications`).
+- **Command palette** — <kbd>Ctrl+K</kbd> / <kbd>Cmd+K</kbd> (or the floating ⚙️ button) opens a slide-out tool panel with categorized actions (Session, Search, View, Share, Notifications, System).
+
 ## Data Flow
 
 ```

docs/configuration.md

@@ -46,6 +46,18 @@ description: All TermBeam CLI flags and options — ports, passwords, tunnels, s
 !!! info "Legacy Variables"
     The environment variables `PTY_PASSWORD` and `PTY_CWD` are also supported as fallbacks for `TERMBEAM_PASSWORD` and `TERMBEAM_CWD` respectively.
 
+## Client-Side Settings (localStorage)
+
+The browser UI stores the following preferences in `localStorage`:
+
+| Key                      | Description                                               | Default |
+| ------------------------ | --------------------------------------------------------- | ------- |
+| `termbeam-notifications` | Command completion notifications enabled (`true`/`false`) | `true`  |
+| `termbeam-fontsize`      | Terminal font size                                        | `14`    |
+| `termbeam-theme`         | Light/dark theme preference                               | `dark`  |
+
+These settings are per-browser and persist across sessions. They can be cleared by the user via the browser's developer tools or the Refresh button in the toolbar.
+
 ## Subcommands
 
 ### `termbeam service`

docs/getting-started.md

@@ -94,6 +94,25 @@ termbeam
 - **Swipe up/down** to scroll through terminal history on touch devices
 - Scrollbar is hidden to save space but scrolling works normally
 
+### Search
+
+- Press <kbd>Ctrl+F</kbd> / <kbd>Cmd+F</kbd> to open the **search bar** overlay
+- Supports **regex** matching with next/previous navigation
+- Press <kbd>Escape</kbd> to close the search bar
+
+### Command Palette
+
+- Press <kbd>Ctrl+K</kbd> / <kbd>Cmd+K</kbd> (or tap the **⚙️** button) to open the **command palette**
+- Browse categorized actions: **Session**, **Search**, **View**, **Share**, **Notifications**, **System**
+- A quick way to discover all available features and shortcuts
+
+### Notifications
+
+- Tap the **🔔 bell icon** in the toolbar to enable **command completion notifications**
+- When enabled, you'll receive a browser notification whenever a command finishes in a background tab
+- Preference is saved in `localStorage` and persists across sessions
+- Requires browser notification permission (requested on first enable)
+
 ### Share & Refresh
 
 - Tap the **share button** (↗) to copy a shareable auto-login link to your clipboard; falls back to a manual-copy dialog when clipboard access is unavailable

docs/index.md

@@ -20,6 +20,9 @@ Built for developers who need quick remote terminal access without the hassle of
 - **Built for mobile** — touch bar, swipe gestures, zoom, touch scrolling
 - **Tabbed sessions** — switch, split, reorder, and preview multiple terminals
 - **Session colors & activity indicators** for at-a-glance status
+- **Terminal search** — <kbd>Ctrl+F</kbd> / <kbd>Cmd+F</kbd> with regex support
+- **Command palette** — <kbd>Ctrl+K</kbd> / <kbd>Cmd+K</kbd> for quick access to all actions
+- **Command notifications** — browser alerts when commands finish in background tabs
 - **Share & refresh buttons** for easy link sharing and PWA cache updates
 - **One command to start** — `npx termbeam`
 - **Secure by default** — password auth, rate limiting, tunnel encryption

docs/security.md

@@ -147,6 +147,14 @@ Every response includes:
 | `Cache-Control`           | `no-store`                   | Prevent caching       |
 | `Referrer-Policy`         | `no-referrer`                | No referrer leaks     |
 
+### Client-Side Features
+
+The following UI features are entirely client-side and introduce **no new server-side attack surface**:
+
+- **Command completion notifications** — uses the browser [Notification API](https://developer.mozilla.org/en-US/docs/Web/API/Notifications_API), which requires explicit user permission (opt-in). No data is sent to external services; notifications are generated locally in the browser.
+- **Terminal search** — runs in the browser via the xterm.js SearchAddon. Search queries never leave the client.
+- **Command palette** — a client-side UI panel that triggers existing actions. No new endpoints or permissions required.
+
 ### Network Binding
 
 - **Default:** Binds to `127.0.0.1` (localhost only)