Watch Mode

Auto-update AGENTS.md when your code changes.

How watch mode works

By default, Aspect Code runs in watch mode. After the initial analysis it monitors your project for file changes and automatically re-analyzes and regenerates AGENTS.md.

aspectcode
# Analyzing project...
# ✓ AGENTS.md written
# Watching for changes...

When you save a file, Aspect Code detects the change, re-runs analysis on affected files, and updates AGENTS.md if needed.

Running without watch mode

To run a one-time analysis without watching:

aspectcode --once

This generates AGENTS.md and exits immediately. Good for CI or scripted workflows.

The terminal dashboard

While running in watch mode, Aspect Code displays a terminal dashboard showing:

Current analysis status

File counts and language breakdown

Hub modules detected

Last regeneration time

The dashboard is also where you can type complaints to improve AGENTS.md (see Complaint Loop).