gorakhargosh/watchdog
Python library and shell utilities to monitor filesystem events. observed · 2026-08-28
Health v2 · maintenance only
79/100
- Activity 99
- Release rhythm 40
- Longevity 100
How is this computed?
round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-09-03. Adoption (stars, forks) is never an input.
- gap_med: 28.5
- age_days: 5793
- days_rel: 670
- days_push: 7
- n_releases_24m: 3
Adoption not part of the score
7399 stars · 773 forks observed · 2026-08-28
What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded
Watchdog is a Python library and set of shell utilities for monitoring file system events across platforms. It provides a cross-platform Observer API for watching directories and a watchmedo CLI tool that can run commands in response to file changes.
Use cases
- watch a directory for file changes in python
- trigger a command when a file is modified
- auto-reload on file save
- monitor log files for changes
- run tests automatically when source files change
- detect when files are created or deleted in a folder
When to choose
- you need cross-platform filesystem event monitoring in Python
- you want a ready-made CLI to react to file changes with shell commands
- you need recursive directory watching with pattern filtering
When to avoid
- you need distributed or network filesystem watching
- you need event watching outside Python or shell scripting
- you need real-time sync rather than event notification
Facets
library · maturity stable
file-system developer-tools cli workflow-automation developer-tools cross-platform windows bsd python cli cross-platform filesystem-monitoring inotify file-watcher watchmedo event-handling command-line automation linux macos
4 sources
- readme: https://github.com/gorakhargosh/watchdog · fetched 2026-08-28 · d61cc344ebe9
- homepage: http://packages.python.org/watchdog/ · fetched 2026-08-29 · c880c0af85d8
- site_page: https://pythonhosted.org/watchdog/installation.html · fetched 2026-08-29 · 2159c8041903
- site_page: https://pythonhosted.org/watchdog/quickstart.html · fetched 2026-08-29 · b4b9f74ae58a
Member repositories
| Repository | Role | Health v2 |
|---|---|---|
| gorakhargosh/watchdog | main | 79 |
For agents
markdown · JSON · MCP: product_card(name="gorakhargosh/watchdog")
Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem