Skip to content

feat(zsh): add Herdr session completion with fzf-tab preview#34

Merged
fnayou merged 1 commit into
mainfrom
feat/herdr-completion
Jun 24, 2026
Merged

feat(zsh): add Herdr session completion with fzf-tab preview#34
fnayou merged 1 commit into
mainfrom
feat/herdr-completion

Conversation

@fnayou

@fnayou fnayou commented Jun 24, 2026

Copy link
Copy Markdown
Owner

Summary

Herdr ships no native zsh completion, so this authors a guarded _herdr:

  • Dynamic session-name completion (jq, with awk fallback) for herdr --session and herdr session attach|stop|delete.
  • Verified top-level command list (every entry confirmed real on host, incl. config).
  • Read-only fzf-tab session preview (status/dir/socket) — never starts/stops/attaches a session.
  • Guarded by command -v herdr; sourced after compinit (ADR-0049). No-op without herdr.

Files

  • stow/common/zsh/.config/zsh/herdr.zsh (new)
  • stow/common/zsh/.config/zsh/index.zsh (source line, step 6c)
  • stow/common/zsh/README.md (table row + section)
  • Planning docs: PRD 0019, architecture 0019, plan 0022, review 0052

Test

  • zsh -n clean; _herdr/_herdr_sessions defined; compdef registered.
  • jq + awk paths both return real sessions; preview filters correctly.
  • Verified interactively: herdr session attach <Tab> lists sessions with preview.

Notes

No package added/removed/first-stowed → status blocks unchanged.

🤖 Generated with Claude Code

Herdr ships no native zsh completion, so author a guarded _herdr that dynamically completes session names (jq with awk fallback) for 'herdr --session' and 'herdr session attach|stop|delete', plus a verified top-level command list and a read-only fzf-tab session preview. Sourced after compinit; no-op without herdr.

Includes PRD 0019, architecture 0019, plan 0022, review 0052.
@fnayou fnayou merged commit 10549a9 into main Jun 24, 2026
2 checks passed
@fnayou fnayou deleted the feat/herdr-completion branch June 24, 2026 11:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant