How samuel-alves-correa/claudinho-panel works
Claudinho is a Claude Code plugin that turns session hooks into a live mascot and usage display. Claude Code events update per-session state and publish JSON; the separate Windows widget reads session files, selects the most urgent live session, and renders the notch, status, and detail bubbles. The README also documents plugin commands, mascot selection, and widget controls. The hook, formatter, mascot palette, and state contract are represented by sampled source; widget rendering and command handling are represented from the README and tree, so their internal links are limited to documented relationships.
Main entry points: register.tsx Hook registration · iniciar-widget.cmd Widget launcher · claudinho-widget.ps1 Notch renderer · format.ts Text formatting
Components 9
Session hooks
- Hook registration
hooks/register.tsx - Text formatting
hooks/format.ts - Mascot palettes
hooks/mascots.ts
Session state
- State contract
types/index.d.ts - Session JSON files
Desktop widget
- Notch renderer
widget/claudinho-widget.ps1 - Widget launcher
widget/iniciar-widget.cmd
Claude Code integration
- Claude Code
Other components
- Claude Code user
Connections 10
- Claude Code user → Claude Code: uses
README.md - Claude Code → Hook registration: dispatches hooks
README.md - Hook registration → Text formatting: formats event data
hooks/register.tsx - Hook registration → Mascot palettes: selects palette
hooks/register.tsx - Hook registration → State contract: updates state
hooks/register.tsx - Hook registration → Session JSON files: writes session JSON
hooks/register.tsx - Session JSON files → Notch renderer: reads and renders
README.md - Claude Code user → Widget launcher: opens widget
README.md - Widget launcher → Notch renderer: starts
- Claude Code user → Hook registration: runs plugin command
README.md