AgentSkillsCN

rssaurus-cli

使用RSSaurus命令行客户端（Go二进制程序`rssaurus`）在终端中与https://rssaurus.com交互：进行身份验证（`rssaurus auth login/whoami`）、列出订阅源与条目、打印条目URL以便管道传输、打开URL，以及执行分类操作（标记已读/未读、批量标记已读、保存/取消保存）。当用户要求通过CLI自动化RSSaurus任务、调试Token或配置问题，或演示命令使用方法时使用。

SKILL.md
--- frontmatter
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)

  1. •Confirm binary exists:
bash
which rssaurus
rssaurus --version || true
  1. •Confirm auth works:
bash
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

bash
rssaurus feeds
rssaurus feeds --json

List items

Unread by default:

bash
rssaurus items --limit 20

Filter by feed:

bash
rssaurus items --feed-id 3 --limit 20

Machine-friendly URL output (one per line):

bash
rssaurus items --limit 20 --urls

Cursor paging:

bash
rssaurus items --limit 50 --cursor <cursor>

Open a URL

bash
rssaurus open https://example.com

Mark read/unread

These require item IDs (get them via --json).

bash
rssaurus items --limit 5 --json
rssaurus read <item-id>
rssaurus unread <item-id>

Bulk mark read:

bash
rssaurus mark-read --all
# or
rssaurus mark-read --ids 1,2,3
# optional
rssaurus mark-read --all --feed-id 3

Save / unsave

bash
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 --json output when IDs are required for scripting or write actions.

References