Skip to content
Monitoring
Hook

Hooks

What agents-observe runs automatically, and when. A hook is a command Claude Code fires at a fixed moment, without you asking for it.

From plugin
agents-observe
6961 skill28 hooks1 MCP
Install
> /plugin marketplace add simple10/agents-observe
> /plugin install agents-observe@agents-observe

Ships with agents-observe. Installing the plugin gets these hooks.

What fires, and when

Setup

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

SessionStart

Fires once when a session begins, and again after a context compaction. It is where a plugin sets up its environment, or restores state the compaction dropped.

  • node ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/observe_cli.mjs hook-autostart

SessionEnd

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

UserPromptSubmit

Fires before Claude sees each prompt you send. A plugin can use it to inject context, so the same instruction reaches the model every turn instead of only at session start.

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

UserPromptExpansion

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

PreToolUse

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

PostToolUse

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

PostToolUseFailure

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

PostToolBatch

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

PermissionRequest

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

PermissionDenied

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

Stop

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

StopFailure

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

SubagentStart

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

SubagentStop

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

TeammateIdle

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

TaskCreated

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

TaskCompleted

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

Notification

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

InstructionsLoaded

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

ConfigChange

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

CwdChanged

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

FileChanged

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

PreCompact

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

PostCompact

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

Elicitation

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

ElicitationResult

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh

WorktreeRemove

  • bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/hook.sh
Read hooks/hooks.json
Ships withagents-observe

Real-time observability dashboard for Claude Code and Codex agents. Includes powerful filtering, searching, and visualization of multi-agent sessions with full replay and token usage stats. Demo video

Get the whole plugin
Stats
696
Stars
73
Forks
Maintained
Maintenance
TypeScript
Language
MIT
License
1mo ago
Last commit
6mo ago
Created
4h ago
Added

Repo: simple10/agents-observe