> ## Documentation Index
> Fetch the complete documentation index at: https://kagi.micr.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# watch

> Monitor a Kagi search query and emit result diffs.

# `kagi watch`

Periodically rerun a search query and emit a diff of added and removed result URLs.

## Synopsis

```bash theme={null}
kagi watch [OPTIONS] <QUERY>
```

## Options

### `<QUERY>`

Search query to monitor.

### `--interval <SECONDS>`

Polling interval. Default: `300`.

### `--count <COUNT>`

Number of polls to run. `0` means run until interrupted.

### `--format <FORMAT>`

Output format for each event: `json`, `toon`, `compact`, or `pretty`.

## Example

```bash theme={null}
kagi watch "kagi-cli release" --interval 600 --count 6
```

The first event reports the initial result set as added. Later events compare URLs against the previous poll.