Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Hooks emit raw `jq: command not found` on every turn when jq is absent; no guard or actionable message

Aperta
  • Qualcosa non va?
#87 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
3/5
Tempo stimato
1-2 giorni
Idoneità per principianti
75/100
Tipo di issue
Bug
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
bash, shell
Ambito
cli, tooling

Direzione di ricerca

Reproduce the missing-jq case by removing jq from PATH, then inspect the unguarded call sites in scripts/build-payload.sh, scripts/on-stop.sh, and scripts/emit-terminal-sequence.sh. Ensure hook runs no longer emit repeated raw jq or fallback errors when jq is absent, and provide the expected graceful behavior described in the issue.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Summary

jq is listed under Requirements in the README, but no script checks that it is actually present. When it is missing, every hook invocation leaks raw shell errors into the Claude Code UI on every single turn, and nothing in the output tells the user that jq is the cause.

Observed

On a machine without jq on PATH, each Stop produced:

Stop hook error: Failed with non-blocking status code:
.../scripts/build-payload.sh: line 49: jq: command not found
.../scripts/emit-terminal-sequence.sh: line 82: /dev/tty: No such device or address
.../scripts/emit-terminal-sequence.sh: line 85: jq: command not found

The user is shown a wall of shell noise per turn with no hint that installing jq resolves it. Diagnosing it requires reading the plugin source.

Secondary effect

The absent jq also breaks Claude Code version detection, which pushes emit_terminal_sequence() into the /dev/tty fallback branch. That compounds the noise with the separate redirection defect tracked in #38.

Expected

A single guard at hook entry that degrades gracefully, for example:

if ! command -v jq >/dev/null 2>&1; then
    exit 0
fi

Or, if a visible hint is preferred, one actionable line (claude-code-warp: jq is required, install it with your package manager) instead of a per-turn stack of command not found.

Unguarded jq call sites on current main: build-payload.sh (5), on-stop.sh (4), emit-terminal-sequence.sh (2).

Reproduction
  1. Make sure jq is not on PATH
  2. Enable the plugin in Claude Code
  3. Send any prompt — the errors appear at every Stop
Environment
  • Plugin claude-code-warp v2.2.0
  • Claude Code 2.1.269
  • Warp v0.2026.09.09.08.26.stable.02, Linux, bash 5.2
Workaround

Installing jq through the system package manager silences it.

Lingua principale
Shell
Stelle
232
Fork
56
Merge medio
4g 15h
PR unite (30g)
1

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di warpdotdev/claude-code-warp

Tutte le issue di warpdotdev/claude-code-warp

Issue simili

Altre issue su Shell/Bash

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.