---
name: Papr RSS
slug: papr-rss
category: Automation
description: Papr RSS reads and manages Papr RSS subscriptions from the shell with the papr CLI. Use it to check unread items, search articles, mark read, star or save posts, subscribe to feeds, and refresh new content.
github: "https://github.com/l0ng-ai/papr/tree/main/skills/papr-rss"
language: Rust
stars: 518
forks: 53
install: "npx degit https://github.com/l0ng-ai/papr/tree/main/skills/papr-rss ~/.claude/skills/papr-rss"
installs_to: ~/.claude/skills/papr-rss
source_path: skills/papr-rss/SKILL.md
collection_size: 1
category_size: 1523
added: 2026-08-26T05:12:21.446Z
last_synced: 2026-08-26T05:12:21.446Z
canonical_url: "https://dirskills.com/skills/papr-rss"
---

# Papr RSS

Papr RSS reads and manages Papr RSS subscriptions from the shell with the papr CLI. Use it to check unread items, search articles, mark read, star or save posts, subscribe to feeds, and refresh new content.

**Install:**

```bash
npx degit https://github.com/l0ng-ai/papr/tree/main/skills/papr-rss ~/.claude/skills/papr-rss
```

## README

# Papr RSS CLI

`papr` is a token-efficient, agent-facing CLI over the user's local Papr RSS
database. It emits [TOON](https://toonformat.dev) on stdout (≈40% cheaper than
JSON, via the official `toon-format` encoder), keeps diagnostics on stderr, and
returns structured errors with exit codes (0 success/no-op, 1 runtime, 2 usage). Reads are token-minimal by default;
long article bodies are truncated with a `--full` escape hatch.

Run `papr` with no arguments first — it prints the unread dashboard plus the
most useful next commands, so you can orient without reading a manual.

## Core flow

```sh
papr                        # home: unread/starred counts + recent unread + next steps
papr feeds                  # subscriptions grouped by folder, with unread counts
papr list --feed <id>       # articles in a feed (defaults to unread; --all for read too)
papr list --starred         # smart views: --starred / --later / --tag <id> / --folder <id>
papr list --fields author,url   # add columns: author,url,snippet,type,feed_id,published
papr read <id> [<id>...]    # plain-text body, truncated; pass several ids to batch
papr read --feed <id> --unread --limit 5   # read a feed's latest unread in one call
papr read <id> --full       # the complete body when truncation hid something
papr search "<query>"       # FTS5 full-text search across every article
```

## Triage & subscriptions

```sh
papr mark read <id> [<id>...]      # state: read|unread|star|unstar|later|unlater (idempotent)
papr mark-all --feed <id>          # mark a whole view read
papr subscribe <url>               # auto-discovers the feed, inserts it, fetches it
papr refresh [--feed <id>]         # fetch new articles over the network (RSS + newsletters)
papr extract <id>                  # fetch & store the cleaned full text of an article
```

## Management (mirrors the desktop app)

```sh
papr tags | papr tag add <tag_id> <article_id> | papr tag create "<name>"
papr folders | papr folder create "<name>" | papr feed move <id> --folder <id>
papr rules | papr rule create "<name>" "<keywords>" --action star
papr highlights [--article <id>] | papr highlight create <article_id> "<quote>"
papr newsletters | papr newsletter add --title .. --host .. --user .. --password ..
papr opml import <file> | papr opml export
papr settings get <key> | papr settings set <key> <value>
papr stats
```

## Sync

```sh
papr sync status | papr sync run   # reconcile read/starred + subscriptions with FreshRSS/Miniflux
```

There are no summarize/ask/digest/translate commands: you are the language
model, so read the text with `papr read <id>` (or gather candidates with
`papr search`) and summarize, answer or translate it yourself — no second AI
provider is involved.

Destructive verbs require `--yes`; without it they fail with exit 2 and tell you
the exact command to re-run:

```sh
papr unsubscribe <id> --yes            # delete a feed and its articles
papr admin cleanup <days> --yes        # also: admin vacuum / admin reset
papr folder delete <id> --yes          # likewise tag/rule/highlight delete, newsletter remove
```

## Notes

- Every command takes `--db <path>` (or the `PAPR_DB` env var) if the database
  is not in the desktop app's default location.
- Output is data, not prose. Each list states a definitive total
  (`count: N of M unread`) so you never need to paginate just to learn the size.
- If the answer is "nothing", the command says so explicitly — a zero is an
  answer, not a reason to retry with different flags.
- Prefer the ambient SessionStart hook (`papr setup`) so the unread dashboard is
  already in context at the start of a conversation; this skill is the
  lower-overhead alternative that loads only when a feed task comes up.