# herdr | Can Celik | Knowledge Base | Instagit

agent multiplexer that lives in your terminal.

GitHub Stars: 3.3k

Repository: https://github.com/ogulcancelik/herdr

---

## Articles

### [Herdr Mobile Touch UI Threshold and Layout Adaptation: A Complete Guide](/ogulcancelik/herdr/herdr-mobile-touch-ui-threshold-and-layout-adaptation)

Learn about Herdr mobile touch UI threshold and layout adaptation. Discover how Herdr optimizes its interface for smaller screens with configurable thresholds and precise hit-area calculations. Full guide available.

- Tags: tutorial
- Published: 2026-05-31

### [Herdr Copy Mode Navigation Bindings: Complete Guide to Vim-Style Scrollback Control](/ogulcancelik/herdr/herdr-copy-mode-navigation-bindings)

Master herdr copy mode navigation bindings for efficient scrollback control. Learn Vim-style navigation and text selection to streamline your workflow.

- Tags: how-to-guide
- Published: 2026-05-31

### [How Herdr Checks for New Versions: Inside the Rust Self-Update Mechanism](/ogulcancelik/herdr/how-does-herdr-update-mechanism-check-for-new-versions)

Discover how Herdr checks for new versions using its Rust self-update mechanism. Learn about manifest fetching, semver comparison, and atomic binary replacement.

- Tags: internals
- Published: 2026-05-31

### [How Nested Herdr Detection Is Implemented: Environment Variables and Configuration](/ogulcancelik/herdr/how-is-nested-herdr-detection-implemented)

Learn how nested Herdr detection works using environment variables and configuration settings. Understand the HERDR_ENV=1 variable and allow_nested flag.

- Tags: internals
- Published: 2026-05-31

### [Herdr Pane Scrollback Buffer Management: Architecture and Implementation](/ogulcancelik/herdr/herdr-pane-scrollback-buffer-management)

Explore Herdr pane scrollback buffer management. Learn how Herdr implements a bounded byte buffer with fixed memory limits and persistence across sessions.

- Tags: architecture
- Published: 2026-05-31

### [How Herdr Built-In Agent Integrations Report State](/ogulcancelik/herdr/how-do-herdr-built-in-agent-integrations-report-state)

Learn how Herdr built-in agent integrations report state by checking versioned installation files and comparing against compiled constants for Current, Outdated, or NotInstalled status.

- Tags: internals
- Published: 2026-05-31

### [Herdr Workspace Tab Pane Architecture: Immutable Three-Layer Design](/ogulcancelik/herdr/herdr-workspace-tab-pane-architecture)

Explore the herdr workspace tab pane architecture. Discover its immutable three-layer design for robust state management and efficient terminal operations. Learn how Herdr separates concerns.

- Tags: architecture
- Published: 2026-05-31

### [How Resume Agents on Restore Works in herdr: Native Agent Session Recovery](/ogulcancelik/herdr/how-does-resume-agents-on-restore-work-in-herdr)

Discover how herdr's resume agents on restore flag enables native agent session recovery. Learn about config propagation, command-line plans, and session deduplication.

- Tags: deep-dive
- Published: 2026-05-31

### [When to Use Herdr Headless Server Mode: 5 Key Scenarios](/ogulcancelik/herdr/when-to-use-herdr-headless-server-mode)

Discover when to use Herdr headless server mode for background sessions, remote access, and API automation. Optimize your Herdr deployments with these 5 key scenarios.

- Tags: how-to-guide
- Published: 2026-05-31

### [How Herdr Headless Server Mode Works: Architecture and Event Loop Implementation](/ogulcancelik/herdr/how-does-herdr-headless-server-mode-work)

Discover how Herdr headless server mode operates. Learn about its architecture and event loop, streaming UI frames and handling API requests without a local terminal.

- Tags: architecture
- Published: 2026-05-31

### [Platform Specific Code in herdr src/platform: Linux, macOS and Fallback Implementations](/ogulcancelik/herdr/what-platform-specific-code-is-in-herdr-src-platform)

Discover platform specific code in herdr src/platform. Explore Linux, macOS, and fallback implementations isolating OS-dependent behavior behind a unified Rust API.

- Tags: deep-dive
- Published: 2026-05-31

### [How Herdr Remote Attach Works Over SSH: Architecture and Implementation](/ogulcancelik/herdr/how-does-herdr-remote-attach-work-over-ssh)

Learn how Herdr remote attach works over SSH. Discover its architecture and implementation for seamless remote development and debugging. Explore the SSH tunnel and Unix socket bridge.

- Tags: architecture
- Published: 2026-05-31

### [How Custom Keybinding Strings Are Parsed in Herdr: A Complete Technical Guide](/ogulcancelik/herdr/how-are-custom-keybinding-strings-parsed-in-herdr)

Learn how custom keybinding strings are parsed in Herdr. This technical guide details the TOML to BindingTrigger object conversion, handling modifiers, ranges, and leader keys in Rust.

- Tags: deep-dive
- Published: 2026-05-31

### [How Herdr Live Handoff Transfers Running Panes Between Server Instances](/ogulcancelik/herdr/how-does-herdr-live-handoff-transfer-running-panes)

Learn how Herdr live handoff transfers running panes between server instances by duplicating PTY file descriptors and using Unix SCM_RIGHTS sockets for seamless session replacement.

- Tags: how-to-guide
- Published: 2026-05-31

### [Difference Between Herdr Monolithic Mode and Server-Client Mode](/ogulcancelik/herdr/difference-between-herdr-monolithic-mode-and-server-client-mode)

Discover the difference between Herdr monolithic mode and server client mode. Understand how each architecture impacts your workflow with this clear explanation.

- Tags: deep-dive
- Published: 2026-05-31

### [How to Use the Herdr Unix Socket API for External Agents](/ogulcancelik/herdr/how-to-use-herdr-unix-socket-api-for-external-agents)

Learn how to use the Herdr Unix socket API for external agents. Connect and exchange JSON messages via the newline-delimited interface to extend Herdr's functionality.

- Tags: how-to-guide
- Published: 2026-05-31

### [How Herdr Session Persistence Restores Panes: Complete Restoration Pipeline Explained](/ogulcancelik/herdr/how-does-herdr-session-persistence-restore-panes)

Discover how Herdr session persistence restores panes by deserializing JSON, remapping IDs, and reconstructing TerminalRuntimes. Learn the complete restoration pipeline.

- Tags: deep-dive
- Published: 2026-05-31

### [SemanticFrame vs TerminalAnsi in herdr: Understanding Render Encoding Differences](/ogulcancelik/herdr/difference-between-semanticframe-and-terminalansi-render-encoding-herdr)

Explore the distinct render encoding differences between SemanticFrame and TerminalAnsi in herdr. Understand how each transmits frame data for client-side rendering or direct terminal output.

- Tags: deep-dive
- Published: 2026-05-31

### [Herdr Wire Protocol Version Negotiation: How the Handshake Works](/ogulcancelik/herdr/how-does-herdr-wire-protocol-handle-version-negotiation)

Learn how Herdr wire protocol handles version negotiation with its explicit binary handshake. Discover the client Hello message and server Welcome response.

- Tags: internals
- Published: 2026-05-31

### [How ogulcancelik/herdr Server Client Architecture Works: A Deep Dive](/ogulcancelik/herdr/how-does-ogulcancelik-herdr-server-client-architecture-work)

Explore the ogulcancelik/herdr server client architecture. Learn how this headless server manages state and communicates with clients using JSON-RPC and binary frame streaming.

- Tags: deep-dive
- Published: 2026-05-31