# Herdr

Podium publishes this catalog and sells an agent development environment. Podium chooses the products, criteria, sources and wording, so treat these pages as vendor-authored research. Check important claims against the linked primary sources. The same evidence rules apply to Podium and its competitors, but they do not remove this conflict of interest.

Page: https://adecomparison.com/ade/herdr/
Website: https://herdr.dev/
Research: covered

Method: https://adecomparison.com/method/

Rank by must-haves met, then preferences, then name. Read each finding's checked date. Findings stay published after their scheduled recheck. Checks over six months old may be outdated.

## herdr:ACC-01

Finding: Herdr TUI runs as a Rust terminal program with a product CLI on macOS, Linux and Windows; it is not an Electron desktop client. The new Herdr native app supports Apple silicon macOS, Linux x86_64 and ARM64, and Windows x86_64. It is separate from TUI and does not share its running agents. The current Herdr privacy page describes iOS and Android apps connecting directly to user machines over SSH. This concerns the newer Herdr app family, not TUI terminal installation. No product-owned browser client is distributed in the inspected native app, TUI or documented phone-client list. The scoped clients are native apps and TUI, with no phone-browser frontend.

Verification: sourced
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app; Herdr native app and herdr-core, separate from Herdr TUI
Version: Herdr TUI v0.9.5, native app 0.1.15 (69ba1cae471da83a652bbaefd97500efe097419c), core d9e68262268b25a33bfe79cabb41fe60baf5db07; targeted first-party pass 2026-11-13; no installed-product test

The scoped first-party source pass does not establish editor_extensions, task_actions, notifications, cross_device_continuity. No hands-on scenario was run.

Source: https://github.com/herdrdev/herdr/blob/ee5bfb5041bb3e4a49d591c72308aae3c81ecdde/README.md
Locator: Install; One Rust binary
Finding: Herdr TUI runs as a Rust terminal program with a product CLI on macOS, Linux and Windows; it is not an Electron desktop client.
Retrieved: 2026-11-08

Source: https://herdr.dev/
Locator: Questions: How is it different; Which systems
Finding: The new Herdr native app supports Apple silicon macOS, Linux x86_64 and ARM64, and Windows x86_64. It is separate from TUI and does not share its running agents.
Retrieved: 2026-11-08

Source: https://herdr.dev/privacy/
Locator: The mobile apps
Finding: The current Herdr privacy page describes iOS and Android apps connecting directly to user machines over SSH. This concerns the newer Herdr app family, not TUI terminal installation.
Retrieved: 2026-11-08

Source: https://github.com/herdrdev/herdr-app/blob/69ba1cae471da83a652bbaefd97500efe097419c/Cargo.toml
Locator: Native app Cargo.toml and src/main.rs at 69ba1ca; TUI Cargo.toml at 2ecf19a; mobile list at herdr.dev/mobile; inspected build/distribution entries
Finding: The inspected app and TUI distribute native Rust clients; the first-party mobile page describes iOS and Android SSH clients. No browser client build or phone-browser frontend is supplied by these scoped components.
Retrieved: 2026-11-13

## herdr:ACC-02

Finding: Herdr TUI runs existing agent CLIs in real terminal panes. Documented detections include Claude Code, Codex, Cursor Agent CLI, OpenCode, Pi, Grok CLI and Gemini CLI, with Gemini state detection labeled less tested. Other commands run as plain terminals. Herdr v0.9.5 recognizes Antigravity terminal sessions as agy and constructs native agy --conversation resume commands.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08 Antigravity source pass: v0.9.5 (2ecf19a92fc3a7fff75b6ce3655ef04f4625ec01).

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.
This is a terminal-pane integration; status is derived from the agent screen and native resume metadata.

Source: https://herdr.dev/docs/agents/
Locator: Supported agents
Finding: Herdr TUI runs existing agent CLIs in real terminal panes. Documented detections include Claude Code, Codex, Cursor Agent CLI, OpenCode, Pi, Grok CLI and Gemini CLI, with Gemini state detection labeled less tested. Other commands run as plain terminals.
Retrieved: 2026-11-08

