Skip to content
scturtlePublic
forked from herdrdev/herdr

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

ht

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.

Build

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

1. Prepare dependencies

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.

2. Prepare the two Zig toolchains

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.

3. Build the client and Core

just build        # client: fetch verified libghostty-vt sources, then build ht
just build-core   # Core: fetch, patch, build and atomically publish herdr-core

4. Install (optional)

just install builds both components and symlinks ht and herdr-core into ~/.local/bin.

Working directories

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

Run

HERDR_CORE_BIN="$PWD/.local/hc/bin/herdr-core" ./target/release/ht

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

Configuration

Edit ~/.config/herdr/config.toml (or HERDR_CONFIG_PATH).

License

Apache License 2.0. Based on Herdr by its original contributors.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages