Function watch

src/codegraphcontext/cli/main.py:1595–1637

Watch a directory for file changes and automatically update the code graph. This command runs in the foreground and monitors the specified directory for any file changes. When changes are detected, the code graph is automatically updated. The watcher will: - Perfor

(
    path: str = typer.Argument(".", help="Path to the directory to watch. Defaults to current directory."),
    context: Optional[str] = typer.Option(None, "--context", "-c", help="Specific context to use"),
    poll: bool = typer.Option(
        False,
        "--poll",
        help="Use watchdog's polling observer for Docker bind mounts and network filesystems.",
    ),
    sync_on_start: bool = typer.Option(
        False,
        "--sync-on-start",
        help=(
            "Synchronize already-indexed files before watching. "
            "Defaults off; use 'cgc index --force' for a full re-index."
        ),
    ),
)

@app.command()
def watch(
    path: str = typer.Argument(".", help="Path to the directory to watch. Defaults to current directory."),
    context: Optional[str] = typer.Option(None, "--context", "-c", help="Specific context to use"),
    poll: bool = typer.Option(
        False,
        "--poll",
        help="Use watchdog's polling observer for Docker bind mounts and network filesystems.",
    ),
    sync_on_start: bool = typer.Option(
        False,
        "--sync-on-start",
        help=(
            "Synchronize already-indexed files before watching. "
            "Defaults off; use 'cgc index --force' for a full re-index."
        ),
    ),
):
    """
    Watch a directory for file changes and automatically update the code graph.
    
    This command runs in the foreground and monitors the specified directory
    for any file changes. When changes are detected, the code graph is
    automatically updated.
    
    The watcher will:
    - Perform an initial scan if the directory is not yet indexed
    - Attach immediately for already-indexed directories unless --sync-on-start is passed
    - Monitor for file creation, modification, deletion, and moves
    - Automatically re-index affected files and update relationships
    
    Press Ctrl+C to stop watching.
    
    Examples:
        cgc watch .                    # Watch current directory
        cgc watch /path/to/project     # Watch specific directory
        cgc watch --poll .             # Use polling for Docker/NFS/SMB mounts
        cgc watch --sync-on-start .    # Reconcile current files before watching
        cgc w .                        # Using shortcut alias

    Set CGC_WATCH_POLLING=1 to use polling without passing --poll.
    """
    _load_credentials()
    watch_helper(path, context, use_polling=poll or None, sync_on_start=sync_on_start)

@app.command()
def unwatch(