---
title: watcher | CodeWeaver Docs
description: API reference for codeweaver.engine.watcher
url: "https://docs.knitli.com/api/engine/watcher"
type: static
generatedAt: "2026-04-17T17:21:08.614Z"
---

# watcher
       [Open in ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fengine%2Fwatcher%2F.%20I%20want%20to%20ask%20questions%20about%20it.)[Open in Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fengine%2Fwatcher%2F.%20I%20want%20to%20ask%20questions%20about%20it.)[View in Markdown](/codeweaver/api/engine/watcher.md)       [Share on LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fengine%2Fwatcher%2F)[Share on X](https://x.com/intent/tweet?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fengine%2Fwatcher%2F&text=watcher)[Share on Threads](https://threads.net/intent/post?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fengine%2Fwatcher%2F&text=watcher)[Share on Bluesky](https://bsky.app/intent/compose?text=watcher%20https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fengine%2Fwatcher%2F)[Share on Facebook](https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fengine%2Fwatcher%2F)[Share on Reddit](https://reddit.com/submit?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fengine%2Fwatcher%2F&title=watcher)[Share on Hacker News](https://news.ycombinator.com/submitlink?u=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fengine%2Fwatcher%2F&t=watcher)[Share on Email](mailto:?subject=watcher&body=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fengine%2Fwatcher%2F)[Share on WhatsApp](https://wa.me/?text=watcher%20https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fengine%2Fwatcher%2F)[Share on Telegram](https://t.me/share/url?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fengine%2Fwatcher%2F&text=watcher)
# `codeweaver.engine.watcher`
[Section titled “codeweaver.engine.watcher”](#codeweaverenginewatcher)
The `watch` package wraps the `watchfiles` library to provide file system monitoring capabilities integrated with CodeWeaver’s indexing engine. It includes classes for watching files, logging watch events, and tracking indexing progress using Rich.