Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

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

Abierto
  • ¿Algo no está bien?
#87 1 comentario 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
3/5
Tiempo estimado
1-2 días
Aptitud para principiantes
75/100
Tipo de issue
Error
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
bash, shell
Área
cli, tooling

Línea de trabajo

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.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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.

Lenguaje dominante
Shell
Estrellas
232
Forks
56
Merge medio
4 d 15 h
PR fusionados (30 d)
1

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de warpdotdev/claude-code-warp

Todos los issues de warpdotdev/claude-code-warp

Issues similares

Más issues de Shell/Bash

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.