claude-vibe-check
v1.1.2
Published
Claude Code hook that reads your face after code changes and adjusts its work based on your reaction
Maintainers
Readme
claude-vibe-check
Claude Code hook that captures your webcam after each response and adjusts its behavior based on your facial expression.
Frustrated? It asks what went wrong. Confused? It explains more. Happy? It keeps going.
Install
npm install -g claude-vibe-check
claude-vibe-check setupRequires a webcam and one of: fswebcam, ffmpeg, or imagesnap (macOS).
How it works
The setup command registers a Stop hook in ~/.claude/settings.json. Every time Claude finishes a response, the hook silently captures a photo and feeds your detected emotion back to Claude as context. A 60-second cooldown prevents it from firing too often.
Modes
Online (default) — sends the photo to Claude for visual analysis.
Offline — runs a local CV model, photo never leaves your machine. Dependencies install automatically.
claude-vibe-check mode offline # uses hsemotion by default
claude-vibe-check mode offline fer # or pick fer backendVibe Stats
Every vibe check in offline mode is logged automatically. Run stats to see your emotion patterns over time, broken down by project, time of day, and daily trends.
claude-vibe-check stats # all time
claude-vibe-check stats today # today only
claude-vibe-check stats week # last 7 days
claude-vibe-check stats my-project # filter by project nameHistory is stored in ~/.config/claude-vibe-check/history.jsonl and can be cleared with claude-vibe-check history clear.
Commands
claude-vibe-check setup Install hook into Claude Code
claude-vibe-check uninstall Remove hook
claude-vibe-check test Test webcam capture
claude-vibe-check status Show current config
claude-vibe-check mode [online|offline] Switch analysis mode
claude-vibe-check cooldown [seconds] Set minimum interval between checks
claude-vibe-check stats [today|week|<project>] Show vibe statistics
claude-vibe-check history clear Clear vibe historyConfig
Stored in ~/.config/claude-vibe-check/config. Can also be set via environment variables VIBE_CHECK_MODE and VIBE_CHECK_COOLDOWN.
Platform support
| OS | Capture tools | |----|--------------| | Linux | fswebcam, ffmpeg (v4l2), gst-launch-1.0 | | macOS | imagesnap, ffmpeg (avfoundation) |
License
MIT
