What types of feeds does Blogwatcher support?

Blogwatcher supports both RSS and Atom feeds for monitoring updates. It can also scrape HTML content if no feed is available.

How can I import my existing blog subscriptions?

You can import existing blog subscriptions using OPML files exported from other feed readers like Feedly or Inoreader.

Is there a way to manage read and unread articles?

Yes, Blogwatcher allows you to mark articles as read or unread, helping you keep track of your reading progress.

Can I run Blogwatcher in a Docker container?

Yes, Blogwatcher can be run in a Docker container, and you can set up persistent storage for your database.

What programming languages does Blogwatcher support?

Blogwatcher is primarily a command-line tool that runs in a bash environment and interacts with network resources.

Blogwatcher

Name: Blogwatcher
Availability: InStock
Author: nousresearch

Free

Efficiently track blog and RSS feed updates.

by nousresearch228.5k stars on nousresearch/hermes-agent

1 views

Updated Aug 10, 2026

Get this skill

Free · Opens the source repo

What Blogwatcher does

Blogwatcher is a command-line tool designed for monitoring blogs and RSS/Atom feeds, making it easier for users to stay updated with their favorite online content. The blogwatcher-cli tool allows for automatic feed discovery, which means it can identify the RSS or Atom feed from a blog's homepage without needing the user to specify it. If the feed is unavailable, Blogwatcher can fall back on HTML scraping, ensuring that users still receive updates from their preferred blogs. This flexibility makes it a robust solution for blog monitoring.

The application also supports OPML import, allowing users to bulk import their subscriptions from other feed readers like Feedly or Inoreader. This feature is particularly useful for users transitioning from other platforms, as it saves time and effort in setting up their blog feeds. Additionally, Blogwatcher provides read and unread article management, enabling users to keep track of what they have read and what remains to be explored. This is especially beneficial for those who follow multiple blogs and need an organized way to manage their reading list.

Developers and designers who frequently consume content from various blogs will find Blogwatcher particularly useful. It streamlines the process of staying informed about industry trends, new technologies, or creative inspiration. With its command-line interface, it can easily be integrated into existing workflows, making it a valuable tool for anyone who relies on blog content for their work or personal interests.

When to use it

Use Blogwatcher when you want to efficiently track updates from multiple blogs or RSS feeds without the need for a graphical user interface.

When not to use it

This tool may not be suitable for users who prefer a graphical interface or need advanced features like social sharing or in-depth analytics.

What you can build with it

Monitoring Industry Blogs

Use Blogwatcher to keep track of updates from industry-related blogs, ensuring you never miss important news.

Transitioning from Another Feed Reader

Easily migrate your subscriptions from other feed readers by importing OPML files into Blogwatcher.

Organizing Reading Lists

Manage your reading list effectively by marking articles as read or unread, helping you prioritize your reading.

How to install Blogwatcher

View source

1. Install with the skills CLI

npx skills add nousresearch/hermes-agent/blogwatcher --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by nousresearch

Blogwatcher

Track blog and RSS/Atom feed updates with the blogwatcher-cli tool. Supports automatic feed discovery, HTML scraping fallback, OPML import, and read/unread article management.

Installation

Pick one method:

Go: go install github.com/JulienTant/blogwatcher-cli/cmd/blogwatcher-cli@latest
Docker: docker run --rm -v blogwatcher-cli:/data ghcr.io/julientant/blogwatcher-cli
Binary (Linux amd64): curl -sL https://github.com/JulienTant/blogwatcher-cli/releases/latest/download/blogwatcher-cli_linux_amd64.tar.gz | tar xz -C /usr/local/bin blogwatcher-cli
Binary (Linux arm64): curl -sL https://github.com/JulienTant/blogwatcher-cli/releases/latest/download/blogwatcher-cli_linux_arm64.tar.gz | tar xz -C /usr/local/bin blogwatcher-cli
Binary (macOS Apple Silicon): curl -sL https://github.com/JulienTant/blogwatcher-cli/releases/latest/download/blogwatcher-cli_darwin_arm64.tar.gz | tar xz -C /usr/local/bin blogwatcher-cli
Binary (macOS Intel): curl -sL https://github.com/JulienTant/blogwatcher-cli/releases/latest/download/blogwatcher-cli_darwin_amd64.tar.gz | tar xz -C /usr/local/bin blogwatcher-cli

