Does it support authenticated API requests?

Yes, the APIWatcher component supports various authentication types, including Bearer tokens and headers, for secure monitoring of private endpoints.

What is the main purpose of the Base Watcher Framework?

It is designed to monitor external sources like local directories or REST APIs and automatically record changes as Markdown files in an Obsidian vault.

Can I run multiple watchers at once?

Absolutely. The WatcherRegistry component allows you to register, start, and manage multiple file system and API watchers simultaneously through a single configuration.

Can I create custom monitoring logic?

Yes, the framework provides a BaseWatcher abstract class that you can extend in Python to implement any custom polling or event detection logic.

What version of Python is required for this framework?

The framework requires Python 3.10 or higher to leverage modern asynchronous features and type hinting.

Base Watcher Framework

Name: Base Watcher Framework
Author: NaveedTechLab

byNaveedTechLab

0•

Productivity & Workflow

Automates continuous monitoring of file systems and APIs by emitting structured events directly into Obsidian vaults as Markdown files.

The Base Watcher Framework provides a robust Python-based architecture for developers looking to bridge external data sources with their Obsidian knowledge base. It features extensible base classes for building custom watchers, out-of-the-box support for directory monitoring and REST API polling, and a centralized registry for managing multiple streams simultaneously. By converting changes—such as file modifications or API updates—into Markdown notes, it enables a seamless workflow for creating automated digital gardens, activity logs, or real-time project tracking systems within a personal knowledge management environment.

Key Features

01Automated file system monitoring with pattern matching and recursive search

020 GitHub stars

03Extensible Python BaseWatcher class for custom monitoring logic

04Native Obsidian integration that outputs events as structured Markdown files

05REST API polling with configurable authentication and change detection strategies

06Centralized WatcherRegistry to manage and synchronize multiple monitoring tasks

Use Cases

01Monitoring external API updates like GitHub releases and saving them as daily notes

02Building a local file-trigger system that logs document changes to a digital garden

03Creating an automated activity log or changelog within an Obsidian vault

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add naveedtechlab/personal-ai-employee-hackathon-0- base-watcher-framework

For use in Claude.ai and ChatGPT

Key Features

01Automated file system monitoring with pattern matching and recursive search

020 GitHub stars

03Extensible Python BaseWatcher class for custom monitoring logic

04Native Obsidian integration that outputs events as structured Markdown files

05REST API polling with configurable authentication and change detection strategies

06Centralized WatcherRegistry to manage and synchronize multiple monitoring tasks

Use Cases

01Monitoring external API updates like GitHub releases and saving them as daily notes

02Building a local file-trigger system that logs document changes to a digital garden

03Creating an automated activity log or changelog within an Obsidian vault

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add naveedtechlab/personal-ai-employee-hackathon-0- base-watcher-framework

For use in Claude.ai and ChatGPT