# Monitor Tool

> The tool that watches a command and tells Claude each new line.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** Monitor, Background watch, Tail a log

## Think of it like

It is like asking a friend to watch the pot and shout when it boils.

## Definition

The Monitor tool runs a command in the background and sends each new line of output to Claude as it appears. Claude can watch a log file, a CI job or a folder, and act when something changes. It can also listen to a WebSocket feed. You keep working in the same session while it watches. Each watch ends after five minutes by default, and at most thirty. It uses the same permission rules as Bash.

## Example

Jack asks Claude to watch the server log while he clicks around. When an error line appears, Claude points it out and suggests a fix.

## Why it matters

Claude can react to things as they happen, instead of checking again and again.

## Common mistake

Expecting a watch to run forever. It ends at its deadline, and Claude must start it again if it is still needed.

## Three principles

- **Runs in the background.** You keep working.
- **Line by line.** Each new line arrives.
- **Has a deadline.** Five minutes by default.

## Related terms

- [Bash Tool](https://learn.benibix.com/term/ai/bash-tool)
- [Terminal](https://learn.benibix.com/term/infrastructure/terminal)
- [Claude Code Session](https://learn.benibix.com/term/ai/claude-code-session)

## Taught in

- [Bash, WebFetch and WebSearch](https://learn.benibix.com/learn/ai-claude-code/bash-webfetch-and-websearch): Claude Code, 10/16

![Bash runs a command and returns its output. Monitor runs one in the background and sends each new line as it comes.](https://learn.benibix.com/diagrams/ct-shell-tools.svg)

---

Source: https://learn.benibix.com/term/ai/monitor-tool
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