Source: https://github.com/herdrdev/herdr/blob/2ecf19a92fc3a7fff75b6ce3655ef04f4625ec01/distribution/agent-detection/antigravity.toml#L1-L27
Locator: distribution/agent-detection/antigravity.toml lines 1-27, v0.9.5, commit 2ecf19a92fc3a7fff75b6ce3655ef04f4625ec01
Finding: Herdr v0.9.5 recognizes Antigravity terminal sessions as agy and constructs native agy --conversation resume commands.
Retrieved: 2026-11-10

Source: https://github.com/herdrdev/herdr/blob/2ecf19a92fc3a7fff75b6ce3655ef04f4625ec01/src/agent_resume.rs#L277-L291
Locator: src/agent_resume.rs lines 277-291, v0.9.5, commit 2ecf19a92fc3a7fff75b6ce3655ef04f4625ec01
Finding: Herdr v0.9.5 recognizes Antigravity terminal sessions as agy and constructs native agy --conversation resume commands.
Retrieved: 2026-11-10

## herdr:ACC-03

Finding: Herdr TUI runs the user's installed agent CLIs unmodified in real terminal panes, so each CLI's own sign-in (for example a Claude or Codex subscription login) applies; the Herdr mobile apps need no Herdr account. API-key, credit, local-model and provider-restriction questions remain unestablished.

Verification: agent-cross-checked
Checked: 2026-11-10
Scheduled recheck: 2026-12-10
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: v0.9.5

Source-inspected and documentation only; no authenticated subscription login was tested.
Account requirement statement comes from the mobile-app page of the newer Herdr app family.

Source: https://github.com/herdrdev/herdr/blob/2ecf19a92fc3a7fff75b6ce3655ef04f4625ec01/README.md#L31-L35
Locator: README.md lines 31-35 (feature bullets), tag v0.9.5, commit 2ecf19a
Finding: Herdr runs the agent CLIs the user already has (Claude Code, Codex, Cursor, OpenCode, Grok and others) in its own terminals and says it does not wrap or replace them.
Retrieved: 2026-11-10

Source: https://github.com/herdrdev/herdr/blob/2ecf19a92fc3a7fff75b6ce3655ef04f4625ec01/src/integration/env.rs#L28-L33
Locator: src/integration/env.rs lines 28-33 (apply_pane_base_env), tag v0.9.5, commit 2ecf19a
Finding: The pane command builder only adds the Herdr socket path and Herdr binary path to the pane environment; it does not inject agent credentials or alter the agent command.
Retrieved: 2026-11-10

Source: https://github.com/herdrdev/herdr/blob/2ecf19a92fc3a7fff75b6ce3655ef04f4625ec01/src/integration/env.rs#L58-L60
Locator: src/integration/env.rs lines 58-60 (claude_dir) and 91+ (config_dir_from_env_or_home), tag v0.9.5, commit 2ecf19a
Finding: Herdr's Claude integration resolves the user's own CLAUDE_CONFIG_DIR or ~/.claude, i.e. the installed CLI's own configuration and login home.
Retrieved: 2026-11-10

Source: https://herdr.dev/mobile/
Locator: herdr.dev/mobile (connection and pricing sections), read 2026-11-10
Finding: The iPhone, iPad and Android apps connect over SSH directly to herdr-core on the user's machines with no relay and no Herdr account; the app is described as free.
Retrieved: 2026-11-10

## herdr:ACC-04

Finding: Install the Herdr binary or a package-manager build, start it where the repository lives and run existing agent commands. Saved SSH machines connect to their own server.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://github.com/herdrdev/herdr/blob/ee5bfb5041bb3e4a49d591c72308aae3c81ecdde/README.md
Locator: Install
Finding: Install the Herdr binary or a package-manager build, start it where the repository lives and run existing agent commands. Saved SSH machines connect to their own server.
Retrieved: 2026-11-08

## herdr:ACC-05

