Skip to content

PK-Herdr next documentation

Install, learn, and configure PK-Herdr. Start on the path that matches you — no multiplexer experience required.

Next docs describe unreleased work from master. Stable docs remain at /docs/.

New to terminal multiplexers?

You don’t need to learn shortcuts to start. PK-Herdr is mouse-first: click panes, drag borders, split and switch from right-click menus.

Quick start →

Coming from tmux or zellij?

You already know the model. The prefix is ctrl+b, panes persist, detach and reattach work the way you expect.

Concepts → · Keybindings →

Already running an AI coding agent? Let it do the onboarding. Paste this prompt:

Help me understand and set up PK-Herdr. Read https://herdr.pkking.computer/agent-guide.md first, then walk me through it step by step.

The guide teaches your agent PK-Herdr’s concepts, setup, configuration, and common fixes, so its answers stay accurate instead of improvised.

Agents

See supported agents, detection behavior, integrations, custom labels, and direct attach.

Understand agents →

Session state

Understand detach, restart restore, pane history replay, native agent resume, and live handoff.

Compare state paths →

Configuration

Configure keybindings, themes, sidebar behavior, notifications, scrollback, and advanced options.

Configure PK-Herdr →

API

Control PK-Herdr from scripts, tools, and agents through the CLI and local socket API.

Read the API guide →

Plugins

Author local executable workflow plugins with manifest actions and event hooks.

Write a plugin →

Marketplace

Share plugins from GitHub today and tag your repo to be listed when the marketplace launches.

Publish a plugin →