Skillget

herdr-auto-title

skill
Security Audit
Pass
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 21 GitHub stars
Code Pass
  • Code scan — Scanned 2 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Automatically generate titles for herdr tabs from Claude Code and Codex conversations.

README.md

herdr auto title

A hook that turns your Claude Code / Codex conversation into a short title and applies it to the herdr tab name.

日本語版は README.ja.md。

A numbered tab name being rewritten to match the content of the prompt

Titles are generated by the same CLI that called the hook: claude -p for Claude Code, codex exec for Codex.

Requirements

  • Claude Code or Codex running inside a herdr pane (HERDR_ENV=1 is set)
  • python3 (standard library only)
  • claude or codex on your PATH

Started outside of herdr, the hook exits without doing anything.

Install

git clone https://github.com/sh1ma/herdr-auto-title
cd herdr-auto-title
./install.sh              # install into every agent found
./install.sh --codex      # or just one of them

It copies the script into place and registers it on UserPromptSubmit.

script registered in
Claude Code ~/.claude/hooks/herdr-auto-title.py ~/.claude/settings.json
Codex ~/.codex/hooks/herdr-auto-title.py ~/.codex/hooks.json

(CLAUDE_CONFIG_DIR / CODEX_HOME are honoured when set.)

Existing hook settings are kept, and re-running does not duplicate the registration. The settings file is backed up to .bak before being rewritten.

It takes effect from the next session you start.

Codex does not run hooks it has not been told to trust. Trust it on the review screen shown at the next startup, or via /hooks. (What gets trusted is the registered command string, so reinstalling does not ask again unless you move the script.)

Title language

Titles are written in English, or in Japanese when your locale is Japanese — that is, when LC_ALL, LC_MESSAGES or LANG starts with ja.

Set HERDR_AUTO_TITLE_LANG to pin one instead:

value title language
auto (default) follow the locale
en English
ja Japanese

The hook reads it from the environment of the agent that runs it, so export it where you start that agent — for example in ~/.zshrc:

export HERDR_AUTO_TITLE_LANG=en

The new value applies to sessions started after that.

Uninstall

./install.sh --uninstall            # remove from both
./install.sh --uninstall --codex    # or just one

It removes the registration and deletes the installed script. State files (~/.claude/herdr-auto-title/) are left behind; delete them by hand if you do not want them.

License

MIT

Reviews (0)

No results found