Finding: Herdr provides CLI wrappers and a local socket API for workspaces, tabs, panes, agent prompts, waits, state events and integration management. The binary emits its matching JSON schema.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://herdr.dev/docs/socket-api/
Locator: Choose an integration layer; What you can control
Finding: Herdr provides CLI wrappers and a local socket API for workspaces, tabs, panes, agent prompts, waits, state events and integration management. The binary emits its matching JSON schema.
Retrieved: 2026-11-08

## herdr:ACC-06

Finding: Plugins extend Herdr terminal panes and workflows, with a marketplace and CLI/API management. This does not establish a built-in MCP client.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://herdr.dev/docs/plugins/
Locator: Plugins
Finding: Plugins extend Herdr terminal panes and workflows, with a marketplace and CLI/API management. This does not establish a built-in MCP client.
Retrieved: 2026-11-08

## herdr:ACC-07

Finding: Herdr TUI is a Rust binary running in the user terminal rather than an Electron app. This implementation statement does not describe the newer native app.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://github.com/herdrdev/herdr/blob/ee5bfb5041bb3e4a49d591c72308aae3c81ecdde/README.md
Locator: One Rust binary
Finding: Herdr TUI is a Rust binary running in the user terminal rather than an Electron app. This implementation statement does not describe the newer native app.
Retrieved: 2026-11-08

## herdr:PLAN-01

Finding: Scripts and agents create and name workspaces, tabs and panes. These are terminal sessions rather than evidence of persistent native issue objects.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://herdr.dev/docs/socket-api/
Locator: What you can control
Finding: Scripts and agents create and name workspaces, tabs and panes. These are terminal sessions rather than evidence of persistent native issue objects.
Retrieved: 2026-11-08

## herdr:PLAN-04

Finding: Saved session shape retains workspaces, tabs, panes, current directories, layout, focus and supported native agent session references. Agent reasoning memory remains harness-owned.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://herdr.dev/docs/session-state/
Locator: Snapshot restore
Finding: Saved session shape retains workspaces, tabs, panes, current directories, layout, focus and supported native agent session references. Agent reasoning memory remains harness-owned.
Retrieved: 2026-11-08

## herdr:PLAN-06

Finding: The inspected products store terminal/workspace state rather than an independent issue catalog. No built-in issue entity distinct from a terminal or workspace is implemented in the inspected APIs.

Verification: sourced
Checked: 2026-11-13
Scheduled recheck: 2027-03-13
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app; Herdr native app and herdr-core, separate from Herdr TUI
Version: Herdr TUI v0.9.5, native app 0.1.15 (69ba1cae471da83a652bbaefd97500efe097419c), core d9e68262268b25a33bfe79cabb41fe60baf5db07; targeted first-party pass 2026-11-13; no installed-product test

The scoped first-party source pass does not establish edit, discuss, prioritize, label, assign, search, filter, archive, reopen, project_epic_views, idea_parking, explicit_dispatch, metadata, durable_states, external_tracker_requirement. No hands-on scenario was run.

Source: https://github.com/herdrdev/herdr/blob/2ecf19a92fc3a7fff75b6ce3655ef04f4625ec01/src/api/schema/commands.rs
Locator: TUI src/api and src/state at 2ecf19a; native app src and defaults at 69ba1ca; core crates/herdr-core/src and schema/released.openrpc.json at d9e6826. Searches: issue, backlog, schedule, cron, webhook, pull request, SSO, RBAC.
Finding: The inspected built-in APIs and persisted records organize machines, terminal sessions, workspaces and panes, with no standalone issue catalog, native schedule/webhook trigger service or PR lifecycle operations. User scripts and mods can supply external integrations.
Retrieved: 2026-11-13

## herdr:COORD-01

Finding: Multiple agent terminals run concurrently; working, blocked, done and idle states roll up into tabs and workspaces. Observed concurrency and quotas remain untested.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://herdr.dev/docs/agents/
Locator: Agents; State rollups
Finding: Multiple agent terminals run concurrently; working, blocked, done and idle states roll up into tabs and workspaces. Observed concurrency and quotas remain untested.
Retrieved: 2026-11-08

