# NousResearch/hermes-agent · Shell hooks allowlist: docs gap and non-TTY feature

## Open now

- 0 issues, 1 PR open on GitHub.
- PR #31483: feat(hooks): add hermes hooks allow for non-TTY allowlisting

These items concern undocumented or unintuitive allowlist file formats and the absence of a non-interactive command for selectively allowing shell hooks. They span a documentation gap, a silent failure report, and a related feature addition.

## TL;DR

- 4 member(s): 0 open issue(s), 2 closed issue(s), 1 open PR(s), 0 merged PR(s), 1 PR(s) closed without merging.
- No fix has been merged to main; one or more PRs were attempted (see below).
- **Recommended:** review the prior/competing PR(s) below. A fix was attempted but not merged; your case may extend or revive that work.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `unresolved`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_PARTIAL`): some members are connected by structural evidence (shared changed files, or a closing/superseded reference); the rest are joined by an automated relevance judgement over their text.
- Members outside that structural core may belong to a different underlying problem.
- Pairwise link density `0.39`: the share of member pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. `1.00` means every pair is linked.

## Closed / duplicate issues

- #31479: \`hermes hooks allow\` command does not exist in v0.14.x; no documented path for non-TTY selective allowlisting
- #31482: shell-hooks-allowlist.json internal format not documented; intuitive format silently does not work

## Prior & competing PRs

- **#31483: feat(hooks): add hermes hooks allow for non-TTY allowlisting**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`
  - files: `agent/shell_hooks.py`, `hermes_cli/hooks.py`, `hermes_cli/main.py`, `tests/hermes_cli/test_hooks_allow_31479.py`, `website/docs/reference/cli-commands.md`, `website/docs/user-guide/features/hooks.md`
- **#31650: docs: document shell hook allowlist format**. closed without merge
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`; refs `fa53e36438e0cbab92365f5a37a78433b2332a3b`

## Fix status

- No merged fix on record.
- Subsystem: `docs`