[BUG] Notification hook input does not match docs (no `title` field)

Resolved 💬 3 comments Opened Jul 3, 2025 by glasser Closed Jul 8, 2025

Environment

  • Platform (select one):
  • [ ] Anthropic API
  • [ ] AWS Bedrock
  • [ ] Google Vertex AI
  • [x] Other: Claude Code
  • Claude CLI version: 1.0.43 (Claude Code)
  • Operating System: macOS 15.5
  • Terminal: VSCode

Bug Description

The documentation of the Notification hook says that the input looks like this:

{
  "session_id": "abc123",
  "transcript_path": "~/.claude/projects/.../00893aaf-19fa-41d2-8238-13269b9b3ca0.jsonl",
  "message": "Task completed successfully",
  "title": "Claude Code"
}

But there does not appear to be a title (and there is a hook_event_name).

Steps to Reproduce

Put this in ~/.claude/settings.json:

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "tee /tmp/notification.json"
          }
        ]
      }
    ]
  }
}

Do anything that causes Claude to send a notification (like, just interact with it).

cat /tmp/notification.json

Expected Behavior

I expected the JSON object in /tmp/notification/json to have a title field.

Actual Behavior

It doesn't:

❯ jq . /tmp/notification.json
{
  "session_id": "8b8adca2-b11b-4c3c-9d09-d87cf54ce321",
  "transcript_path": "/Users/glasser/.claude/projects/-Users-glasser-Projects-Personal-vscode-ledger-mode/8b8adca2-b11b-4c3c-9d09-d87cf54ce321.jsonl",
  "hook_event_name": "Notification",
  "message": "Claude is waiting for your input"
}

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