A real-time developer filesystem watcher for Obsidian vaults, providing event-driven logging (Created, Modified, Deleted, Renamed) and Model Context Protocol (MCP) agent synchronization.
The Hot Reload Files component provides an interactive developer control center inside an Obsidian workspace leaf. It hooks directly into the vault filesystem event loop to log operations in real-time, matching folders dynamically and alerting agents via a structured JSON state synchronization interface.
- 🔍 Dynamic Vault Folder Watching: Type and resolve any vault path instantly inside the configuration input to switch watched directories.
- ⚡ Event-Driven Code Watcher: Automatically re-evaluates its own React views upon edits within the source directory, without requiring CPU-heavy polling timers.
- 🏷️ Quad-Type Event Discrimination: Categorizes filesystem events into distinct tags (CREATE, MODIFY, DELETE, RENAME) with color-coded status badges.
- 📜 50-Event Activity Stream: Renders a scrollback event log with clickable file links that open corresponding files directly in active workspace panes.
- 🤖 MCP Coordination Bridge: Outputs system watcher parameters to
data/mcp_state.jsonand parses commands fromdata/mcp_commands.jsonfor seamless agent interaction.
The package exposes the following compiled files:
| File | Description |
|---|---|
| [HOT RELOAD FILES.md](HOT RELOAD FILES.md) | Main entry point note to load in the Obsidian workspace leaf. |
| src/index.jsx | Main entry bootstrapper coordinating code modification events. |
| src/App.jsx | Main coordinator component managing states and structure. |
| src/components/WatcherPanel.jsx | User configuration panel displaying watched paths and green pulsing state tags. |
| src/components/EventLog.jsx | Real-time scrollback log visualizing file change events. |
| src/components/MCPBridge.jsx | Synchronization module writing watcher status to mcp_state.json. |
| src/utils/domUtils.js | DOM traversal helper functions to locate target leaf wrappers. |
| METADATA.md | Indexing properties and security context. |
| CONTRIBUTION.md | Developer standards and contribution protocol. |
| LICENSE.md | MIT open-source license. |
- beto.group