herdr-web-ui README

The project's README from github.com/devswha/herdr-web-ui. As one markdown file: README.md.

herdr web ui

herdr web ui

English · 简体中文 · 日本語 · 한국어

website · install · try the demo · quick start · docs

MIT license GitHub stars Latest release herdr 0.9.0+ Installable PWA

https://github.com/user-attachments/assets/6162cf5a-b29b-4f14-b2a2-7a01564791d6

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.

The phone attaches a screenshot and asks Claude to fix the bug; the desktop shows the same message.
Send context from your phone
Attach a screenshot, mention files, queue messages while the agent works. 		Claude writes a chart as an SVG file; a click opens it in the file viewer, and a tap on the phone does too.
Open what the agent made
A path in the chat opens in the file viewer, on the desktop and the phone.
The folder button opens the pane's folder and the file Claude wrote opens in the viewer; the phone does the same from the command palette.
Browse a pane's files
Walk the pane's folder and preview or download any file. 		Add PC connects to a Linux PC over SSH, installs the bridge, and its session joins the sidebar with a terminal running on that PC.
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.

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.

Windows x64, in PowerShell:

irm https://devswha.github.io/herdr-web-ui/install.ps1 | iex

Requires 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.

Installer output: Bun, Node and the herdr plugin install, then tailscale serve publishes the app and a QR code for the phone appears.

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.

herdr-web-ui (devswha/herdr-web-ui)

Searching Database…

1.1K ·GitHub
Herdr-web-ui
Что это?Это клиент herdr для браузера и телефона: он позволяет открывать уже запущенные сессии агентов, общаться с ними, видеть живой терминал каждой панели и отвечать откуда угодно.
Это отдельное приложение или ему нужен уже запущенный herdr?Это плагин/клиент для herdr, а не его замена: herdr по-прежнему работает и управляет агентами, а это приложение просто подключается к ним через браузер или как PWA на телефоне.
Как его установить и открыть?Запустите установщик для Linux/macOS (или команду PowerShell на Windows): он установит herdr, Bun и Node для вашего пользователя и добавит этот интерфейс как плагин herdr, затем откройте localhost:7317 и выберите панель или начните новую сессию.
Что должно быть установлено заранее?На Linux/macOS нужны herdr 0.9.0+, Bun 1.4+ и Node 18+ (или установщик сам их поставит); на Windows достаточно Git for Windows — там не требуются ни Node, ни WSL.
Живой терминал работает одинаково на всех ОС?На Windows он переключается на режим зеркального отображения экрана с вводом текста и фиксированной сеткой вместо полноценного подключения к терминалу, пока herdr не добавит такую поддержку для Windows.
С какими агентами для кодинга можно реально общаться?Он показывает нативные расшифровки диалогов и даёт живой терминал для сессий Claude Code, Codex, omp, omo, gjc и pi, запущенных в панелях herdr.
Куда попадает мой голос при использовании диктовки?Продиктованная речь никуда не отправляется, пока вы не нажмёте «отправить», а обрабатывается она вашим собственным ключом OpenAI или встроенным распознаванием речи браузера.
Как открыть приложение с телефона вне домашней сети?Установщик настраивает HTTPS поверх вашей сети Tailscale, давая вам приватный адрес tailnet и QR-код, который открывает PWA на телефоне.
Может ли он управлять другими машинами, кроме той, где работает herdr?Да, можно добавить другие компьютеры на Linux и macOS в боковую панель и подключаться к ним по SSH.
Как обрабатываются запросы агента на подтверждение и планы?Подтверждения, вопросы и меню планов от агента превращаются в интерактивные карточки, которые проверяются на актуальность непосредственно перед отправкой вашего ответа.
На чём построен этот проект?Он построен на herdr, вдохновлён chatmux и под капотом использует xterm.js, React, Bun и Lucide.
What are similar projects?pi-pocket, Codync, agent-router, hapi, WindTerm, Netcatty, happy, zoetrope
Which topics is it in?herdr, herdr-plugin, xterm, ssh-client, push-notifications, tailscale, coding-assistant, remote-desktop, file-manager, remote-access, qr-code, pwa
Creator
devswha
Size
73.6 MB
Stars
1.1K
Updated
CommitOct 16Releasev0.4.11Oct 16
Age
30d
Commits · 90 Days