Herdr

Herdr · Agent supervision

Herdr

Official website

Once several coding assistants are running, finding the one waiting for you can become a job of its own. Herdr puts their terminal sessions in one workspace and shows which appear to be working or need attention. Its server can keep them running while you detach the viewing terminal, provided the host stays on. You still install and sign in to each assistant separately. Herdr is most useful when you like the assistants you have and want an easier way to follow their conversations, leave the workspace and return to unfinished work.

Ready guideDocumentation checked
In this guide 7 sections

Is it for you?

When it helps

  • Keeping several coding sessions easy to find as you move between tasks
  • Leaving a terminal workspace and returning to the same running sessions without rebuilding the layout

When to choose something else

  • One conversation that is already easy to follow in a single terminal
  • Keeping independent edits apart just by putting them in different panes. Separate working files are still needed, and status labels still need checking against the actual output

Before you start

  • A Linux, macOS or Windows host that meets the documented requirements. Review the Windows limitations before setup
  • At least one coding assistant installed and signed in separately
  • A host that stays on if the work needs to continue while your viewing device is disconnected

Cost and access

The Herdr runtime is Apache 2.0 licensed. The assistants, model usage and any remote machine running the sessions have separate costs. Herdr Cloud is currently described as coming soon, so this guide uses a host you provide.

Check current access and pricing

Set it up

  1. Install on the machine that will run the sessions

    The command below installs Herdr on macOS or Linux using its official script, which you should review first. The installation guide also covers Homebrew and Windows. Choose the host with continued work in mind: closing your view is useful only if that machine remains available.

    Terminal command
    curl -fsSL https://herdr.dev/install.sh | sh
  2. Bring an existing assistant into the workspace

    Run herdr from a disposable project directory. In a shell pane, start an assistant you have already configured, such as codex, claude or pi. Begin with a familiar task so you can concentrate on how Herdr presents the conversation and its status.

    Terminal command
    herdr
  3. Detach without stopping the work

    Press Ctrl+B, release the keys, then press Q. This detaches your view while the server and its processes keep running. Run herdr again to return. The host still needs to stay on; detaching does not move the work to another machine.

Pick up a review where you left it

Suppose you have asked an assistant to compare a runbook with the configuration in a repository. You want to leave it reading while you do something else, then return to its findings or a question it needs you to answer. This illustrative review gives you a reason to try Herdr’s status display and detach behavior without starting several unfamiliar jobs at once.

What to ask

Compare this runbook with the checked-out configuration. Show me where the instructions match the files and where they disagree, with file references. Explain what cannot be established from this repository. Do not change files.

  1. Give the review to one assistant in Herdr and keep another pane for your own inspection. Record which repository revision it is reading. If edits must be prevented, use a read-only environment; asking the assistant not to edit does not enforce that restriction.
  2. Watch how the status display relates to the conversation. When the assistant answers or asks you a question, open its pane and read what happened. This helps you learn which labels are useful cues and when you need to inspect the output directly.
  3. Detach with the host still running, then reattach and return to the report. Check its references against the same revision. You are trying to pick up the investigation without reconstructing which task was running or which files its answer describes.

Before you rely on the result

You can find the session that needs attention, understand what it was doing and continue the review. If that is easier than your current terminal arrangement, there is a practical reason to bring another task into the workspace.

Go deeper

When the status does not match the conversation

Herdr’s detection guide notes that Codex may remain in an unknown state after it responds. Open the pane to see whether it has answered, stopped or needs something from you. A wait for completion can time out because detection is uncertain, so investigate the conversation before treating that timeout as a failed task.

Read the guidance

Let parallel edits use separate working copies

Two panes can still point at the same files. For independent editing tasks, give each assistant a Git worktree, a separate directory with its own checked-out branch, or an equivalent isolated copy. The Herdr guide explains how to keep the resulting changes tied to the revision each assistant examined, which makes them easier to review and combine afterward.

Read the guidance

What comes back after a restart?

Detaching leaves the original processes alive. A full server restart can restore the layout while those original processes are gone. Saved screen history and an assistant’s own conversation restoration have separate conditions, so a familiar-looking pane may not mean the work continued. The full guide explains the differences and how to rehearse recovery on disposable work.

Read the guidance

Other options to consider

One coding-agent session
Keep one session when it gives you enough room to follow the whole job
Your existing terminal workflow
Your current terminal setup may already make waiting sessions and unfinished work easy to find

Sources and review

Based on official documentation reviewed September 30, 2026. The example is illustrative; this guide does not report an installation, benchmark or production test.

Documentation checked

Back to all tool guides