Notification System

Automatasaurus includes a notification system to alert the user when their attention is needed.

Automatic Notifications

The system automatically sends notifications on stop based on context:

• Questions: When Claude asks a question and waits for input
• Approvals: When approval is needed to proceed
• Stuck: When an agent encounters an issue
• Complete: When all work is done

Explicit Notification Request

When you need to explicitly alert the user, use:

.claude/hooks/request-attention.sh <type> "<message>"

Notification Types

Examples

# Question needs answering
.claude/hooks/request-attention.sh question "Should I use PostgreSQL or MySQL for this project?"

# Approval needed
.claude/hooks/request-attention.sh approval "PR #42 is ready for review"

# Got stuck
.claude/hooks/request-attention.sh stuck "Cannot access the GitHub API - authentication failed"

# Work complete
.claude/hooks/request-attention.sh complete "All 5 user stories have been implemented and tested"

# Error occurred
.claude/hooks/request-attention.sh error "Build failed with 3 errors"

When to Notify

Always Notify For:

• Questions that block progress
• Security-related approvals
• When you've been stuck for more than one attempt
• Completion of significant milestones
• Errors that require human intervention

Don't Notify For:

• Minor progress updates
• Self-recoverable errors
• Questions you can answer from context

Configuration

Notifications can be configured via environment variables:

# Disable sound
AUTOMATASAURUS_SOUND=false

# Custom log location
AUTOMATASAURUS_LOG=/path/to/custom.log

Platform Support

• macOS: Native notifications with sound
• Linux: Uses notify-send if available
• Windows: PowerShell message box

Logging

All notifications are logged to $AUTOMATASAURUS_LOG (default: /tmp/automatasaurus.log):

[2025-01-02 14:30:45] [question] Automatasaurus: Which database should we use?
[2025-01-02 14:35:12] [complete] Automatasaurus: Feature implementation complete