website · install · try the demo · quick start · docs
herdr-web-ui.mp4
Claude Code in a terminal pane, the same session as a chat, then on the phone · recorded live · ▶ the 56-second film
Claude Code and Codex, from your phone.
A browser and phone client for herdr. Read and reply to the same agent sessions running on your computer — on desktop or phone, as chat, with the terminal when you need it.
Send context from your phone Attach a screenshot, mention files, queue messages while the agent works. |
Open what the agent made A path in the chat opens in the file viewer, on the desktop and the phone. |
Browse a pane's files Walk the pane's folder and preview or download any file. |
Every PC in one sidebar Add Linux, macOS and Windows machines over SSH. Remote PCs → |
Each clip is a live recording of the desktop and a phone at once. Click one for the full ~20-second video.
- Chat and terminal, one pane — native Claude Code, Codex, omp, omo, gjc and pi transcripts, with the live terminal a click away. Supported agents →
- Approve with a tap — approvals, questions and plan menus become cards, checked to be current before your answer is sent.
- Know when you're needed — live status for every pane and push alerts when an agent needs input or finishes, even with the app closed.
- Install it on your phone — a PWA with Esc, Tab, Ctrl and arrows above the keyboard, and a QR code to your Tailscale address. Phone setup →
- Speak instead of typing — dictate into the chat or the terminal line, Korean and English mixed. Nothing goes out until you send it; it uses your own OpenAI key or the browser's speech recognition.
- Keep your workflow — herdr owns the agents; this app connects to them. Update from Settings without stopping them. All features →
curl -fsSL https://devswha.github.io/herdr-web-ui/install.sh | shLinux (x64, arm64) or macOS. Installs missing herdr 0.9.0+, Bun 1.4+ and Node 18+ prerequisites for your user, then installs the app as a herdr plugin. If an existing herdr installation is older than 0.9.0, update and restart herdr yourself before rerunning the installer. With the default listen address and Tailscale running, successful HTTPS setup provides a tailnet address and QR code.
Windows x64, in PowerShell:
irm https://devswha.github.io/herdr-web-ui/install.ps1 | iexRequires Git for Windows. Installs missing herdr and Bun for your user, then installs the same plugin. No Node or WSL is needed. Open Phone setup in herdr for phone access. Windows terminals use the screen mirror, with typing and a fixed grid, until herdr supports terminal attach there.
Already have the prerequisites? Install just the plugin:
herdr plugin install devswha/herdr-web-uiWith herdr running, open localhost:7317. Pick a pane or start an agent with New workspace. To use your phone, scan the installer's QR code and add the app to your home screen. Quick start →
The server listens on 127.0.0.1 by default. For access from another device, see phone setup and access and safety.
Start with the user guide: quick start · supported agents · features · phone · remote PCs · access and safety · configuration · keyboard shortcuts · FAQ.
For a closer look: how it works · chat transcripts · terminal flow control · app updates · changelog.
Built on herdr, with inspiration from chatmux, and powered by xterm.js, React, Bun and Lucide.
Thanks to everyone who has contributed, including @Yoonwoo-Ha.
Helping someone install the app? Follow INSTALL.md. For repository changes, follow CONTRIBUTING.md, the review rules and AGENTS.md.
git clone https://github.com/devswha/herdr-web-ui.git
cd herdr-web-ui
bun install
bun run server # API + WebSocket on :7317
bun run dev # Vite on :5173; run in a second terminalbun run typecheck
bun run test:unit # no herdr needed
bun test # isolated herdr test session
bun run test:ui # browser regression checksSee CONTRIBUTING.md to send a change, development for tests, media and releases, and DESIGN.md for UI conventions. Report security problems privately: SECURITY.md.
MIT. Copyright © 2026 devswha.