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

# monitor

> Track feature development progress in real-time.

```bash theme={null}
wiggum monitor <feature> [options]
```

Monitor a running feature loop without spawning a new one. Shows live progress, activity feed, and diff stats.

In an interactive terminal, `wiggum monitor` opens the TUI automatically. In CI or non-TTY environments, it falls back to headless streaming output.

## Flags

<ParamField path="feature" type="string" required>
  Name of the feature to monitor. Must have an active loop running.
</ParamField>

<ParamField path="--interval" type="number" default="5">
  Refresh interval in seconds for polling loop status.
</ParamField>

<ParamField path="--bash" type="boolean" default="false">
  Use the bash monitor script instead of the built-in monitor.
</ParamField>

<ParamField path="--stream" type="boolean" default="false">
  Force headless streaming output even in a TTY terminal. Skips the TUI.
</ParamField>

## Routing behavior

The monitor command routes to different outputs based on your environment:

| Condition                | Output                  |
| ------------------------ | ----------------------- |
| `--bash` flag            | Bash monitor script     |
| `--stream` flag          | Headless streaming      |
| Interactive TTY (not CI) | TUI with live dashboard |
| Non-TTY or CI            | Headless streaming      |

## Examples

<CodeGroup>
  ```bash Interactive (recommended) theme={null}
  wiggum
  # then type /monitor add-dark-mode in the TUI
  ```

  ```bash Headless theme={null}
  wiggum monitor add-dark-mode --stream --interval 10
  ```
</CodeGroup>