Termherd

TermHerd

A Rust replatform experiment for a Claude Code session workspace. Native, terminal-multiplexer-style (tabs + splits + keyboard driven), with the quality bar the predecessor lacked.

Inspired by [doctly/switchboard](https://github.com/doctly/switchboard), the Electron app it replatforms; see [`docs/background/`](docs/background/) for the full reasoning archive.

Documentation

**📖 [termherd.github.io/termherd](https://termherd.github.io/termherd/)** — the user manual: philosophy, install, quick start, the workspace surfaces (sidebar, tabs and splits, terminal, status, capture), the MCP control surface, the shortcut reference and the `settings.json` reference.

It is an [mdBook](https://rust-lang.github.io/mdBook/) whose sources live in [`docs/src/`](docs/src/); `just docs` builds it, `just docs-serve` previews it with live reload, and every push to `main` republishes it. A user-visible change updates it in the same PR — see [`AGENTS.md`](AGENTS.md).

This is an early scaffold. Status, scope, and design live in:

• `docs/PRD.md` — Product Requirements Document
• `docs/ARCHITECTURE.md` — Architecture
• `ROADMAP.md` — feature buckets (MoSCoW); generated from .roadmap/ by roadmark
• `CHANGELOG.md`

Install

Requirements

A shell, and — to launch Claude sessions — the **Claude Code CLI, 1.0.61 or newer**, on your `PATH`.

That floor is the `--settings` flag, which arrived in 1.0.61 and which termherd puts on every Claude launch. It re-enables the CLI's terminal title for that session only, and the title is where a Claude session's activity comes from — without it, a `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` anywhere in your own settings would leave every session reading `starting` forever. An older CLI would reject the flag and fail to start; termherd's other flag, `--mcp-config` (the live bridge), has been available since 0.2.75.