A personal, Linux-only fork of Herdr, using herdr-core as its only runtime and reusing the original terminal UI.
- Workspaces, tabs, split panes, keyboard and mouse controls.
- Multiple clients share running programs while keeping independent focus.
- The last interacting client controls a pane's size; other clients follow it.
- Detaching leaves programs running. Copy, search and local diagnostics are built in.
A working installation needs two binaries, built independently:
| Component | Sources | Zig | Output |
|---|---|---|---|
Client (ht) |
this workspace + libghostty-vt vt-1.0.0 |
0.17.0 | target/release/ht |
Core (hc) |
herdr-core | 0.16.0 | .local/hc/bin/herdr-core |
Install Rust 1.100.0 with clippy and rustfmt through
rustup (rust-toolchain.toml pins the channel), a libclang
shared library for bindgen (LIBCLANG_PATH if it is not auto-detected), and
just, which drives every build recipe, plus cargo-nextest for just test,
with cargo install into ~/.local/bin kept on PATH.
The client and Core use different Zig versions because they vendor different
Ghostty sources. Install both toolchains side by side: just sets ZIG to
.local/toolchain/zig/0.17.0/zig for the client, so no shell export is needed.
Core's build ignores ZIG and always uses .local/toolchain/zig/0.16.0/zig.
just build # client: fetch verified libghostty-vt sources, then build ht
just build-core # Core: fetch, patch, build and atomically publish herdr-corejust install builds both components and symlinks ht and herdr-core into
~/.local/bin.
Keep toolchain/ (tools plus zig/<version>/), core-tui/ (trial runtime home
and personal config). Everything else rebuilds on demand: cache/ and
libghostty-vt/ for the client, hc/ for Core (downloads/, work/ and the
published hc/bin/herdr-core). Client Cargo outputs stay in target/.
HERDR_CORE_BIN="$PWD/.local/hc/bin/herdr-core" ./target/release/htWith both binaries on PATH (via just install), launch with ht. It
connects to the default Core or starts it if needed. The iOS App and ht
can connect in either order: point the App at the same Linux user and Core
endpoint (normally $XDG_RUNTIME_DIR/herdr-core/default.sock). Both use the
herdr-app layout document. In an empty layout, press Ctrl+a then c to
open the first shared tab.
Set HC_SOCKET to attach to an already-running Core at a specific socket.
Recovery after a disconnect never starts Core.
Edit ~/.config/herdr/config.toml (or HERDR_CONFIG_PATH).
Apache License 2.0. Based on Herdr by its original contributors.