## herdr:COORD-02

Finding: Agents and scripts can start, prompt and wait on selected panes. agent.prompt refuses to send input when the resolved agent is already blocked. This is pane dispatch rather than task ownership enforcement.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://herdr.dev/docs/socket-api/
Locator: Raw methods
Finding: Agents and scripts can start, prompt and wait on selected panes. agent.prompt refuses to send input when the resolved agent is already blocked. This is pane dispatch rather than task ownership enforcement.
Retrieved: 2026-11-08

## herdr:COORD-03

Finding: Herdr ships an agent skill and CLI that let an agent in a Herdr pane start agents in other panes, prompt them, read their output and wait on their state. The coordinating agent is a third-party CLI using these product-supplied tools.

Verification: sourced
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://herdr.dev/docs/socket-api/
Locator: What you can control; Raw methods
Finding: Herdr supplies agent start, read, prompt and event-driven wait operations to external agents and scripts. A wait pins the current pane occupant; Herdr does not thereby become a product-owned reasoning coordinator.
Retrieved: 2026-11-08

Source: https://github.com/herdrdev/herdr/blob/7573e821895d32c8d1f78b3f6c9a2f85a46df4ac/skills/herdr/SKILL.md
Locator: skills/herdr/SKILL.md, sections on panes and agents
Finding: The shipped skill tells an agent running inside a Herdr pane to use the herdr CLI to inspect neighbouring work, start agents and commands in panes, send input, read output and wait for agent states such as idle, working, blocked and done. It applies when the user asks to use Herdr.
Retrieved: 2026-11-11

## herdr:COORD-04

Finding: No native task scheduler is implemented in the inspected core or TUI API. External scripts can call the CLI, but no built-in event/webhook task trigger service is implemented.

Verification: sourced
Checked: 2026-11-13
Scheduled recheck: 2027-03-13
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app; Herdr native app and herdr-core, separate from Herdr TUI
Version: Herdr TUI v0.9.5, native app 0.1.15 (69ba1cae471da83a652bbaefd97500efe097419c), core d9e68262268b25a33bfe79cabb41fe60baf5db07; targeted first-party pass 2026-11-13; no installed-product test

The scoped first-party source pass does not establish recurring_tasks, completion_conditions, scheduler_location, overlaps, retries, client_independence. No hands-on scenario was run.

Source: https://github.com/herdrdev/herdr/blob/2ecf19a92fc3a7fff75b6ce3655ef04f4625ec01/src/api/schema/commands.rs
Locator: TUI src/api and src/state at 2ecf19a; native app src and defaults at 69ba1ca; core crates/herdr-core/src and schema/released.openrpc.json at d9e6826. Searches: issue, backlog, schedule, cron, webhook, pull request, SSO, RBAC.
Finding: The inspected built-in APIs and persisted records organize machines, terminal sessions, workspaces and panes, with no standalone issue catalog, native schedule/webhook trigger service or PR lifecycle operations. User scripts and mods can supply external integrations.
Retrieved: 2026-11-13

## herdr:COORD-05

Finding: Known agents report or are detected as idle, working or blocked, with notifications when they finish or need input. Detection can fall back to idle for unfamiliar prompts; that is not permission to approve.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://herdr.dev/docs/agents/
Locator: Supported agents; Blocked state
Finding: Known agents report or are detected as idle, working or blocked, with notifications when they finish or need input. Detection can fall back to idle for unfamiliar prompts; that is not permission to approve.
Retrieved: 2026-11-08

## herdr:COORD-06

Finding: The sidebar rolls a blocked pane up to its tab and workspace, and shows active work and done agents until viewed. No six-task fleet scenario was run.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://herdr.dev/docs/agents/
Locator: State rollups
Finding: The sidebar rolls a blocked pane up to its tab and workspace, and shows active work and done agents until viewed. No six-task fleet scenario was run.
Retrieved: 2026-11-08

