Monitors

Background Monitors

Monitors are background processes Claude Code starts automatically when the plugin is active. They run for the lifetime of the Claude Code session and emit notifications when something interesting happens.

google-ads-anomaly-watch

Polls every: 15 minutes (configurable via GOOGLEADSAGENT_MONITOR_INTERVAL_MS)

Reads from: the google-ads MCP server (live API)

Surfaces:

• CPA spike > 20% vs trailing 7-day average
• CTR drop > 15% vs trailing 7-day average
• Zero-conversion spend > $50 in the last 24 hours
• Budget-limited campaigns with > 80% impression share lost to budget
• Disapproved ads (any)

When an anomaly fires, the monitor prints one line to stdout, which Claude Code shows as a session notification. Buddy can then jump on it without you asking.

Disabling

export GOOGLEADSAGENT_DISABLE_MONITOR=1

Configuring the poll interval

export GOOGLEADSAGENT_MONITOR_INTERVAL_MS=300000   # 5 min

Custom monitors

Drop another entry into monitors/monitors.json:

[
  {
    "name": "budget-alert",
    "command": "node ${CLAUDE_PLUGIN_ROOT}/monitors/budget-alert.js",
    "description": "Alerts when MTD spend > 80% of monthly budget"
  }
]

Each stdout line your script emits becomes a notification.

Implementation source

The default anomaly watcher mirrors the logic from google_ads_anomoly_detection_script, one of the most-used Google Ads Scripts in the itallstartedwithaidea collection.

Source: monitors/anomaly-watch.js