diff --git a/CLAUDE.md b/CLAUDE.md index 191e8b2c..f825a9be 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -35,7 +35,7 @@ When user says "COM": 1. Increment version in BOTH `package.json` AND `CLAUDE.md` (verify they match with `grep version package.json && grep Version CLAUDE.md`) 2. Run: `git add -A && git commit -m "chore: bump version to X.XXXX" && git push && npm run build && systemctl --user restart claudeman-web` -**Version**: 0.1615 (must match `package.json`) +**Version**: 0.1616 (must match `package.json`) ## Project Overview diff --git a/README.md b/README.md index d7c511cd..694e3a56 100644 --- a/README.md +++ b/README.md @@ -66,6 +66,41 @@ Claudeman requires tmux, so Windows users need [WSL](https://learn.microsoft.com --- +## Mobile-Optimized Web UI + +Mobile — keyboard open + +The most responsive Claude Code experience on any phone. Full xterm.js terminal with local echo, swipe navigation, and a touch-optimized interface designed for real remote work. + +| Terminal Apps | Claudeman Mobile | +|:--------------|:-----------------| +| 200-300ms input lag over remote | **Local echo — instant feedback** | +| Tiny text, no context | Full xterm.js terminal, responsive layout | +| No session management | Swipe between sessions, status badges | +| No notifications | Push alerts for approvals and idle | +| Manual reconnect after drops | tmux persistence — sessions survive anything | +| No agent visibility | Background agents in real-time | +| Copy-paste slash commands | One-tap `/init`, `/clear`, `/compact` buttons | + +
+ +- **Swipe navigation** — left/right on the terminal to switch sessions (80px threshold, 300ms) +- **Keyboard accessory bar** — `/init`, `/clear`, `/compact` quick-action buttons appear above the virtual keyboard with confirmation dialogs for destructive commands +- **Smart keyboard handling** — toolbar and terminal shift up when keyboard opens (uses `visualViewport` API with 100px threshold for iOS address bar drift) +- **Safe area support** — respects iPhone notch and home indicator via `env(safe-area-inset-*)` +- **44px touch targets** — all buttons meet iOS Human Interface Guidelines minimum sizes +- **Bottom sheet case picker** — slide-up modal replaces the desktop dropdown +- **Native momentum scrolling** — `-webkit-overflow-scrolling: touch` for buttery scroll + +```bash +claudeman web --https +# Open on your phone: https://:3000 +``` + +> `localhost` works over plain HTTP. Use `--https` when accessing from another device, or use [Tailscale](https://tailscale.com/) (recommended) — it provides a private network so you can access `http://:3000` from your phone without TLS certificates. + +--- + ## Live Agent Visualization Watch Claude's background agents work in real-time. Claudeman monitors every `Task` tool invocation and displays each agent in a draggable floating window with animated Matrix-style connection lines back to the parent session. @@ -98,41 +133,6 @@ A pixel-perfect DOM overlay inside xterm.js renders keystrokes at 0ms. Backgroun --- -## Mobile-Optimized Web UI - -The most responsive Claude Code experience on any phone. Full xterm.js terminal with local echo, swipe navigation, and a touch-optimized interface designed for real remote work. - -

- Mobile — keyboard open -

- -| Terminal Apps | Claudeman Mobile | -|:--------------|:-----------------| -| 200-300ms input lag over remote | **Local echo — instant feedback** | -| Tiny text, no context | Full xterm.js terminal, responsive layout | -| No session management | Swipe between sessions, status badges | -| No notifications | Push alerts for approvals and idle | -| Manual reconnect after drops | tmux persistence — sessions survive anything | -| No agent visibility | Background agents in real-time | -| Copy-paste slash commands | One-tap `/init`, `/clear`, `/compact` buttons | - -- **Swipe navigation** — left/right on the terminal to switch sessions (80px threshold, 300ms) -- **Keyboard accessory bar** — `/init`, `/clear`, `/compact` quick-action buttons appear above the virtual keyboard with confirmation dialogs for destructive commands -- **Smart keyboard handling** — toolbar and terminal shift up when keyboard opens (uses `visualViewport` API with 100px threshold for iOS address bar drift) -- **Safe area support** — respects iPhone notch and home indicator via `env(safe-area-inset-*)` -- **44px touch targets** — all buttons meet iOS Human Interface Guidelines minimum sizes -- **Bottom sheet case picker** — slide-up modal replaces the desktop dropdown -- **Native momentum scrolling** — `-webkit-overflow-scrolling: touch` for buttery scroll - -```bash -claudeman web --https -# Open on your phone: https://:3000 -``` - -> `localhost` works over plain HTTP. Use `--https` when accessing from another device, or use [Tailscale](https://tailscale.com/) (recommended) — it provides a private network so you can access `http://:3000` from your phone without TLS certificates. - ---- - ## Respawn Controller The core of autonomous work. When Claude goes idle, the Respawn Controller detects it, sends a continue prompt, cycles `/clear` -> `/init` for fresh context, and resumes — running **24+ hours** completely unattended. diff --git a/package.json b/package.json index f759e210..0810f666 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "claudeman", - "version": "0.1615", + "version": "0.1616", "description": "The missing control plane for Claude Code - run 20 autonomous agents with real-time monitoring and session persistence", "type": "module", "main": "dist/index.js",