## herdr:COORD-07

Finding: Users can start one terminal task, split panes, prompt agents and wait on their state through the same CLI/socket control API.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://herdr.dev/docs/socket-api/
Locator: CLI examples
Finding: Users can start one terminal task, split panes, prompt agents and wait on their state through the same CLI/socket control API.
Retrieved: 2026-11-08

## herdr:RUN-01

Finding: Local and saved SSH machines each own their server, sessions and processes. SSH interruptions leave remote work running; clients reconnect independently. The user supplies and pays for the host.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://herdr.dev/docs/connecting-machines/
Locator: Connecting machines
Finding: Local and saved SSH machines each own their server, sessions and processes. SSH interruptions leave remote work running; clients reconnect independently. The user supplies and pays for the host.
Retrieved: 2026-11-08

## herdr:RUN-02

Finding: The TUI socket exposes worktree.list, worktree.create, worktree.open and worktree.remove with workspace provenance. Git worktrees separate checkouts; no hostile-code containment is claimed. Herdr core explicitly runs commands with host-account access and is not a sandbox. User-provided containers are external infrastructure. Herdr supplies no VM isolation boundary. Connecting over SSH to a user-provided VM is own-server execution.

Verification: sourced
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app; Herdr native app and herdr-core, separate from Herdr TUI
Version: Herdr TUI v0.9.5, native app 0.1.15 (69ba1cae471da83a652bbaefd97500efe097419c), core d9e68262268b25a33bfe79cabb41fe60baf5db07; targeted first-party pass 2026-11-13; no installed-product test

The scoped first-party source pass does not establish os_sandbox, filesystem, process, network, secrets, security_boundary. No hands-on scenario was run.

Source: https://herdr.dev/docs/socket-api/
Locator: Raw methods: Worktree
Finding: The TUI socket exposes worktree.list, worktree.create, worktree.open and worktree.remove with workspace provenance. Git worktrees separate checkouts; no hostile-code containment is claimed.
Retrieved: 2026-11-08

Source: https://github.com/herdrdev/herdr/blob/2ecf19a92fc3a7fff75b6ce3655ef04f4625ec01/docs/next/website/src/content/docs/configuration.mdx#L96-L111
Locator: docs/next/website/src/content/docs/configuration.mdx lines 96-111 (Worktrees), tag v0.9.5, commit 2ecf19a
Finding: New worktree creates a Git worktree checkout under a configurable root, checking out an existing local branch or creating it, and opens it as a grouped workspace; delete runs git worktree remove and leaves branches in place.
Retrieved: 2026-11-10

Source: https://github.com/herdrdev/herdr-core/blob/d9e68262268b25a33bfe79cabb41fe60baf5db07/docs/security.md#L1-L55
Locator: What runs; Who can connect; Remote trust
Finding: Core runs commands with the OS account access and explicitly is not a sandbox. There is no API password or per-client permission check; SSH supplies login and core does not authenticate a remote user. This establishes no product-owned roles or enterprise SSO.
Retrieved: 2026-11-13

## herdr:RUN-03

Finding: Detach keeps original processes alive. Server restart loses processes but restores layout, and supported integrations can resume native conversations. Optional pane screen replay is off by default; experimental live handoff is best effort.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://herdr.dev/docs/session-state/
Locator: What survives; Snapshot restore; Native agent session restore
Finding: Detach keeps original processes alive. Server restart loses processes but restores layout, and supported integrations can resume native conversations. Optional pane screen replay is off by default; experimental live handoff is best effort.
Retrieved: 2026-11-08

## herdr:RUN-04

Finding: Restored panes return to saved directories or remain visibly errored if the directory or shell is unavailable. Snapshot restore does not recreate arbitrary services or test processes.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://herdr.dev/docs/session-state/
Locator: Snapshot restore
Finding: Restored panes return to saved directories or remain visibly errored if the directory or shell is unavailable. Snapshot restore does not recreate arbitrary services or test processes.
Retrieved: 2026-11-08

