> glossary / hook-event
Hook event
A structured message that an AI coding agent emits at a defined point in its lifecycle. VibeMon's hook endpoint receives these and converts them into XP.
A hook event is a JSON payload that an AI coding agent (Claude Code, Cursor, Gemini CLI, Codex CLI) produces at a hook point — PreToolUse, PostToolUse, Stop, UserPromptSubmit, SessionStart, Notification, or the agent-specific equivalents.
VibeMon's install script configures each supported agent to POST a minimal event payload (event type, timestamp, project hash, agent name) to vibemon.dev/hook. The endpoint records the event, deduplicates within a rate-limit window, awards XP, and returns 200.
Event payloads never include source code, prompts, completions, or file contents. Only the type of event and the identity of the agent reach the server.
Related terms
- XP — The unit of progress in VibeMon. One XP is awarded per eligible hook event from a supported AI coding agent.
- Vibe coding — A programming workflow where a developer prompts an AI coding agent in natural language and reviews the intent of the output rather than the syntax.