All releases: https://github.com/JulienTant/blogwatcher-cli/releases

Docker with persistent storage

By default the database lives at ~/.blogwatcher-cli/blogwatcher-cli.db. In Docker this is lost on container restart. Use BLOGWATCHER_DB or a volume mount to persist it:

# Named volume (simplest)
docker run --rm -v blogwatcher-cli:/data -e BLOGWATCHER_DB=/data/blogwatcher-cli.db ghcr.io/julientant/blogwatcher-cli scan

# Host bind mount
docker run --rm -v /path/on/host:/data -e BLOGWATCHER_DB=/data/blogwatcher-cli.db ghcr.io/julientant/blogwatcher-cli scan

Migrating from the original blogwatcher

If upgrading from Hyaxia/blogwatcher, move your database:

mv ~/.blogwatcher/blogwatcher.db ~/.blogwatcher-cli/blogwatcher-cli.db

The binary name changed from blogwatcher to blogwatcher-cli.

Common Commands

Managing blogs

Add a blog: blogwatcher-cli add "My Blog" https://example.com
Add with explicit feed: blogwatcher-cli add "My Blog" https://example.com --feed-url https://example.com/feed.xml
Add with HTML scraping: blogwatcher-cli add "My Blog" https://example.com --scrape-selector "article h2 a"
List tracked blogs: blogwatcher-cli blogs
Remove a blog: blogwatcher-cli remove "My Blog" --yes
Import from OPML: blogwatcher-cli import subscriptions.opml

Scanning and reading

Scan all blogs: blogwatcher-cli scan
Scan one blog: blogwatcher-cli scan "My Blog"
List unread articles: blogwatcher-cli articles
List all articles: blogwatcher-cli articles --all
Filter by blog: blogwatcher-cli articles --blog "My Blog"
Filter by category: blogwatcher-cli articles --category "Engineering"
Mark article read: blogwatcher-cli read 1
Mark article unread: blogwatcher-cli unread 1
Mark all read: blogwatcher-cli read-all
Mark all read for a blog: blogwatcher-cli read-all --blog "My Blog" --yes

Environment Variables

All flags can be set via environment variables with the BLOGWATCHER_ prefix:

Variable	Description
`BLOGWATCHER_DB`	Path to SQLite database file
`BLOGWATCHER_WORKERS`	Number of concurrent scan workers (default: 8)
`BLOGWATCHER_SILENT`	Only output "scan done" when scanning
`BLOGWATCHER_YES`	Skip confirmation prompts
`BLOGWATCHER_CATEGORY`	Default filter for articles by category

Example Output

$ blogwatcher-cli blogs
Tracked blogs (1):

  xkcd
    URL: https://xkcd.com
    Feed: https://xkcd.com/atom.xml
    Last scanned: 2026-04-03 10:30

$ blogwatcher-cli scan
Scanning 1 blog(s)...

  xkcd
    Source: RSS | Found: 4 | New: 4

Found 4 new article(s) total!

$ blogwatcher-cli articles
Unread articles (2):

  [1] [new] Barrel - Part 13
       Blog: xkcd
       URL: https://xkcd.com/3095/
       Published: 2026-04-02
       Categories: Comics, Science

  [2] [new] Volcano Fact
       Blog: xkcd
       URL: https://xkcd.com/3094/
       Published: 2026-04-01
       Categories: Comics

Notes

Auto-discovers RSS/Atom feeds from blog homepages when no --feed-url is provided.
Falls back to HTML scraping if RSS fails and --scrape-selector is configured.
Categories from RSS/Atom feeds are stored and can be used to filter articles.
Import blogs in bulk from OPML files exported by Feedly, Inoreader, NewsBlur, etc.
Database stored at ~/.blogwatcher-cli/blogwatcher-cli.db by default (override with --db or BLOGWATCHER_DB).
Use blogwatcher-cli <command> --help to discover all flags and options.

Frequently asked questions about Blogwatcher

Similar skills

Agent-Browser Core

Efficient browser automation for AI agents.

Setup My IQ

Effortlessly create and update your personal context portfolio.

CRM Maintenance

Automate HubSpot updates from your calendar and emails.

Zoom MCP

Streamline access to Zoom meeting assets and recordings.

Slack Automation

Automate tasks and extract data from Slack easily.

SMB Onboard

Guides small business owners through initial tool setup.