Notifications via OSC 777 don't work when Claude Code runs hooks in a non-TTY subprocess

Đang mở
  • Có gì không ổn?
#36 2 bình luận 2 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
35/100
Loại issue
Tính năng
Độ rõ ràng
Cần làm rõ
Mức độ hoạt động
Ít trao đổi
Công nghệ
shell
Lĩnh vực
cli, devtools

Hướng nghiên cứu

Start with warp-notify.sh and its should_use_structured() path, then reproduce a Stop, PromptSubmit, or PostToolUse hook under the non-TTY Claude Code subprocess conditions described. Compare the proposed notification transports and establish which one the project will implement; done means notifications reach Warp from these hooks without relying on the subprocess TTY.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Problem

The Warp plugin for Claude Code sends terminal notifications using OSC 777 escape sequences
(\033]777;notify;...) written directly to /dev/tty. However, Claude Code executes hook scripts as
child subprocesses that are not attached to a TTY — their stdin/stdout/stderr are all
redirected (stdin → /dev/null, stdout/stderr → temp files).

As a result, all notification writes fail silently:

  1. printf '...' > /dev/tty → No such device or address
  2. >&2 (stderr fallback) → captured by Claude Code harness, never reaches terminal
  3. >&1 (stdout fallback) → same, captured
  4. || true → all errors swallowed silently

Reproduction

  1. Install Warp terminal + Claude Code with the claude-code-warp plugin
  2. Run any task in Claude Code
  3. The Stop/PromptSubmit/PostToolUse hooks fire, but no notification appears in Warp

Environment

  • Warp: v0.2026.04.29.08.57.stable_02
  • WARP_CLI_AGENT_PROTOCOL_VERSION=1
  • WARP_CLIENT_VERSION=v0.2026.04.29.08.57.stable_02
  • Platform: Windows 11 (WSL/MINGW64)
  • Claude Code hook subprocess: stdin→/dev/null, stdout→temp file, stderr→temp file

Root Cause

Claude Code's hook execution model redirects all FDs of child processes. OSC 777 sequences written by
the hook subprocess cannot reach the Warp terminal because:

  • The subprocess has no TTY of its own
  • stdout/stderr are piped to Claude Code's internal harness, not to the terminal

Proposed Solutions

Option 1: Warp CLI notification command (recommended)

Provide a warp notify (or similar) CLI command that hook subprocesses can invoke. The CLI
communicates with the Warp terminal via IPC/shared memory to deliver the notification, bypassing the
TTY requirement entirely.

# Instead of:
printf '\033]777;notify;...' > /dev/tty

# Use:
warp notify --title "Task Complete" --body "..."

Option 2: Claude Code host forwards OSC sequences

Claude Code's main process (which IS connected to the Warp terminal via the Warp pipe) could parse
hook subprocess stderr output for OSC 777 sequences and forward them to the terminal.

Option 3: Use Claude Code's built-in notification mechanism

If Claude Code exposes a structured way for hooks to request notifications (e.g., via JSON output with
 a notification field), Warp could handle rendering those directly.

Additional Context

The warp-notify.sh script already handles version detection and graceful fallback via
should_use_structured(), so the notification infrastructure is sound — it just needs a transport
mechanism that works from non-TTY subprocesses.
Ngôn ngữ chính
Shell
Star
234
Fork
59
Merge trung bình
2 ngày 8 giờ
Pull request đã merge (30 ngày)
2

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của warpdotdev/claude-code-warp

Tất cả issue của warpdotdev/claude-code-warp

Issue tương tự

Thêm issue về Shell/Bash

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.