petdex-cc 0.1.2 → 0.1.4

package/README.md

@@ -1,311 +1,311 @@
-<div align="center">
-
-# petdex-cc
-
-**Desktop Pet Companion for Claude Code**
-
-*Animated pets that live on your screen and react to your coding in real-time*
-
-[![npm version](https://img.shields.io/badge/version-0.1.1-8b5cf6?style=flat-square)](https://www.npmjs.com/package/petdex-cc)
-[![platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-0ea5e9?style=flat-square)]()
-[![node](https://img.shields.io/badge/node-%3E%3D18-22c55e?style=flat-square)]()
-[![license](https://img.shields.io/badge/license-MIT-f59e0b?style=flat-square)]()
-[![pets](https://img.shields.io/badge/pets-1%2C569%20available-ec4899?style=flat-square)](https://petdex.crafter.run)
-
-[English](./README.md) · [中文文档](./README_CN.md)
-
-</div>
-
----
-
-## What is petdex-cc?
-
-petdex-cc brings **animated desktop pets** to your Claude Code workflow. Pick any pet from [Petdex](https://petdex.crafter.run/) (1,569+ community pets), install with one command, and your companion appears on your desktop — reading code with you, celebrating completions, cheering you through errors, and growing stronger as you code.
-
-> **How is this different from `npx petdex install`?**
-> The original `petdex` command gives you a basic pet. `petdex-cc` adds a deep **Claude Code integration layer** — hooks into your coding workflow, a level progression system, AI-generated speech, time-aware greetings, and interactive effects. Your pet isn't just decoration — it *lives* in your coding session.
-
-### Features at a glance
-
-- **Real-time reactions** — pet changes animation when you read, edit, run commands, complete tasks, or hit errors
-- **8-level progression** — Byte → Process → Thread → Module → Kernel → Neural → Quantum → Singularity, with escalating visual effects
-- **AI speech bubbles** — context-aware dialogue generated by Claude (or built-in preset lines)
-- **Time-aware greetings** — morning, lunch, afternoon, evening, night, and midnight messages in Chinese
-- **Interactive** — drag your pet anywhere, right-click for menu, rapid-click easter egg
-- **System tray** — show/hide, about, quit from the taskbar
-- **State persistence** — level and event count survive restarts (HMAC-signed, tamper-resistant)
-- **1,569+ pets** — browse [petdex.crafter.run](https://petdex.crafter.run/) and install any community pet
-
----
-
-## Quick Start
-
-### Prerequisites
-
-- [Node.js](https://nodejs.org/) >= 18
-- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed
-
-### Install
-
-```bash
-# 1. Browse pets → https://petdex.crafter.run/
-# 2. Find one you like, note the slug (e.g. "boba")
-# 3. Install:
-
-npx petdex-cc install boba
-```
-
-Your pet appears on the desktop immediately and starts reacting to Claude Code.
-
-### Popular pets
-
-| Slug | Name | Description |
-|---|---|---|
-| `boba` | Boba | Tiny otter sipping bubble tea |
-| `doraemon` | Doraemon | Blue robot-cat from the future |
-| `noir-webling` | Noir Webling | Monochrome spider detective |
-| `ikun-hoops` | IKUN Hoops | Hoodie chick with a basketball |
-| `ddo-zvzo` | ddo-zvzo | Purple mascot with sunglasses |
-| `mochi` | Mochi | Orange-and-white chibi cat |
-
-> Browse all 1,569+ pets at [**petdex.crafter.run**](https://petdex.crafter.run/)
-
----
-
-## What Your Pet Does
-
-Every Claude Code action triggers a pet reaction:
-
-| Claude Code event | Pet animation | Speech bubble |
-|---|---|---|
-| Session starts | Waving | "Let's get to work!" |
-| Reading a file | Review | "Reading filename..." |
-| Editing a file | Idle | "Edited filename" |
-| Running a command | Running | "Running command..." |
-| Searching (Glob/Grep) | Waiting | "Searching..." |
-| Tool fails | Failed | "Oops, something went wrong" + AI encouragement |
-| Task completes | Jumping | "Task complete!" + AI celebration |
-| Claude stops | Jumping | "Task complete!" (60% AI speech) |
-| Claude errors | Failed | Error message + AI comfort |
-| Idle (10+ min) | Waving | Time-aware Chinese greeting |
-| Level up | Current state | "Level up! Kernel!" + all effects activate |
-
-### Pet interactions
-
-- **Drag** — click and drag to move your pet anywhere
-- **Right-click** — context menu with Show/Hide, About, Quit
-- **System tray** — right-click the tray icon for menu
-- **Easter egg** — rapidly click your pet for escalating reactions (2 → 4 → 6 → 9 → 12 → 15 clicks)
-
----
-
-## Level System
-
-Your pet levels up based on cumulative Claude Code events. Each level unlocks new visual effects:
-
-| Lv | Name | Events | Color | Effect |
-|:---:|---|---:|---|---|
-| 1 | **Byte** | 0 | Silver | Base pet |
-| 2 | **Process** | 50 | Green | Breathing glow |
-| 3 | **Thread** | 200 | Blue | Rotating aura ring |
-| 4 | **Module** | 500 | Purple | Enhanced aura |
-| 5 | **Kernel** | 1,000 | Amber | Floating light particles |
-| 6 | **Neural** | 2,000 | Pink | Particle storm |
-| 7 | **Quantum** | 5,000 | Cyan | Energy field |
-| 8 | **Singularity** | 10,000 | Gold | Golden halo + all effects |
-
----
-
-## AI Speech
-
-When an Anthropic API key is available (auto-detected from Claude Code settings or set via `petdex-cc config`), your pet generates **context-aware speech**:
-
-| Scene | Trigger | Example AI response |
-|---|---|---|
-| `task_complete` | Task finishes | "做得好！继续加油！" |
-| `error` | Tool fails | "别担心，bugs难免的~" |
-| `idle` | Idle 10+ minutes | "还在吗？" |
-| `level_up` | Level threshold crossed | "升级啦！太厉害了！" |
-
-- **2-minute cooldown** between AI calls (level-ups bypass this)
-- **5-second timeout** — falls back to preset lines if API is slow
-- **No API key?** Built-in preset lines work great — 7 task lines, 5 error lines, 5 idle lines, 4 level-up lines
-
----
-
-## CLI Reference
-
-```bash
-petdex-cc install <slug>    # Download pet, configure hooks, and launch
-petdex-cc start             # Start the desktop pet
-petdex-cc stop              # Gracefully stop the pet
-petdex-cc list              # Browse all pets from Petdex registry
-petdex-cc switch <slug>     # Switch pets at runtime (downloads if needed)
-petdex-cc status            # Show pet name, level, events, running status
-petdex-cc uninstall         # Remove hooks, stop pet, delete all data
-petdex-cc config [options]  # Configure settings
-```
-
-### Config options
-
-```bash
-petdex-cc config --api-key <key>             # Anthropic API key for AI speech
-petdex-cc config --api-base-url <url>         # API base URL
-petdex-cc config --cooldown <minutes>         # AI call cooldown (default: 2)
-```
-
-> API credentials are auto-detected from `~/.claude/settings.json` — most users don't need manual config.
-
----
-
-## Architecture
-
-```
- ┌─────────────────────────────────────────────────┐
- │                   Claude Code                    │
- │  (tool use, task complete, errors, idle, etc.)   │
- └──────────────────────┬──────────────────────────┘
-                        │ hooks (settings.json)
-                        ▼
-              ┌──────────────────┐
-              │  bridge.ps1/.sh  │  async, 10s timeout
-              └────────┬─────────┘
-                       │ HTTP POST /event
-                       ▼
- ┌─────────────────────────────────────────────────┐
- │               petdex-cc (Electron)               │
- │                                                   │
- │  ┌──────────────┐  ┌──────────┐  ┌────────────┐ │
- │  │ event-mapper  │  │  storage  │  │  ai-speech  │ │
- │  │ event → action│  │ level, XP │  │ Claude Haiku│ │
- │  └──────┬───────┘  └─────┬────┘  └─────┬──────┘ │
- │         │                 │              │         │
- │         └─────────┬───────┘              │         │
- │                   ▼                      │         │
- │         ┌─────────────────┐              │         │
- │         │   IPC to window  │◀─────────────┘         │
- │         └────────┬────────┘                        │
- └──────────────────┼──────────────────────────────────┘
-                    ▼
-          ┌──────────────────┐
-          │  Pet Window (HTML) │  transparent, always-on-top
-          │                    │
-          │  ┌─── sprite ───┐ │  9 animation states
-          │  │   bubble     │ │  3s / 8s auto-dismiss
-          │  │   badge      │ │  Lv tag + color
-          │  │   effects    │ │  glow/aura/particles/halo
-          │  └──────────────┘ │
-          └──────────────────┘
-```
-
----
-
-## Developer Setup
-
-```bash
-git clone https://github.com/devnomad-byte/petdex-cc.git
-cd petdex-cc
-npm install
-npm run build
-
-# Run in dev mode
-npx electron .
-
-# Install globally for CLI
-npm link
-petdex-cc install boba
-```
-
-### Project structure
-
-```
-petdex-cc/
-├── bin/cli.ts                CLI entry point (8 commands)
-├── src/
-│   ├── main/                 Electron main process
-│   │   ├── index.ts          Window creation, event loop, IPC
-│   │   ├── server.ts         HTTP server (hooks → pet, port 17321)
-│   │   ├── ai-speech.ts      AI speech via Anthropic Messages API
-│   │   ├── storage.ts        HMAC-signed state persistence
-│   │   ├── tray.ts           System tray with cat-face icon
-│   │   └── event-mapper.ts   8 hook events → pet actions
-│   ├── renderer/             Electron renderer (pet UI)
-│   │   ├── index.html        Transparent window + CSS effects
-│   │   ├── renderer.ts       IPC coordination + level effects
-│   │   ├── pet-sprite.ts     9-state spritesheet engine
-│   │   ├── bubble.ts         Speech bubble system
-│   │   ├── click-through.ts  Transparent click pass-through
-│   │   ├── drag.ts           Drag + click easter egg
-│   │   └── context-menu.ts   Right-click menu
-│   ├── cli/                  CLI command implementations
-│   ├── hooks/                Claude Code hooks (register/unregister)
-│   │   ├── register.ts       Writes to ~/.claude/settings.json
-│   │   ├── write-scripts.ts  Cross-platform bridge scripts
-│   │   ├── bridge.ps1        Windows PowerShell bridge
-│   │   └── bridge.sh         Unix bash bridge
-│   ├── petdex-api/           Petdex registry client
-│   │   ├── client.ts         Manifest fetch + slug lookup
-│   │   └── download.ts       Streaming download with progress
-│   └── shared/               Shared types and constants
-```
-
----
-
-## Configuration Reference
-
-### Auto-detected settings
-
-petdex-cc reads these from `~/.claude/settings.json` automatically:
-
-| Setting | Used for |
-|---|---|
-| `ANTHROPIC_AUTH_TOKEN` | API key for AI speech |
-| `ANTHROPIC_BASE_URL` | API endpoint for AI speech |
-
-### Manual config
-
-Stored in `~/.petdex-cc/config.json`:
-
-```bash
-petdex-cc config --api-key <key> --api-base-url <url> --cooldown 2
-```
-
-### Data locations
-
-| Path | Contents |
-|---|---|
-| `~/.petdex-cc/pets/<slug>/` | Downloaded spritesheet + pet.json |
-| `~/.petdex-cc/data/state.json` | Level, events, pet slug (HMAC-signed) |
-| `~/.petdex-cc/data/state.sig` | HMAC-SHA256 signature |
-| `~/.petdex-cc/hooks/` | Bridge scripts |
-| `~/.petdex-cc/config.json` | User config (API key, cooldown) |
-
----
-
-## Hooks Reference
-
-petdex-cc registers these hooks in `~/.claude/settings.json`:
-
-| Hook | Matcher | What triggers it |
-|---|---|---|
-| `PostToolUse` | `Read\|Edit\|Write\|Bash\|Glob\|Grep` | After any tool call |
-| `PostToolUseFailure` | — | After a tool call fails |
-| `Stop` | — | Claude finishes a response |
-| `StopFailure` | — | Claude stops with error |
-| `Notification` | `idle_prompt` | User is idle |
-| `SessionStart` | `startup\|resume` | Claude Code launches or resumes |
-| `SessionEnd` | — | Claude Code session ends |
-| `TaskCompleted` | — | A task is marked complete |
-
----
-
-## License
-
-[MIT](./LICENSE)
-
----
-
-<div align="center">
-  <sub>Built for the <a href="https://docs.anthropic.com/en/docs/claude-code">Claude Code</a> community</sub><br />
-  <sub>Pets powered by <a href="https://petdex.crafter.run/">Petdex</a></sub>
-</div>
+<div align="center">
+
+# petdex-cc
+
+**Desktop Pet Companion for Claude Code**
+
+*Animated pets that live on your screen and react to your coding in real-time*
+
+[![npm version](https://img.shields.io/badge/version-0.1.1-8b5cf6?style=flat-square)](https://www.npmjs.com/package/petdex-cc)
+[![platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-0ea5e9?style=flat-square)]()
+[![node](https://img.shields.io/badge/node-%3E%3D18-22c55e?style=flat-square)]()
+[![license](https://img.shields.io/badge/license-MIT-f59e0b?style=flat-square)]()
+[![pets](https://img.shields.io/badge/pets-1%2C569%20available-ec4899?style=flat-square)](https://petdex.crafter.run)
+
+[English](./README.md) · [中文文档](./README_CN.md)
+
+</div>
+
+---
+
+## What is petdex-cc?
+
+petdex-cc brings **animated desktop pets** to your Claude Code workflow. Pick any pet from [Petdex](https://petdex.crafter.run/) (1,569+ community pets), install with one command, and your companion appears on your desktop — reading code with you, celebrating completions, cheering you through errors, and growing stronger as you code.
+
+> **How is this different from `npx petdex install`?**
+> The original `petdex` command gives you a basic pet. `petdex-cc` adds a deep **Claude Code integration layer** — hooks into your coding workflow, a level progression system, AI-generated speech, time-aware greetings, and interactive effects. Your pet isn't just decoration — it *lives* in your coding session.
+
+### Features at a glance
+
+- **Real-time reactions** — pet changes animation when you read, edit, run commands, complete tasks, or hit errors
+- **8-level progression** — Byte → Process → Thread → Module → Kernel → Neural → Quantum → Singularity, with escalating visual effects
+- **AI speech bubbles** — context-aware dialogue generated by Claude (or built-in preset lines)
+- **Time-aware greetings** — morning, lunch, afternoon, evening, night, and midnight messages in Chinese
+- **Interactive** — drag your pet anywhere, right-click for menu, rapid-click easter egg
+- **System tray** — show/hide, about, quit from the taskbar
+- **State persistence** — level and event count survive restarts (HMAC-signed, tamper-resistant)
+- **1,569+ pets** — browse [petdex.crafter.run](https://petdex.crafter.run/) and install any community pet
+
+---
+
+## Quick Start
+
+### Prerequisites
+
+- [Node.js](https://nodejs.org/) >= 18
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed
+
+### Install
+
+```bash
+# 1. Browse pets → https://petdex.crafter.run/
+# 2. Find one you like, note the slug (e.g. "boba")
+# 3. Install:
+
+npx petdex-cc install boba
+```
+
+Your pet appears on the desktop immediately and starts reacting to Claude Code.
+
+### Popular pets
+
+| Slug | Name | Description |
+|---|---|---|
+| `boba` | Boba | Tiny otter sipping bubble tea |
+| `doraemon` | Doraemon | Blue robot-cat from the future |
+| `noir-webling` | Noir Webling | Monochrome spider detective |
+| `ikun-hoops` | IKUN Hoops | Hoodie chick with a basketball |
+| `ddo-zvzo` | ddo-zvzo | Purple mascot with sunglasses |
+| `mochi` | Mochi | Orange-and-white chibi cat |
+
+> Browse all 1,569+ pets at [**petdex.crafter.run**](https://petdex.crafter.run/)
+
+---
+
+## What Your Pet Does
+
+Every Claude Code action triggers a pet reaction:
+
+| Claude Code event | Pet animation | Speech bubble |
+|---|---|---|
+| Session starts | Waving | "Let's get to work!" |
+| Reading a file | Review | "Reading filename..." |
+| Editing a file | Idle | "Edited filename" |
+| Running a command | Running | "Running command..." |
+| Searching (Glob/Grep) | Waiting | "Searching..." |
+| Tool fails | Failed | "Oops, something went wrong" + AI encouragement |
+| Task completes | Jumping | "Task complete!" + AI celebration |
+| Claude stops | Jumping | "Task complete!" (60% AI speech) |
+| Claude errors | Failed | Error message + AI comfort |
+| Idle (10+ min) | Waving | Time-aware Chinese greeting |
+| Level up | Current state | "Level up! Kernel!" + all effects activate |
+
+### Pet interactions
+
+- **Drag** — click and drag to move your pet anywhere
+- **Right-click** — context menu with Show/Hide, About, Quit
+- **System tray** — right-click the tray icon for menu
+- **Easter egg** — rapidly click your pet for escalating reactions (2 → 4 → 6 → 9 → 12 → 15 clicks)
+
+---
+
+## Level System
+
+Your pet levels up based on cumulative Claude Code events. Each level unlocks new visual effects:
+
+| Lv | Name | Events | Color | Effect |
+|:---:|---|---:|---|---|
+| 1 | **Byte** | 0 | Silver | Base pet |
+| 2 | **Process** | 50 | Green | Breathing glow |
+| 3 | **Thread** | 200 | Blue | Rotating aura ring |
+| 4 | **Module** | 500 | Purple | Enhanced aura |
+| 5 | **Kernel** | 1,000 | Amber | Floating light particles |
+| 6 | **Neural** | 2,000 | Pink | Particle storm |
+| 7 | **Quantum** | 5,000 | Cyan | Energy field |
+| 8 | **Singularity** | 10,000 | Gold | Golden halo + all effects |
+
+---
+
+## AI Speech
+
+When an Anthropic API key is available (auto-detected from Claude Code settings or set via `petdex-cc config`), your pet generates **context-aware speech**:
+
+| Scene | Trigger | Example AI response |
+|---|---|---|
+| `task_complete` | Task finishes | "做得好！继续加油！" |
+| `error` | Tool fails | "别担心，bugs难免的~" |
+| `idle` | Idle 10+ minutes | "还在吗？" |
+| `level_up` | Level threshold crossed | "升级啦！太厉害了！" |
+
+- **2-minute cooldown** between AI calls (level-ups bypass this)
+- **5-second timeout** — falls back to preset lines if API is slow
+- **No API key?** Built-in preset lines work great — 7 task lines, 5 error lines, 5 idle lines, 4 level-up lines
+
+---
+
+## CLI Reference
+
+```bash
+petdex-cc install <slug>    # Download pet, configure hooks, and launch
+petdex-cc start             # Start the desktop pet
+petdex-cc stop              # Gracefully stop the pet
+petdex-cc list              # Browse all pets from Petdex registry
+petdex-cc switch <slug>     # Switch pets at runtime (downloads if needed)
+petdex-cc status            # Show pet name, level, events, running status
+petdex-cc uninstall         # Remove hooks, stop pet, delete all data
+petdex-cc config [options]  # Configure settings
+```
+
+### Config options
+
+```bash
+petdex-cc config --api-key <key>             # Anthropic API key for AI speech
+petdex-cc config --api-base-url <url>         # API base URL
+petdex-cc config --cooldown <minutes>         # AI call cooldown (default: 2)
+```
+
+> API credentials are auto-detected from `~/.claude/settings.json` — most users don't need manual config.
+
+---
+
+## Architecture
+
+```
+ ┌─────────────────────────────────────────────────┐
+ │                   Claude Code                    │
+ │  (tool use, task complete, errors, idle, etc.)   │
+ └──────────────────────┬──────────────────────────┘
+                        │ hooks (settings.json)
+                        ▼
+              ┌──────────────────┐
+              │  bridge.ps1/.sh  │  async, 10s timeout
+              └────────┬─────────┘
+                       │ HTTP POST /event
+                       ▼
+ ┌─────────────────────────────────────────────────┐
+ │               petdex-cc (Electron)               │
+ │                                                   │
+ │  ┌──────────────┐  ┌──────────┐  ┌────────────┐ │
+ │  │ event-mapper  │  │  storage  │  │  ai-speech  │ │
+ │  │ event → action│  │ level, XP │  │ Claude Haiku│ │
+ │  └──────┬───────┘  └─────┬────┘  └─────┬──────┘ │
+ │         │                 │              │         │
+ │         └─────────┬───────┘              │         │
+ │                   ▼                      │         │
+ │         ┌─────────────────┐              │         │
+ │         │   IPC to window  │◀─────────────┘         │
+ │         └────────┬────────┘                        │
+ └──────────────────┼──────────────────────────────────┘
+                    ▼
+          ┌──────────────────┐
+          │  Pet Window (HTML) │  transparent, always-on-top
+          │                    │
+          │  ┌─── sprite ───┐ │  9 animation states
+          │  │   bubble     │ │  3s / 8s auto-dismiss
+          │  │   badge      │ │  Lv tag + color
+          │  │   effects    │ │  glow/aura/particles/halo
+          │  └──────────────┘ │
+          └──────────────────┘
+```
+
+---
+
+## Developer Setup
+
+```bash
+git clone https://github.com/devnomad-byte/petdex-cc.git
+cd petdex-cc
+npm install
+npm run build
+
+# Run in dev mode
+npx electron .
+
+# Install globally for CLI
+npm link
+petdex-cc install boba
+```
+
+### Project structure
+
+```
+petdex-cc/
+├── bin/cli.ts                CLI entry point (8 commands)
+├── src/
+│   ├── main/                 Electron main process
+│   │   ├── index.ts          Window creation, event loop, IPC
+│   │   ├── server.ts         HTTP server (hooks → pet, port 17321)
+│   │   ├── ai-speech.ts      AI speech via Anthropic Messages API
+│   │   ├── storage.ts        HMAC-signed state persistence
+│   │   ├── tray.ts           System tray with cat-face icon
+│   │   └── event-mapper.ts   8 hook events → pet actions
+│   ├── renderer/             Electron renderer (pet UI)
+│   │   ├── index.html        Transparent window + CSS effects
+│   │   ├── renderer.ts       IPC coordination + level effects
+│   │   ├── pet-sprite.ts     9-state spritesheet engine
+│   │   ├── bubble.ts         Speech bubble system
+│   │   ├── click-through.ts  Transparent click pass-through
+│   │   ├── drag.ts           Drag + click easter egg
+│   │   └── context-menu.ts   Right-click menu
+│   ├── cli/                  CLI command implementations
+│   ├── hooks/                Claude Code hooks (register/unregister)
+│   │   ├── register.ts       Writes to ~/.claude/settings.json
+│   │   ├── write-scripts.ts  Cross-platform bridge scripts
+│   │   ├── bridge.ps1        Windows PowerShell bridge
+│   │   └── bridge.sh         Unix bash bridge
+│   ├── petdex-api/           Petdex registry client
+│   │   ├── client.ts         Manifest fetch + slug lookup
+│   │   └── download.ts       Streaming download with progress
+│   └── shared/               Shared types and constants
+```
+
+---
+
+## Configuration Reference
+
+### Auto-detected settings
+
+petdex-cc reads these from `~/.claude/settings.json` automatically:
+
+| Setting | Used for |
+|---|---|
+| `ANTHROPIC_AUTH_TOKEN` | API key for AI speech |
+| `ANTHROPIC_BASE_URL` | API endpoint for AI speech |
+
+### Manual config
+
+Stored in `~/.petdex-cc/config.json`:
+
+```bash
+petdex-cc config --api-key <key> --api-base-url <url> --cooldown 2
+```
+
+### Data locations
+
+| Path | Contents |
+|---|---|
+| `~/.petdex-cc/pets/<slug>/` | Downloaded spritesheet + pet.json |
+| `~/.petdex-cc/data/state.json` | Level, events, pet slug (HMAC-signed) |
+| `~/.petdex-cc/data/state.sig` | HMAC-SHA256 signature |
+| `~/.petdex-cc/hooks/` | Bridge scripts |
+| `~/.petdex-cc/config.json` | User config (API key, cooldown) |
+
+---
+
+## Hooks Reference
+
+petdex-cc registers these hooks in `~/.claude/settings.json`:
+
+| Hook | Matcher | What triggers it |
+|---|---|---|
+| `PostToolUse` | `Read\|Edit\|Write\|Bash\|Glob\|Grep` | After any tool call |
+| `PostToolUseFailure` | — | After a tool call fails |
+| `Stop` | — | Claude finishes a response |
+| `StopFailure` | — | Claude stops with error |
+| `Notification` | `idle_prompt` | User is idle |
+| `SessionStart` | `startup\|resume` | Claude Code launches or resumes |
+| `SessionEnd` | — | Claude Code session ends |
+| `TaskCompleted` | — | A task is marked complete |
+
+---
+
+## License
+
+[MIT](./LICENSE)
+
+---
+
+<div align="center">
+  <sub>Built for the <a href="https://docs.anthropic.com/en/docs/claude-code">Claude Code</a> community</sub><br />
+  <sub>Pets powered by <a href="https://petdex.crafter.run/">Petdex</a></sub>
+</div>