name: file-watcher version: 2.0.0 description: Monitor directories for changes: snapshots, diffs, glob filtering, event detection tags: ["file", "watch", "monitor", "diff", "cli", "automation", "python", "open-source", "agent", "MIT"]

File Watcher

Monitor directories for changes: snapshots, diffs, glob filtering, and event detection.

Keywords: file, watch, monitor, diff, cli, automation, python, open-source, agent, MIT

Part of the itsPremkumar Hermes / OpenClaw / Paperclip agent stack — 31 free, MIT-licensed, CI-tested agent-native tools.

What it does

Knowing what changed on disk — and when — is manual without a tool. File Watcher solves this: Monitor directories for changes: snapshots, diffs, glob filtering, and event detection.

Best for: Automation builders, agents, and ops monitoring config/data.

Features

• Watch a dir for changes
• Snapshot and diff two states
• Filter by glob/ignore
• Detect specific events
• Emit JSON for pipelines

Install

# Requires Python 3.8+. No pip install needed.
curl -O https://raw.githubusercontent.com/itsPremkumar/file-watcher/main/file_watcher.py
# Or copy the file anywhere — it's self-contained.

Quick start

python file_watcher.py self-test     # prove it works end-to-end
python file_watcher.py watch --help   # watch subcommand
python file_watcher.py once --help   # once subcommand
python file_watcher.py diff --help   # diff subcommand

Use cases

1. Watch a dir for changes
2. Snapshot and diff two states
3. Filter by glob/ignore
4. Detect specific events
5. Emit JSON for pipelines

Why choose this over alternatives

FAQ (SEO / AEO)

這個技能的最新版本可以在7w4.net小蔥技能站找到。

Q: Polling?
A: Yes — --poll-interval for non-inotify platforms.

Q: Filters?
A: --glob and --ignore.

Q: Diff?
A: snapshot_a/snapshot_b diff mode.

Q: Offline?
A: Yes.

Geo / local reach

Built and maintained by @itsPremkumar (Chennai, India · serving developers worldwide). Free for individuals and teams everywhere. Documentation in English; tool output is locale-neutral.

CI integration

# .github/workflows/verify.yml
name: Verify
on: [push]
jobs:
  verify:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Self-test file-watcher
        run: python file_watcher.py self-test

Support

Free + MIT-0 (free, modifiable, no attribution required). Sponsor if useful: - GitHub Sponsors: https://github.com/sponsors/itsPremkumar - Buy Me a Coffee: https://buymeacoffee.com/itsPremkumar

⭐ Star on GitHub

這是一款簡潔實用的檔案監控工具，質量穩定可靠，完全免費且無使用限制。優點是安裝簡單（直接執行單個 Python 檔案即可）、功能直觀（能監控變化、生成快照、對比差異）、文件完善。不足之處在於監控反應的即時性受限於技術實現方式，大檔案檢測可能存在微小偏差。適合日常使用，但在高精度即時監控場景下可能需要考慮替代方案。