## herdr:RUN-05

Finding: Agent waits have explicit until and timeout_ms controls; an atomic prompt-and-wait avoids the race between separate operations. These are wait limits, not provider token or spend controls.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://herdr.dev/docs/socket-api/
Locator: Raw methods: agent.wait
Finding: Agent waits have explicit until and timeout_ms controls; an atomic prompt-and-wait avoids the race between separate operations. These are wait limits, not provider token or spend controls.
Retrieved: 2026-11-08

## herdr:RUN-06

Finding: State derives from screen manifests or integration reports. herdr agent explain exposes matched rules, source/version and idle fallback reasons. A process failure/approval fixture has not been induced.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://herdr.dev/docs/agents/
Locator: How status works; Blocked state; Detection manifests
Finding: State derives from screen manifests or integration reports. herdr agent explain exposes matched rules, source/version and idle fallback reasons. A process failure/approval fixture has not been induced.
Retrieved: 2026-11-08

## herdr:TEAM-02

Finding: Core has no per-client permission or human role model; local OS account and SSH access govern control. Core does not authenticate remote users itself; it relies on SSH and implements no product-owned enterprise SSO.

Verification: sourced
Checked: 2026-11-13
Scheduled recheck: 2027-03-13
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app; Herdr native app and herdr-core, separate from Herdr TUI
Version: Herdr TUI v0.9.5, native app 0.1.15 (69ba1cae471da83a652bbaefd97500efe097419c), core d9e68262268b25a33bfe79cabb41fe60baf5db07; targeted first-party pass 2026-11-13; no installed-product test

The scoped first-party source pass does not establish project_roles, task_roles, membership, provisioning, unauthorized_access, revocation, plan_scope. No hands-on scenario was run.

Source: https://github.com/herdrdev/herdr-core/blob/d9e68262268b25a33bfe79cabb41fe60baf5db07/docs/security.md#L1-L55
Locator: What runs; Who can connect; Remote trust
Finding: Core runs commands with the OS account access and explicitly is not a sandbox. There is no API password or per-client permission check; SSH supplies login and core does not authenticate a remote user. This establishes no product-owned roles or enterprise SSO.
Retrieved: 2026-11-13

## herdr:TEAM-03

Finding: Remote connection authentication stays with OpenSSH. Saved machine profiles contain labels, target and session, but not passwords or private keys. This does not establish organization roles or SSO.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://herdr.dev/docs/connecting-machines/
Locator: Saved data; Updates
Finding: Remote connection authentication stays with OpenSSH. Saved machine profiles contain labels, target and session, but not passwords or private keys. This does not establish organization roles or SSO.
Retrieved: 2026-11-08

## herdr:TEAM-04

Finding: Optional pane history stores recent terminal output locally and may contain secrets. It is disabled by default and is not an immutable audit log.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://herdr.dev/docs/session-state/
Locator: Pane screen history replay
Finding: Optional pane history stores recent terminal output locally and may contain secrets. It is disabled by default and is not an immutable audit log.
Retrieved: 2026-11-08

## herdr:TEAM-05

Finding: Herdr native app ships a Changes panel for reviewing Git file changes and diffs. This does not establish a TUI diff interface or a structured approval queue.

Verification: sourced
Checked: 2026-11-13
Scheduled recheck: 2027-03-13
Plan: Not specified
Surface: Herdr native app and herdr-core, separate from Herdr TUI
Version: Herdr TUI v0.9.5, native app 0.1.15 (69ba1cae471da83a652bbaefd97500efe097419c), core d9e68262268b25a33bfe79cabb41fe60baf5db07; targeted first-party pass 2026-11-13; no installed-product test

The scoped first-party source pass does not establish pending_reviews, evidence_navigation, comments, request_changes, shipping_guidance, effort, missed_evidence, keyboard, narrow_screen, context_switching, roles, retained_context. No hands-on scenario was run.

