Individual skill

blogwatcher-cli

Use when managing or interacting with favorite blogs via the BlogWatcher CLI—adding/removing blogs, scanning for new posts, listing articles, marking read/unread, or modifying related CLI behavior, scanning, storage, and tests.

SKILL.md

Read pinned source

Source commit 58acfeb16258bd0e64d72f8f977ae8143cae5fa3

What was checked

Matches the observed repository HEAD: Yes
Scanner rules are current: Yes
Repository scan complete: Yes
Skill scan complete: Yes
Observed behavior: Network or broad shell
Last checked: Nov 11, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings): 149
Repository last updated: Aug 31, 2026
License: MIT

Observed agent integration: claude-code, codex

engineering Derived category

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files

.github/workflows/release.ymlasset · 736 bytes
.gitignoreasset · 86 bytes
.goreleaser.yamlasset · 1,049 bytes
AGENTS.mddoc · 2,245 bytes
CLAUDE.mddoc · 863 bytes
LICENSEasset · 1,056 bytes
README.mddoc · 7,677 bytes
SKILL.mdcore · 2,215 bytes
cmd/blogwatcher/main.goruns · 98 bytes
go.modasset · 1,269 bytes
go.sumasset · 14,057 bytes
internal/cli/commands.goruns · 12,165 bytes
internal/cli/errors.goruns · 330 bytes
internal/cli/metadata.goruns · 2,459 bytes
internal/cli/metadata_test.goruns · 7,239 bytes
internal/cli/root.goruns · 900 bytes
internal/controller/controller.goruns · 3,584 bytes
internal/controller/controller_test.goruns · 2,378 bytes
internal/model/model.goruns · 451 bytes
internal/rss/rss.goruns · 10,047 bytes
internal/rss/rss_test.goruns · 11,161 bytes
internal/scanner/scanner.goruns · 5,756 bytes
internal/scanner/scanner_test.goruns · 7,765 bytes
internal/scraper/scraper.goruns · 2,901 bytes
internal/scraper/scraper_test.goruns · 882 bytes
internal/storage/database.goruns · 13,141 bytes
internal/storage/database_test.goruns · 15,990 bytes
internal/version/version.goruns · 37 bytes

Read excerpt


# BlogWatcher CLI

## Quick Orientation
- Use the Cobra entry point in `cmd/blogwatcher/main.go` and `internal/cli/`.
- Route business logic through `internal/controller` and persistence through `internal/storage`.
- Use scanning pipeline packages in `internal/scanner`, `internal/rss`, and `internal/scraper`.
- Remember the default SQLite path is `~/.blogwatcher/blogwatcher.db` (override with `BLOGWATCHER_DB`) and is created on demand.

## Run Commands
- Run locally with `go run ./cmd/blogwatcher ...`.
- Build with `go build ./cmd/blogwatcher`.

## Change Workflow
1. Add or adjust CLI commands in `internal/cli/commands.go` (Cobra options, arguments, output formatting).