| name | rssaurus-cli |
| description | 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. |
RSSaurus 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
rssaurus mark-read --ids 1,2,3
rssaurus mark-read --all --feed-id 3
Save / unsave
rssaurus save https://example.com --title "Optional title"
rssaurus unsave <saved-item-id>
Output conventions (privacy)
- Default human output avoids printing internal DB IDs.
- Use
--json output when IDs are required for scripting or write actions.
References