Source: https://herdr.dev/docs/agents/
Locator: State rollups
Finding: The sidebar helps find agents needing attention and jump to the relevant terminal. A product code-diff review interface was not established.
Retrieved: 2026-11-08

Source: https://github.com/herdrdev/herdr-app/blob/69ba1cae471da83a652bbaefd97500efe097419c/defaults/mods/changes/main.js#L75-L138
Locator: Shipped Changes mod lines 75-138; CHANGELOG.md records Changes diff fixes in the released app
Finding: The native app ships a Changes panel that lists changed files and additions/deletions, runs git diff against HEAD and renders selected-file hunks. It limits previews to 1500 lines and reports binary or unreadable files. This is a native-app feature, separate from the TUI.
Retrieved: 2026-11-13

## herdr:TEAM-06

Finding: Herdr TUI lets one client own a terminal at a time; herdr agent attach and terminal attach accept --takeover to replace the current owner. It is terminal input ownership, not verified authorized colleague workflow takeover.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://herdr.dev/tui/docs/cli-reference/
Locator: herdr agent attach; herdr terminal attach
Finding: Herdr TUI lets one client own a terminal at a time; herdr agent attach and terminal attach accept --takeover to replace the current owner. It is terminal input ownership, not verified authorized colleague workflow takeover.
Retrieved: 2026-11-08

## herdr:SHIP-01

Finding: Optional local pane-history replay preserves recent terminal contents after restart. A task/revision-linked artifact library was not found.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://herdr.dev/docs/session-state/
Locator: Pane screen history replay
Finding: Optional local pane-history replay preserves recent terminal contents after restart. A task/revision-linked artifact library was not found.
Retrieved: 2026-11-08

## herdr:SHIP-03

Finding: Herdr TUI creates, opens and removes Git worktrees from the sidebar and socket API, checking out or creating the named branch. Commit, pull request, CI and rebase handling were not found in the checked sources. No product-owned PR creation or management operation is implemented in the inspected built-in clients and APIs.

Verification: sourced
Checked: 2026-11-10
Scheduled recheck: 2026-12-10
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app; Herdr native app and herdr-core, separate from Herdr TUI
Version: Herdr TUI v0.9.5, native app 0.1.15 (69ba1cae471da83a652bbaefd97500efe097419c), core d9e68262268b25a33bfe79cabb41fe60baf5db07; targeted first-party pass 2026-11-13; no installed-product test

The scoped first-party source pass does not establish commits, comments, ci_response, rebase, conflicts, product_state. No hands-on scenario was run.

Source: https://herdr.dev/docs/socket-api/
Locator: Raw methods: Worktree
Finding: The TUI socket exposes worktree.list, worktree.create, worktree.open and worktree.remove with workspace provenance. Git worktrees separate checkouts; no hostile-code containment is claimed.
Retrieved: 2026-11-08

Source: https://github.com/herdrdev/herdr/blob/2ecf19a92fc3a7fff75b6ce3655ef04f4625ec01/docs/next/website/src/content/docs/configuration.mdx#L96-L111
Locator: docs/next/website/src/content/docs/configuration.mdx lines 96-111 (Worktrees), tag v0.9.5, commit 2ecf19a
Finding: New worktree creates a Git worktree checkout under a configurable root, checking out an existing local branch or creating it, and opens it as a grouped workspace; delete runs git worktree remove and leaves branches in place.
Retrieved: 2026-11-10

Source: https://github.com/herdrdev/herdr/blob/2ecf19a92fc3a7fff75b6ce3655ef04f4625ec01/src/api/schema/commands.rs
Locator: TUI src/api and src/state at 2ecf19a; native app src and defaults at 69ba1ca; core crates/herdr-core/src and schema/released.openrpc.json at d9e6826. Searches: issue, backlog, schedule, cron, webhook, pull request, SSO, RBAC.
Finding: The inspected built-in APIs and persisted records organize machines, terminal sessions, workspaces and panes, with no standalone issue catalog, native schedule/webhook trigger service or PR lifecycle operations. User scripts and mods can supply external integrations.
Retrieved: 2026-11-13

