skills.rest
cagriy
cagriyCOMMUNITY
Explore all skills by this author →
GitHub

set-herdr-label

Renames the current herdr agent pane with a normalized label.

Updated May 26, 2026
Search Tags:#cli#session management#terminal#rename#agent workspace#herdr#pane label
One-click install
npx skills add https://github.com/cagriy/dev-skills --skill set-herdr-label-cagriy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: set-herdr-label
Source: https://github.com/cagriy/dev-skills/tree/main/skills/set-herdr-label
Command: npx skills add https://github.com/cagriy/dev-skills --skill set-herdr-label-cagriy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When running multiple AI agent sessions in parallel inside a herdr-managed terminal workspace, every pane looks alike and it becomes hard to tell which agent is doing what. This Skill labels the pane of the current session so the workspace sidebar shows a meaningful name for each agent at a glance. ## Core Features & Use Cases - Pane labeling: Renames the current herdr pane to a normalized form of a free-form label such as "Fix login redirect loop". - Server-safe normalization: Converts arbitrary text into herdr's accepted name format (lowercase, alphanumeric with dashes/underscores, max 32 characters) before calling the CLI. - Label clearing: An empty argument clears the pane label via the --clear flag instead of failing. - Silent and safe: Runs only when HERDR_ENV=1, touches only the current pane via HERDR_PANE_ID, writes no files, and produces no chat output. - Use Case: While starting work on a new feature in one of several parallel agent sessions, invoke the skill with the feature name so the herdr sidebar immediately reflects what that session is doing. ## Quick Start Invoke the set-herdr-label skill with a short task name like "Fix login bug" to label the current herdr pane, or with an empty argument to clear the existing label.

Frequently Asked Questions about set-herdr-label

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I label a herdr agent pane from an AI session?▼

Invoke the skill with the desired label as its only argument, for example "Fix login bug". The skill normalizes the text and runs herdr agent rename against the current pane identified by HERDR_PANE_ID.

How to clear a herdr pane label?▼

Call the skill with an empty or whitespace-only argument. It runs herdr agent rename with the --clear flag, which is the only supported way to unset a pane name; passing an empty string or dash is rejected by herdr.

What name format does herdr accept for agent rename?▼

herdr accepts names matching ^[a-z][a-z0-9_-]{0,31}$: a lowercase letter first, then lowercase letters, digits, dashes, or underscores, up to 32 characters. The skill normalizes any free-form label into this format before renaming.

Does the herdr label skill work outside a herdr terminal?▼

No. The skill checks that HERDR_ENV equals 1 and HERDR_PANE_ID is set; otherwise it skips silently and continues the current task. It is always safe to call in any environment.

Why did my herdr pane label fail to apply?▼

Failures occur when the normalized name is invalid or the herdr socket is unavailable. The skill retries once after re-normalizing on an invalid_agent_name error, then drops the failure silently without interrupting your work.

Related Skills

Explore More Software Engineering Skills→
ian-pascoeian-pascoe
1

herdr

Manage herdr workspaces, tabs, panes, and sibling-agent coordination via CLI.

Community
Advanced
KunCheng-HeKunCheng-He
8

herdr

Coordinate terminal-based coding agents and background processes via a multiplexer interface.

Community
Advanced
podcodarpodcodar
7

terminal-multiplexer

Manage background tmux sessions for long-running terminal commands.

Official
Intermediate
blalorblalor

herdr

Controls Herdr panes, tabs, workspaces, and coding-agent sessions via the installed CLI.

Community
Intermediate