wyattjoh

Herdr Plugin Renamer — Git skill for Claude Code

Git community

Renames an auto-generated herdr worktree branch and workspace from the agent's first prompt, via on-device Apple FoundationModels or Codex.

How to install Herdr Plugin Renamer

This entry records only its repository, not the path inside it, so there is no exact command to give. Open wyattjoh/herdr-plugin-renamer and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Herdr Plugin Renamer does

Renames an auto-generated herdr worktree branch and workspace from the agent's first prompt, via on-device Apple FoundationModels or Codex.

Alternatives in Git

Clean Worktrees (Automatic) — Automatically remove all worktrees for branches merged into master 25.5k ★
OSS PR — Commit + PR workflow for open source contributions: auto-creates a user-prefixed branch when on main/master, t 19.7k ★
Local Review — You are tasked with setting up a local review environment for a colleague's branch 10k ★

README

herdr-plugin-renamer

A [herdr](https://herdr.dev) plugin that names panes from a coding agent's first prompt. In auto-generated linked worktrees, it also renames the git branch and workspace.

It supports Claude Code, Codex, and Pi. Slugs come from Apple FoundationModels on supported Macs, then Codex, then a deterministic local fallback.

Install

herdr plugin install wyattjoh/herdr-plugin-renamer

GitHub installs run the manifest's Rust and platform-specific build steps before registering the plugin. On macOS, the optional FoundationModels helper is built only when the active Swift toolchain supports its guided-generation macros; otherwise installation continues with the Codex/local fallbacks. Local `herdr plugin link` intentionally does not build; use `just link` from a development checkout instead.

Install the herdr integration for each agent you use:

herdr integration install claude
herdr integration install codex
herdr integration install pi

Requirements

herdr 0.7.4+ on macOS or Linux
For on-device naming: macOS 26+ on Apple Silicon, Apple Intelligence enabled, and a Swift toolchain with FoundationModels guided-generation macro support. Current Command Line Tools omit that macro plugin, so installation skips the optional helper.
For Codex naming: the codex CLI on PATH and logged in

Without either naming model, the plugin derives a rough local slug from the prompt.

What it renames

A prompt about reviewing a cache might rename the pane to `cache-review`. In an auto-generated linked worktree, the plugin can also rename:

branch: /cache-review, or cache-review without a prefix
workspace: cache-review

Branch and workspace renaming only happens when the current branch starts with `worktree/`. The branch rename is local and never pushes to the remote.

Each native agent session is named once, even when its status changes repeatedly. Session identity—not Herdr's reusable compact pane id—owns the