## herdr:OWN-01

Finding: Herdr TUI source is distributed under Apache License 2.0 at the pinned repository revision. The current site also describes the native app and herdr-core as Apache 2.0, without establishing identical runtime behavior.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2027-02-06
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://github.com/herdrdev/herdr/blob/ee5bfb5041bb3e4a49d591c72308aae3c81ecdde/LICENSE
Locator: Apache License 2.0
Finding: Herdr TUI source is distributed under Apache License 2.0 at the pinned repository revision. The current site also describes the native app and herdr-core as Apache 2.0, without establishing identical runtime behavior.
Retrieved: 2026-11-08

## herdr:OWN-02

Finding: The full TUI and its server can be built from source and run on the user machine or SSH host. This is self-hosting of the TUI, not a managed worker-only arrangement.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://github.com/herdrdev/herdr/blob/ee5bfb5041bb3e4a49d591c72308aae3c81ecdde/README.md
Locator: Development; Install
Finding: The full TUI and its server can be built from source and run on the user machine or SSH host. This is self-hosting of the TUI, not a managed worker-only arrangement.
Retrieved: 2026-11-08

## herdr:OWN-03

Finding: Session data and optional pane history are stored in the local Herdr state directory; history may contain prompts or secrets and is off by default. This does not establish telemetry policy for every component. The native desktop app sends one anonymous daily usage report with fixed counts and agent/layout names, excludes terminal content, file names and prompts, and offers a Settings control to turn reports off. Reports are retained for three months. The phone apps state no tracking or analytics. This policy does not describe TUI telemetry.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app; Herdr native app and herdr-core, separate from Herdr TUI
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://herdr.dev/docs/session-state/
Locator: Pane screen history replay; Snapshot restore
Finding: Session data and optional pane history are stored in the local Herdr state directory; history may contain prompts or secrets and is off by default. This does not establish telemetry policy for every component.
Retrieved: 2026-11-08

Source: https://herdr.dev/privacy/
Locator: The desktop app; What we keep
Finding: The native desktop app sends one anonymous daily usage report with fixed counts and agent/layout names, excludes terminal content, file names and prompts, and offers a Settings control to turn reports off. Reports are retained for three months. The phone apps state no tracking or analytics. This policy does not describe TUI telemetry.
Retrieved: 2026-11-08

## herdr:OWN-04

Finding: The vendor states the native app, herdr-core and Herdr TUI are free and open source. Underlying agent subscriptions and user host costs remain separate.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-11-22
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://herdr.dev/
Locator: Is it free?
Finding: The vendor states the native app, herdr-core and Herdr TUI are free and open source. Underlying agent subscriptions and user host costs remain separate.
Retrieved: 2026-11-08

## herdr:OWN-06

Finding: The October 14 release fixes prefix shortcuts, Codex integration warnings, blocked Claude questions and Windows issues. Open issues include restoration directories, SSH key prompt rendering and terminal behavior; reported bugs are not treated as universal failures.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-11-22
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://github.com/herdrdev/herdr/releases/tag/v0.9.5
Locator: v0.9.5 hotfix
Finding: The October 14 release fixes prefix shortcuts, Codex integration warnings, blocked Claude questions and Windows issues. Open issues include restoration directories, SSH key prompt rendering and terminal behavior; reported bugs are not treated as universal failures.
Retrieved: 2026-11-08

## herdr:OWN-08

Finding: The app, core and TUI are offered free and open source. The user still supplies compute and any paid coding-agent account.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-11-22
Plan: Not specified
Surface: Herdr TUI terminal client and background server, distinct from the new Herdr native app
Version: Public documentation retrieved 2026-11-08

Documentation evidence only. Remaining atomic questions and enforcement under failure have not been established by a bounded workflow test.

Source: https://herdr.dev/
Locator: Is it free?
Finding: The app, core and TUI are offered free and open source. The user still supplies compute and any paid coding-agent account.
Retrieved: 2026-11-08