README.md · herdr-auto-title

git.iko.soy/herdr-auto-title

42 lines 1.5 kB history raw

1# herdr-auto-title

3Auto-title [herdr](https://github.com/ogulcancelik/herdr) tabs from the first user message of a [Hermes Agent](https://hermes-agent.nousresearch.com) session.

5When running Hermes inside a herdr-managed pane, this plugin sets the tab label to the first ~40 characters of your first message — so tabs are named by what you're working on, not just numbered.

7## How it works

9- On `post_llm_call` (first turn only), takes the first line of `user_message`, truncates to 40 chars, and sends a `tab.rename` request to the herdr Unix socket.

10- On `on_session_start`, resets state so each new session gets a fresh title.

11- Uses `HERDR_TAB_ID` and `HERDR_SOCKET_PATH` env vars (set by herdr when launching a pane).

13## Install

15```bash

16mkdir -p ~/.hermes/plugins/herdr-auto-title

17cd ~/.hermes/plugins/herdr-auto-title

18# Download plugin.yaml and __init__.py from this repo

19```

21Then enable it in your Hermes config (`~/.hermes/config.yaml`):

23```yaml

24plugins:

25 enabled:

26 - herdr-agent-state

27 - herdr-auto-title

28```

30**Note:** `plugins.enabled` must be a YAML list, not a comma-separated string. If `hermes config set` writes it as a string, edit `config.yaml` directly.

32Restart Hermes (`/reset` or relaunch `hermes --tui`) for the plugin to load.

34## Requirements

36- [Hermes Agent](https://hermes-agent.nousresearch.com) with plugin support

37- [herdr](https://github.com/ogulcancelik/herdr) v0.7.1+

38- `herdr integration install hermes` must be run first (sets up `HERDR_ENV` etc.)

40## License

42MIT