hermes - 💡(How to fix) Fix zsh completion breaks for compinit/~/.zfunc installs [1 pull requests]

Summary

hermes completion zsh generates an invalid zsh completion script for compinit / ~/.zfunc/_hermes installs.

Two concrete problems showed up on my machine:

1. the generated file ended with _hermes "$@", which is wrong for an autoloaded completion file under compinit
2. the top-level _arguments spec used invalid syntax like:

'(-h --help){-h,--help}[Show help and exit]'

Pressing Tab then produced:

_arguments:comparguments:327: invalid argument: (-h --help){-h,--help}[Show help and exit]

Expected behavior

hermes completion zsh should generate a valid autoloadable zsh completion file that works when saved as ~/.zfunc/_hermes and loaded through compinit.

Repro

mkdir -p ~/.zfunc
hermes completion zsh > ~/.zfunc/_hermes
autoload -Uz compinit
fpath=(~/.zfunc $fpath)
compinit

Then type:

hermes <TAB>

Actual behavior

Completion crashes with:

_arguments:comparguments:327: invalid argument: (-h --help){-h,--help}[Show help and exit]

Notes

This seems most likely to affect users who install zsh completions the standard compinit way instead of eval "$(hermes completion zsh)".

Sanitized environment

• OS: macOS 26.4.1
• Arch: arm64
• zsh: 5.9 (arm64-apple-darwin25.0)
• Hermes: v0.13.0 (2026.5.7)
• Shell setup: zim + powerlevel10k
• Completion install mode: ~/.zfunc/_hermes + compinit