fs-monitor

A terminal-UI filesystem monitor. Watches a directory for live create/modify/remove events and renders them in your terminal. New files flash bright, then fade to gray; deleted files linger for 60 seconds so you can spot churn.

Press q, Esc or Ctrl+C to quit.

---

Why fs-monitor?

Use it to observe filesystem activity during:

• Script execution
• Build processes
• Git operations
• Temporary‐file cleanup
• Bootstrapping or idempotency testing

---

Dependencies

• rust-script

  cargo install rust-script
  

• (Or install via your distro’s package manager)

---

Installation

System-wide

install bin/fs-monitor -m 0755 /usr/local/bin/fs-monitor

Per-user

install bin/fs-monitor -m 0755 "$HOME/.local/bin/fs-monitor"

---

Usage

Usage: fs-monitor [OPTIONS] [WATCH]

Arguments:
  WATCH                 Directory to watch (default: ".")

Options:
  --hidden[=<true|false>]  Include hidden files (default: true)
                           To hide dotfiles: --hidden=false
  -h, --help               Print help information
  -V, --version            Print version information

On start, the UI header shows:

fs-monitor — Watching: /path/to/dir • Press q/Esc to quit
Events: 123 (C:10 M:100 D:13)

Examples

Watch the current directory (hidden files shown):

$ fs-monitor

Watch /tmp, hiding dotfiles:

$ fs-monitor /tmp --hidden=false

Watch a Git repository:

$ fs-monitor .git

---

Session Report on Exit

When you quit, fs-monitor prints a summary to stderr:

📊 fs-monitor — Session Report
   Total Events: 123
   Created:      10
   Modified:     100
   Deleted:      13
   Watching:     /path/to/dir

---

Keys

• q
• Esc
• Ctrl+C

→ Quit

---