herdr web ui

English · 简体中文 · 日本語

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}

Your agents, in plain conversation. On your desktop and your phone.

A browser and phone client for herdr. Open the sessions you already run, read what your agents are doing, and answer them from wherever you are.

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 and macOS 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 and gjc 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 →
• Keep your workflow — herdr owns the agents; this app connects to them. Update from Settings without stopping them. All features →

---

install

curl -fsSL https://devswha.github.io/herdr-web-ui/install.sh | sh

Linux (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.

Already have the prerequisites? Install just the plugin:

herdr plugin install devswha/herdr-web-ui

With herdr running, open localhost:7317. Pick a pane or start an agent with New session. 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.

docs

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.

thanks

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.

agent instructions

Helping someone install the app? Follow INSTALL.md. For repository changes, follow CONTRIBUTING.md and the committed review rules, plus the local AGENTS.md instructions when present.

development

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 terminal

bun run typecheck
bun run test:unit   # no herdr needed
bun test           # isolated herdr test session
bun run test:ui    # browser regression checks

See CONTRIBUTING.md to send a change, development for tests, media and releases, and DESIGN.md for UI conventions. Report security problems privately: SECURITY.md.

license

MIT. Copyright © 2026 devswha.