for herdr-core and the herdr app

Round up your terminals.

A keyboard-first terminal UI for herdr-core. Same spaces, tabs & panes as the Herdr desktop app: make a split in one and it shows up in the other.

Install rodeo Read the docs

rodeo on the default hc session. codex finishes in another space; the same toast shows in the Herdr app.

why rodeo

Your terminal and your app see the same thing

Herdr TUI runs its own server, and the desktop app runs on hc. They share no terminals. I wanted my terminal and my app to see the same thing.

hc owns every program. rodeo only owns the UI, so you can close it, open it again, or run two at once. Your terminals keep running the whole time.

features

Built for the keyboard

Keyboard firstWorkspaces, tabs & splits from the keyboard (ctrl+b prefix), or the mouse.
One glanceSpaces, agents and machines in the sidebar, each with its state.
One shared layoutShared with the Herdr desktop app and other rodeo clients. A split in one shows up in the other.
Your Herdr TUI setupHerdr TUI keys & config work as is.
Agent statesBlocked, working, done and idle from hc, with toasts & sounds.
Other machinesSpaces on other machines through hc’s machine links.
The detailsWorktrees, popups, copy mode, image paste, links & kitty graphics.

install

Pick your installer

Each needs hc 0.1.18 or newer on your PATH. Linux or macOS.

curlhomebrewmise

$ curl -fsSL https://rodeo.lukeed.com/install.sh | sh

$ brew install lukeed/tap/rodeo

$ mise use -g packslip:github.com/lukeed/rodeo

rodeo --help0.1.0

      ██▄▄██
  █▄  ▀▀▀▀▀▀  ▄█
   ▀▀▀▀▀▀▀▀▀▀▀▀    rodeo▍
       ████        a terminal UI for herdr-core
       ████
       ████

  usage:
    rodeo [--session <name>]   open rodeo on an hc session
    rodeo --default-config     print the default config
    rodeo config check         check the config file
    rodeo config reset-keys    remove [keys] from the config (keeps a backup)
    rodeo --help | --version

  Detach with the detach key (prefix+q). Terminals keep running in hc.

key binds

Keys you already know

Coming from Herdr TUI? Your keys and config work as is. Press prefix+? in rodeo for the full list.

key	action
`ctrl+b`	prefix
`prefix+v`	split the pane side by side
`prefix+minus`	split the pane top and bottom
`prefix+c`	new tab
`prefix+w`	pick a space
`prefix+z`	zoom the pane
`prefix+q`	detach; terminals keep running
`prefix+?`	every key bind

Every key bind →

coming from herdr tui

What changed

rodeo started as Herdr TUI 0.9.5 on hc, and it’ll drift from it over time. Sessions, restore and remote machines belonged to Herdr’s own server, so hc covers them now. A few are gone:

Plugins. There is no plugin model.
Self-update, release notes & onboarding. rodeo does not update itself.
Agent integrations. Agents report their own state to hc (OSC 7501).