Spaces
The direct terminal surface: tabs, panes, splits, notes, launchers and shared viewing.
Public preview / Linux + macOS
Herdr World turns live Herdr sessions into one visual workspace: terminal-first Spaces, a multi-host Pixel Office, a live topology Graph, and the controls to move between them without losing context.
A different view of active work
Tabs become desks. Workspaces become rooms. Active agents stay at work; blocked agents meet at reception; idle agents drift to the bar. Underneath, every identity remains qualified to its exact host and generation.
The direct terminal surface: tabs, panes, splits, notes, launchers and shared viewing.
Pixel Office and Graph project the same live state for awareness, topology, handoff and focus.
Connect directly to multiple bridges while preserving collision-safe runtime identity.
Desktop to pocket
Herdr World keeps its visual and terminal surfaces usable at 375 pixels without creating a separate mobile control plane.
Four ways in
Use npm, Homebrew, or a manual archive for the standalone herdr-world command, or let Herdr manage the bridge as a native plugin. The Herdr route keeps its runtime inside Herdr’s plugin system and never writes a new command into your shell. The macOS previews are currently unsigned.
Herdr plugin / native lifecycle
Herdr restores the bridge on startup. Use Herdr’s Open Herdr World action to open the web client now.
Read plugin lifecycle ↗Standalone / Node.js 22.14+
$ npm install --global @ivoryheart/herdr-world@latest
$ herdr-world
The npm package includes the tested Linux x64, macOS ARM64, and macOS Intel bridges.
Pin a version or choose a session
$ npm install --global @ivoryheart/herdr-world@0.1.1
$ herdr-world --session NAME
$ herdr-world --port 8791
Release candidates use npm’s next channel. Stable releases use latest; pin an exact version when you need a fixed build.
Standalone / macOS or Linux
$ brew install IvoryHeart/tap/herdr-world
$ herdr-world
The Formula exposes the same herdr-world command on both release channels.
Preview and stable channels
$ brew update
$ brew upgrade IvoryHeart/tap/herdr-world
$ brew uninstall herdr-world
RCs use herdr-world-rc; stable releases use herdr-world. The Formulae conflict because both provide the same command, so they cannot be installed together.
Herdr-managed / Herdr 0.8.2+
$ herdr plugin install IvoryHeart/herdr-world --ref v0.1.1
$ herdr plugin action invoke open --plugin ivoryheart.herdr-world
Install registers and builds the plugin. The open action starts the bridge for an already-running Herdr server.
Herdr manages the bridge
# Inspect or control the installed plugin:
$ herdr plugin action invoke status --plugin ivoryheart.herdr-world
$ herdr plugin action invoke doctor --plugin ivoryheart.herdr-world
$ herdr plugin action invoke restart --plugin ivoryheart.herdr-world
$ herdr plugin action invoke stop --plugin ivoryheart.herdr-world
The startup hook starts the bridge on the next Herdr server restore. It never installs or starts Herdr, and it does not add a herdr-world shell command. Stop the bridge before uninstalling the plugin.
Manual release archive / Linux x86-64, macOS ARM64, or macOS Intel
VERSION=v0.1.1
PLATFORM=linux-x86_64 # or macos-arm64 / macos-x86_64
$ curl -fLO "https://github.com/IvoryHeart/herdr-world/releases/download/${VERSION}/herdr-world-${VERSION}-${PLATFORM}.tar.gz"
$ curl -fLO "https://github.com/IvoryHeart/herdr-world/releases/download/${VERSION}/herdr-world-${VERSION}-${PLATFORM}.tar.gz.sha256"
$ tar -xzf "herdr-world-${VERSION}-${PLATFORM}.tar.gz"
$ cd "herdr-world-${VERSION}-${PLATFORM}"
$ bin/herdr-world
Use sha256sum --check on Linux or shasum -a 256 --check on macOS before extracting. Download the current release ↗
Runtime options
$ bin/herdr-world --help
$ bin/herdr-world --session NAME
$ bin/herdr-world --port 8791
The archive launcher can guide an interactive Herdr setup when no compatible default session is available. Use --no-herdr-setup for a non-interactive launch.
The bridge binds to loopback by default. Network exposure is explicit and intended for trusted networks.
Herdr and Herdr Web remain independent upstream projects with retained attribution and auditable provenance.
MIT-licensed project code, complete bundled notices, public checksums and reproducible release mechanics.
The office is open