Native Herdr shows the spaces, tabs and terminals of Herdr on a server as native lists and terminal views, instead of the Herdr TUI inside a terminal. It talks to hc, Herdr's core, which you install on the server yourself. Warpeer never installs, updates or configures hc.
Install hc on the server
Native Herdr appears only on servers where hc is installed. On a Linux or macOS server, run Herdr's official installer:
curl -fsSL https://releases.herdr.dev/core/install.sh | sh
Builds exist for Linux and macOS on x86_64 and aarch64. Warpeer looks for herdr-core or hc in $HC_INSTALL_DIR, ~/.local/bin, ~/.cargo/bin, ~/bin, /opt/homebrew/bin, /usr/local/bin and your PATH. It checks again every time you connect, so an hc installed later shows up on the next connection.
Native Herdr needs hc 0.1.11 or newer. With an older hc, the row is dimmed and asks you to run hc update on the server. Without hc, nothing changes.
Open native Herdr
In a terminal, open the menu at the end of the session dock and choose Runtime sessions. The list starts with Native Herdr and the hc version it found. Tap it. Native Herdr opens on a connection of its own, so your terminal tab stays as it was.
- The browser lists each space with its folder and its tabs. A tab shows the names of its terminals and the most urgent coding agent state, such as Needs input or Working.
- Other Terminals lists live terminals that are in no tab, such as one you started from Warpeer.
Watch, then type
A terminal opens Watching: you see its output live, and your phone does not change its size for anyone else. The first time you type, the phone becomes the active screen for that terminal and sizes it to fit. A one-time note explains that this also resizes it for other screens showing it, such as herdr on your computer.
On a phone a tab shows one terminal at a time with chips for its panes; on a wide screen the tab's split layout is drawn with every pane. The key row sends esc, tab, control keys and arrows.
Agents
When coding agents run in Herdr, the bar at the top shows how many need you, work or are done. Tap it for every agent as a tree of who started whom, the one that needs you first; tap an agent to go to it.
- Pane states. Each pane's tab starts with a mark for its state: a dot while it works or idles, a sign when it needs you or failed, a tick when its task is done. A pane also shows the state of the sub-agents it started, and a small dot when it has news for you. The sub-agents of the pane you are in follow it in the strip.
- The agent grid. With two or more agents, the button at the end of the strip turns the tab into a grid of every agent: its latest screen as text, state and progress. Tap a pane to switch to it, or a sub-agent to look at it. Touch and hold for Open, Send Message, Open Terminal and Close.
- Peek and message. A sub-agent opens in a sheet over the tab. Answer it there, or send it a message; a blocked agent is sent to only after you confirm. Reports between agents appear as cards, and the activity list keeps them.
- Agents that need you show on Home and in the inbox with their question, and Warpeer notifies you while it is open.
Open Terminal shows an agent as a page of its own while Herdr is open; it is not kept across launches.
Start and close terminals
- + starts a login shell in the tab's folder, or one of the server's hc templates.
- The close button ends the terminal's program on the server, after you confirm.
The floating ball
Collapse keeps native Herdr behind the floating ball and stops watching every terminal. Tap the ball to come back. Back steps out of a terminal, then out of the browser. Leaving the app ends native Herdr; your terminals keep running in hc on the server.
Native Herdr runs only inside your own SSH connection. Names, folders and terminal output never pass through Warpeer or another service.