hooks.json: unknown keys (name, description, conditions) trigger a Claude Code load warning
Nobody has claimed this yet.
Assessment
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Newbie friendliness
- 92/100
Research direction
Start with hooks/hooks.json and compare both matcher entries with Claude Code's accepted hook schema. Check hooks-config.json and lsp-hooks.sh to confirm extension filtering remains covered, then verify the warning is gone on plugin load and /reload-plugins without changing hook behavior.
Written by the indexing model from the issue text.
Description
Claude Code 2.1.274 warns at plugin load:
lsp-tools: hooks.json: unknown keys "name" in hooks.PostToolUse[0], "description" in hooks.PostToolUse[0], "conditions" in hooks.PostToolUse[0], "name" in hooks.PreToolUse[0], "description" in hooks.PreToolUse[0] ignored
Plugin: lsp-tools 0.4.0 (via zircote/lsp-marketplace), macOS.
Cause: hooks/hooks.json puts name, description and conditions on the matcher entries. Claude Code's hook schema only accepts matcher and hooks there, so the three keys are dropped and the warning prints on every session start and /reload-plugins.
Impact: cosmetic. The hooks still register and run. conditions.fileExtensions never took effect, but lsp-hooks.sh already filters by extension through hooks-config.json, so behaviour is unchanged.
Suggested fix: remove the three keys from both entries. The extension list is already covered by hooks-config.json; the descriptions can live in the README or a top-level comment field. Removing them locally clears the warning with no change in hook behaviour.
- Dominant language
- Shell
- Stars
- 13
- Forks
- 1
- PR merge metrics
- No merged PRs in 30d
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Similar issues
-
docs(agents): strengthen the no-backslash-escaped-backticks rule with an issue-creation example Open
Difficulty 1/5 Under an hour Newbie friendliness 92/100
-
package-update
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
oSoWoSo/vOid_Community_repOsitory#148 · 1 comment ·
-
chore
Difficulty 1/5 Under an hour Newbie friendliness 91/100
alunduil/alunduil-chezmoi#792 ·
-
area: compat bug
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
-
zenhub-dev
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
OpenLiberty/ci.docker#747 ·