gorakhargosh/watchdog
Python library and shell utilities to monitor filesystem events. observed · 2026-10-15
Health v2 · maintenance only
67/100
- Activity 99
- Release rhythm 8
- Longevity 100
How is this computed?
round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-10-21. Adoption (stars, forks) is never an input.
- gap_med: n/a
- age_days: 5841
- days_rel: 718
- days_push: 7
- n_releases_24m: 1
Adoption not part of the score
7422 stars · 797 forks observed · 2026-10-15
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-10-15 · 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 | 67 |
For agents
markdown · JSON · MCP: product_card(name="gorakhargosh/watchdog")
Data as of 2026-10-19T08:05:51.212177+00:00 · Report a problem