hook notification

Send coordination notifications and track important decisions.

Usage

npx claude-flow hook notification [options]

Options

• --message, -m <text> - Notification message
• --level, -l <level> - Message level (info/warning/error/success)
• --telemetry - Include in telemetry (default: true)
• --broadcast - Broadcast to all agents
• --memory-store - Store in memory

Examples

Basic notification

npx claude-flow hook notification --message "Completed authentication module"

Warning notification

npx claude-flow hook notification -m "Potential security issue found" -l warning

Broadcast to swarm

npx claude-flow hook notification -m "API refactoring started" --broadcast

Decision tracking

npx claude-flow hook notification -m "Chose JWT over sessions for auth" --memory-store

Features

Message Levels

• info - General information
• warning - Important notices
• error - Error conditions
• success - Completion notices

Telemetry Integration

• Tracks key events
• Records decisions
• Monitors progress
• Enables analytics

Agent Broadcasting

• Notifies all agents
• Ensures coordination
• Shares context
• Prevents conflicts

Memory Storage

• Persists decisions
• Creates audit trail
• Enables learning
• Maintains history

Integration

This hook is used by agents for:

• Sharing progress updates
• Recording decisions
• Warning about issues
• Coordinating actions

Manual usage in agents:

# For coordination
npx claude-flow hook notification --message "Starting database migration" --broadcast --memory-store

Output

Returns JSON with:

{
  "message": "Completed authentication module",
  "level": "success",
  "timestamp": 1234567890,
  "telemetryRecorded": true,
  "broadcasted": false,
  "memoryKey": "notifications/success/auth-complete",
  "recipients": ["coordinator", "tester"],
  "acknowledged": true
}

See Also

• agent list - View active agents
• memory usage - Memory storage
• swarm monitor - Real-time monitoring
• telemetry - Analytics tracking