rssnext/apps/cli
apps/cli/SKILL.md
# Folo CLI Skill ## Trigger Conditions Use this skill when a user asks to: - Manage RSS subscriptions - Browse timeline entries - Read entry details or readability content - Mark entries as read/unread - Search feeds/lists or trending sources - Import/export OPML - Check unread counts ## Preconditions 1. Node.js and npm are installed so the CLI can be executed with `npx`. 2. Authentication is configured: - `npx --yes folocli@latest login` (recommended, opens browser and auto-logins) -
$ install --global
skillsauthnpx skillsauth add rssnext/folo apps/cliInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 12, 2026, 11:56 PM32.3s27 files scanned
SKILL.md
Folo CLI Skill
Trigger Conditions
Use this skill when a user asks to:
- Manage RSS subscriptions
- Browse timeline entries
- Read entry details or readability content
- Mark entries as read/unread
- Search feeds/lists or trending sources
- Import/export OPML
- Check unread counts
Preconditions
- Node.js and npm are installed so the CLI can be executed with
npx. - Authentication is configured:
npx --yes folocli@latest login(recommended, opens browser and auto-logins)- or
npx --yes folocli@latest login --token <session-token> - or set
FOLO_TOKEN=<token>
Execution Policy
- Prefer
npx --yes folocli@latest ...for all agent runs. - Do not require
npm install -g folocli. - No separate update preflight is needed. Using
folocli@latestis the update strategy. - If a user already has a working global
folobinary, it is acceptable, butnpx --yes folocli@latestremains the recommended default in docs and automation.
Output Contract
Default output is JSON with a stable envelope:
{
"ok": true,
"data": {},
"error": null
}
Errors return:
{
"ok": false,
"data": null,
"error": {
"code": "UNAUTHORIZED",
"message": "Token is invalid or expired."
}
}
You can switch output mode:
--format json(default)--format table--format plain
Core Workflows
1. Timeline Reading
- Fetch timeline:
npx --yes folocli@latest timeline --limit 10
- Get entry detail:
npx --yes folocli@latest entry get <entryId>
- Get readability content:
npx --yes folocli@latest entry read <entryId>
2. Subscription Management
- Discover:
npx --yes folocli@latest search discover <keyword>
- Add subscription:
npx --yes folocli@latest subscription add --feed <url>- or
npx --yes folocli@latest subscription add --list <listId>
- List subscriptions:
npx --yes folocli@latest subscription list
3. Unread Processing
- Check unread total:
npx --yes folocli@latest unread count
- List unread subscriptions:
npx --yes folocli@latest unread list
- Read unread entries:
npx --yes folocli@latest timeline --unread-only --limit 20
- Mark read:
npx --yes folocli@latest entry mark-read <entryId>- or batch:
npx --yes folocli@latest entry mark-all-read --view articles
4. Collection Operations
- Add:
npx --yes folocli@latest collection add <entryId> - Remove:
npx --yes folocli@latest collection remove <entryId> - List:
npx --yes folocli@latest collection list --limit 20
5. OPML Import / Export
- Export:
npx --yes folocli@latest opml export --output backup.opml
- Import:
npx --yes folocli@latest opml import feeds.opml
Pagination Pattern
npx --yes folocli@latest timeline returns:
entriesnextCursorhasNext
Loop until hasNext is false:
npx --yes folocli@latest timeline --limit 20- Read
nextCursor npx --yes folocli@latest timeline --limit 20 --cursor <nextCursor>- Repeat
Command Reference
-
npx --yes folocli@latest login [--timeout <seconds>] [--token <token>] -
npx --yes folocli@latest logout -
npx --yes folocli@latest whoami -
npx --yes folocli@latest auth login [--timeout <seconds>] [--token <token>] -
npx --yes folocli@latest auth logout -
npx --yes folocli@latest auth whoami -
npx --yes folocli@latest timeline [--view <type>] [--limit <n>] [--unread-only] [--cursor <datetime>] -
npx --yes folocli@latest timeline --feed <feedId> [--limit <n>] [--cursor <datetime>] -
npx --yes folocli@latest timeline --list <listId> [--limit <n>] [--cursor <datetime>] -
npx --yes folocli@latest timeline --category <name> [--view <type>] [--limit <n>] -
npx --yes folocli@latest subscription list [--view <type>] [--category <name>] -
npx --yes folocli@latest subscription add --feed <url> [--category <name>] [--view <type>] [--private] -
npx --yes folocli@latest subscription add --list <listId> [--category <name>] [--view <type>] -
npx --yes folocli@latest subscription remove <id> [--target feed|list|url] -
npx --yes folocli@latest subscription update <id> [--target feed|list] [--category <name>] [--title <title>] [--view <type>] [--private|--public] -
npx --yes folocli@latest entry get <entryId> -
npx --yes folocli@latest entry read <entryId> -
npx --yes folocli@latest entry mark-read <entryId> -
npx --yes folocli@latest entry mark-unread <entryId> -
npx --yes folocli@latest entry mark-all-read [--feed <feedId>] [--list <listId>] [--view <type>] -
npx --yes folocli@latest feed get <feedId|feedUrl> -
npx --yes folocli@latest feed refresh <feedId> -
npx --yes folocli@latest feed analytics <feedId> -
npx --yes folocli@latest list ls -
npx --yes folocli@latest list get <listId> -
npx --yes folocli@latest list create --title <title> [--description <desc>] [--view <type>] [--fee <n>] -
npx --yes folocli@latest list update <listId> [--title <title>] [--description <desc>] [--view <type>] [--fee <n>] -
npx --yes folocli@latest list delete <listId> -
npx --yes folocli@latest list add-feed <listId> --feed <feedId> -
npx --yes folocli@latest list remove-feed <listId> --feed <feedId> -
npx --yes folocli@latest search discover <keyword> [--type feeds|lists] -
npx --yes folocli@latest search rsshub <keyword> [--lang <lang>] -
npx --yes folocli@latest search trending [--range 1d|3d|7d|30d] [--view <type>] [--limit <n>] [--language eng|cmn] [--category <keyword>] -
npx --yes folocli@latest collection list [--limit <n>] [--cursor <datetime>] -
npx --yes folocli@latest collection add <entryId> [--view <type>] -
npx --yes folocli@latest collection remove <entryId> -
npx --yes folocli@latest opml export [--output <file>] -
npx --yes folocli@latest opml import <file> [--items <url1,url2,...>] -
npx --yes folocli@latest unread count -
npx --yes folocli@latest unread list [--view <type>]
Error Recovery
UNAUTHORIZED- Re-login:
npx --yes folocli@latest login - or
npx --yes folocli@latest login --token <token> - Or set
FOLO_TOKEN
- Re-login:
HTTP_4xx/HTTP_5xx- Retry with
--verbosefor request details - Verify
--api-urlif using non-default endpoint
- Retry with
INVALID_ARGUMENT- Run
npx --yes folocli@latest <command> --helpto inspect accepted options
- Run
Related Skills
rssnext/desktop-release
development
VerifiedTrustedCommunity
Perform a regular desktop release from the dev branch. Gather changes since the last desktop tag, update the changelog, choose the desktop release mode in release-plan.json, bump the version, and prepare the release PR.
38,043SKILL.mdUpdated Apr 12, 2026
rssnext/update-deps
development
VerifiedTrustedCommunity
Update all dependencies across frontend and backend projects. Reads changelogs for breaking changes, checks affected code, runs tests, and provides a summary. Use when updating npm dependencies across the monorepo.
38,030SKILL.mdUpdated Apr 12, 2026
rssnext/mobile-self-test
development
VerifiedTrustedCommunity
Self-test a mobile feature change or bug fix after implementation in `apps/mobile`. Use this whenever the user asks to verify a mobile change, run simulator acceptance, smoke-test a mobile PR, or provide screenshot proof for a mobile fix. This skill decides between prod vs local API mode, starts the local follow-server when needed, builds a release app, uses Maestro only to bootstrap registration for non-auth work, then switches to screenshot-driven visual validation and returns screenshot evidence.
38,030SKILL.mdUpdated Apr 12, 2026
rssnext/mobile-release
development
VerifiedTrustedCommunity
Use when preparing a mobile release from the dev branch and deciding whether changes should ship through the app stores or through the OTA pipeline before creating the release PR to mobile-main.
38,030SKILL.mdUpdated Apr 12, 2026