Herdr Sidebar Config banner
testy-cool testy-cool

Herdr Sidebar Config

Productivity community

Description

Workspace → tab → agent sidebar preset for Herdr, with compact single-tab groups, readable task labels, and provider icons.

Installation

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

README

Herdr Sidebar Config

**See what each agent is doing, grouped by workspace and tab.**

A [Herdr](https://herdr.dev) sidebar preset: **workspace → tab → agent**, with readable task labels and provider icons. Single-tab workspaces stay compact; multiple tabs get a tree. Includes the configuration, icon font, and companion plugin that keeps the rows current. No Herdr fork or font build required.

![Herdr Sidebar showing two tabs under herdr-sidebar and a compact icon-font workspace](docs/sidebar.png)

*Actual Herdr 0.8.2 rendering in Ghostty 1.3.1. Agent names, tasks, and states are demonstration data in a separate session; the plugin and renderer are real.*

Install

Requires **Herdr 0.8.2 or later**, **Python 3.11+**, and Git. The icon setup targets Ghostty on Linux or macOS. Linux/Ghostty has been tested live; macOS paths are provided but have not been tested in a live terminal.

Run inside a Herdr terminal pane:

git clone https://github.com/testy-cool/herdr-sidebar-config.git
cd herdr-sidebar-config
python3 setup_sidebar.py install
python3 setup_sidebar.py doctor

Open a **fresh Ghostty process** to load the newly installed font. Your Herdr session keeps running; attach to it from that process. A new tab in an existing Ghostty process may still use its old font cache.

Want to inspect the changes first? Run `python3 setup_sidebar.py install --dry-run`. For another terminal, run `python3 setup_sidebar.py install --text` to use short provider labels such as `AI` and `C`, with no font or Ghostty changes.

Setup links this checkout as a plugin, replaces the agent sidebar layout, sets workspace sorting, and backs up modified files. It preserves other Herdr settings. Keep the checkout where you installed it. See [setup details](docs/setup.md) for custom paths, manual installation, and troubleshooting.

What changes

  • One tab: agents sit directly beneath their workspace name.
  • Multiple tabs: each tab with agents gets a plain heading, with agen