rssaurus-cli
Use the RSSaurus command-line client (Go binary `rssaurus`) to interact with https://rssaurus.com from the terminal: authenticate (`rssaurus auth login/whoami`), list feeds/items, print item URLs for piping, open URLs, and perform triage actions (mark read/unread, bulk mark-read, save/unsave). Use when asked to automate RSSaurus tasks from CLI, debug token/config issues, or demonstrate command usage.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/justinburdett/rssaurusRSSaurus CLI
Use the installed rssaurus binary on this machine to interact with RSSaurus.
Quick checks (when something fails)
- Confirm binary exists:
which rssaurus
rssaurus --version || true
- Confirm auth works:
rssaurus auth whoami
Privacy note
- Do not print (e.g.
cat) the RSSaurus CLI config file contents; it can contain API tokens. - If auth fails, prefer re-authenticating (
rssaurus auth login) or asking the user to paste only non-sensitive details (error output, host, etc.).
Common tasks
List feeds
rssaurus feeds
rssaurus feeds --json
List items
Unread by default:
rssaurus items --limit 20
Filter by feed:
rssaurus items --feed-id 3 --limit 20
Machine-friendly URL output (one per line):
rssaurus items --limit 20 --urls
Cursor paging:
rssaurus items --limit 50 --cursor <cursor>
Open a URL
rssaurus open https://example.com
Mark read/unread
These require item IDs (get them via --json).
rssaurus items --limit 5 --json
rssaurus read <item-id>
rssaurus unread <item-id>
Bulk mark read:
rssaurus mark-read --all
# or
rssaurus mark-read --ids 1,2,3
# optional
rssaurus mark-read --all --feed-id 3
Save / unsave
rssaurus save https://example.com --title "Optional title"
# unsave requires an id (obtain via --json output from the API response or future saved-items listing)
rssaurus unsave <saved-item-id>
Output conventions (privacy)
- Default human output avoids printing internal DB IDs.
- Use
--jsonoutput when IDs are required for scripting or write actions.
References
- CLI repo: https://github.com/RSSaurus/rssaurus-cli
- Homebrew tap: https://github.com/RSSaurus/tap
- Token creation: https://rssaurus.com/api_tokens/new
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-justinburdett-rssaurus": {
"enabled": true,
"auto_update": true
}
}
}