{"version":"2.1.98","anchor":"monitor-tool","canonical_anchor":"monitor-tool","heading":"Monitor Tool","tier":null,"area":null,"scope":null,"heads_up":null,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.98\/e\/monitor-tool","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.98","markdown":"### Monitor Tool\n\n**What**\n\nA new built-in tool that streams events from background scripts as live notifications in the conversation.\n\n**Usage**\n\n`# Inside a Claude Code session, Claude can use the Monitor tool to: # - Tail logs for errors # - Watch for file changes # - Poll GitHub for new PR comments # - Stream events from WebSocket listeners` **Details** - Each stdout line from the script becomes a notification in the conversation - Events arriving within 200ms are batched into a single notification - Supports `persistent: true` mode for session-length watches (PR monitoring, log tails) - Supports `timeout_ms` for time-limited monitoring - Monitors that produce too many events are automatically stopped with guidance to restart using tighter filters - Use `TaskStop` to cancel a running monitor - Distinct from `Bash` with `run_in_background` \u2014 Monitor is for the streaming case (\"tell me every time X happens\"), while background Bash is for one-shot \"wait until done\" **Evidence** MonitorTool definition (search for `\"stream events from a background script as live notifications\"`)"}