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

# fallow watch

> CLI reference for fallow watch. Re-run unused code analysis automatically when files change for continuous feedback during development.

Watch mode re-runs unused code analysis automatically when files change, giving you continuous feedback as you edit.

<Tip>
  Use watch mode during refactoring sessions. Each save immediately re-runs the analysis.
</Tip>

```bash theme={null}
fallow watch
```

Fallow watches your project files and re-analyzes with debouncing when changes are detected. Press `Ctrl+C` to stop.

<Info>
  Watch mode supports all [global flags](/cli/global-flags) (like `--format`, `--production`, `--quiet`). Check-specific flags like `--unused-exports` or `--fail-on-issues` are not available.
</Info>

## Options

All [global flags](/cli/global-flags) are supported:

```bash theme={null}
fallow watch --format compact
fallow watch --production
fallow watch --quiet
```

## Examples

<CodeGroup>
  ```bash Basic watch theme={null}
  fallow watch
  ```

  ```bash Filtered watch theme={null}
  # Production mode
  fallow watch --production

  # Compact output
  fallow watch --format compact

  # Silent, only show results
  fallow watch --quiet
  ```
</CodeGroup>

## Example output

```bash title="$ fallow watch" theme={null}
Watching 1,008 files for changes...

[10:23:15] File changed: src/server/jobs/queue.ts
[10:23:15] Re-analyzing...

● Unused exports (2)
  src/server/jobs/queue.ts
    :61  enqueueJobDelayed
    :206 sweepStuckProcessingJobs
  Exported symbols with zero references — https://docs.fallow.tools/explanations/dead-code#unused-exports

✗ 2 issues (0.04s)

[10:23:42] File changed: src/server/jobs/queue.ts
[10:23:42] Re-analyzing...

No issues found (0.03s) ✓
```

## See also

<CardGroup cols={2}>
  <Card title="Unused code analysis" icon="skull-crossbones" href="/analysis/dead-code">
    How fallow detects unused code.
  </Card>

  <Card title="fallow dead-code" icon="terminal" href="/cli/dead-code">
    Full reference for all options available in watch mode.
  </Card>
</CardGroup>