Herdr Auto Title plugin
A Herdr plugin that names tabs and panes from the directory, Git branch and agent activity so sessions stay distinct.
- 287 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Reads local agent session files to determine the work topic.
- On first start renames every pane, including those named by hand.
Install
- Works in
Manual install
herdr plugin install kryptamine/herdr-auto-title --ref v0.19.0
herdr plugin action invoke herdr.auto-title.restartThe first README option. The second line starts the plugin now, otherwise it starts with the Herdr server.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Reads local agent session files to determine the work topic.
- On first start renames every pane, including those named by hand.
This is third-party code. Review the repository files before installing.
What it does
Herdr Auto Title, a plugin for the Herdr terminal multiplexer, gives tabs and panes meaningful names. The title is built from the directory, Git branch, running program and the agent's work topic, for example `2 · dashboard › MC-13200` or `4 · dashboard › Implement OAuth scopes`. The leading number matches the key that switches to the tab. To learn what the agent is doing, the plugin reads session files of Claude Code, Codex and others. Each pane gets its own name, so Herdr's goto panel no longer lists ten identical `claude` panes. A tab or pane renamed by hand is left alone.
Who it is for. People running several Claude Code and Codex sessions in Herdr who lose track of which tab works on which task.
Good fit when
- Six tabs with agents run at once and the name `claude` does not say which task is where.
- Branches like `bugfix-asa-cpanel-uapi-mc-13675` should shorten to `MC-13675` in the title.
- You want to see the active tab's work topic in the Herdr sidebar.
- An SSH session to a server and an editor in a neighboring pane get clear names automatically.
Not a fit when
- Sessions run in tmux or a plain terminal and Herdr is not installed.
- You set tab and pane names by hand and want nobody to change them.
- Agent session files must not be read even locally.
Example request
Show how Herdr tabs with agents are named and explain how to enable the agent status prefix and hide the branch.Limitations
Herdr 0.8.2 or newer and Go 1.24 or newer are required, since Herdr builds the plugin from source on install. On first start the plugin renames every pane, including those you named by hand earlier. For the title to come from the agent session, install Herdr's integration for each agent, for example `herdr integration install claude`. On Windows Herdr reports only the shell or a recognized agent, so an editor or ssh does not name the tab. Session files are read when `HERDR_AUTO_TITLE_TRANSCRIPT=true`, which is the default.
How to disable. Disable the plugin with the `herdr plugin` tools and restart Herdr. Delete the settings file `~/.config/herdr-auto-title/config.env` and `manual-names.json` by hand.
FAQ
How do I install the plugin?
Run `herdr plugin install kryptamine/herdr-auto-title --ref v0.19.0`, then `herdr plugin action invoke herdr.auto-title.restart`. The second command starts the plugin now, otherwise it starts the next time the Herdr server starts.
What if I named a tab by hand?
Nothing: the plugin stops touching it. Clear the name and the tab returns to Auto Title.
How do I update the plugin?
Repeat both install commands with the newer release tag and your settings stay. Leave the tag out to take `main`, which can be ahead of the release.
Where are the settings?
Copy `config.env.example` to `~/.config/herdr-auto-title/config.env` and uncomment what you need, for example `HERDR_AUTO_TITLE_MAX_LENGTH` or `HERDR_AUTO_TITLE_BRANCH_MAX`. Restart the plugin after editing.
Is Herdr integration for agents needed?
It is recommended: it tells the plugin which session a pane holds so the tab is named after it. Without it a tab shows only the terminal title the agent sets.
Discussion
No questions or reviews yet.
Related
Pluginsherdr-agent-usage (senna-lang)
herdr-agent-usage
A Herdr plugin with a limits pane: context fill, prompt cache and remaining subscription allowance for each agent.
A local dashboard for Claude Code and Codex sessions: who is working, who waits for you, plus a 3D aquarium and Stream Deck
A plugin that teaches Claude Code and Codex to drive the agterm macOS terminal via agtermctl: sessions, panes, overlays, status
Skills for the Harness CI/CD platform: pipelines, connectors, feature flags, security and cost from a chat with an agent
A Claude Code plugin marketplace for MSPs covering PSA, RMM, documentation, security and accounting, with 70-plus plugins.
A Zellij sidebar showing the status of Claude Code, Codex and other agents per tab: working, waiting, done or failed
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| Herdr Auto Title (this card) | no | 287 | |
| herdr | no | 50,721 | the terminal multiplexer for agents itself; the plugin only names its tabs and panes |
| herdr-reviewr | no | 990 | shows the agent's code diff beside the chat; Auto Title handles only tab and pane names |
README in short
The plugin builds the name from the directory, Git branch, program and agent topic, shortens branches to the task identifier and leaves manual renames untouched.