Skip to main content

Watch Command

The watch command monitors your project for changes and automatically regenerates the context file.

Basic Usage

argus watch .

How It Works

  1. Performs an initial scan
  2. Watches for file changes using filesystem events
  3. Re-analyzes and updates CLAUDE.md when changes are detected
  4. Uses debouncing to avoid excessive regeneration

Options

FlagShortDescription
--verbose-vShow detailed output
--output-oCustom output file path

Example

$ argus watch .
👁️ Watching /my-project for changes...
🔍 Initial scan complete
📄 Generated CLAUDE.md

# Make some changes to your code...

🔄 Changes detected, re-scanning...
✅ Updated CLAUDE.md

When to Use Watch

  • During active development when project structure changes frequently
  • When onboarding to understand how the codebase evolves
  • When experimenting with different architectures

Stopping Watch

Press Ctrl+C to stop watching.

^C
👁️ Stopped watching