PowerShell Title Sync

Sync the outer terminal window/tab title to the focused herdr workspace, tab, and agent session — on Windows, in native PowerShell, with no Bun/Node runtime.

Useful for terminals and clients that track the terminal title (similar to tmux set-titles), so resumed herdr sessions are easy to recognize in the window list.

This is a standalone Windows port of window-title-sync by Joel (Moshi), MIT-licensed. herdr runs no shell on Windows and its bash is WSL, so the original bun sync-title.js cannot drive it there; this plugin ships the same behavior as a pure-PowerShell script (sync-title.ps1) that needs no runtime. If you are on macOS/Linux, use the original cross-platform plugin instead.

Install

herdr plugin install aclima01/herdr-powershell-title-sync

For local development from this folder:

herdr plugin link .

What it shows

The plugin picks the first available title:

1. herdr pane metadata title, when an integration reports one.
2. herdr display agent and custom status.
3. Latest user prompt from local Codex or Claude Code session files.
4. herdr's detected agent name.
5. The focused tab as a fallback, numbered by its switch order (prefix + N).

The focused workspace name is appended in parentheses. Examples:

codex: Implement title sync (app-ios)
claude (app-ios)
tab 2 (app-ios)

Manual refresh

herdr plugin action invoke aclima.powershell-title-sync.refresh

Privacy

The plugin runs locally and sends nothing over the network. As a fallback it reads local Codex and Claude Code session JSONL files to find a useful title when herdr does not expose one directly, so prompt text may appear in your terminal window/tab title.

Requirements

• herdr 0.7.0 or newer, on Windows.
• Windows PowerShell 5.1 (built in). No Bun/Node needed.

Credits

Based on window-title-sync by Joel (Moshi). The title-selection logic mirrors the original sync-title.js field for field; this repo is the Windows/PowerShell port. Licensed MIT (see LICENSE).