# Papr Rss

Read, search and triage the user's Papr RSS subscriptions from the shell via the `papr`...

- Repository: https://github.com/l0ng-ai/papr (566 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-09-23
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add l0ng-ai/papr --skill papr-rss -g -a claude-code -y`
Codex: `npx skills add l0ng-ai/papr --skill papr-rss -g -a codex -y`
Cursor: `npx skills add l0ng-ai/papr --skill papr-rss -g -a cursor -y`
Gemini CLI: `npx skills add l0ng-ai/papr --skill papr-rss -g -a gemini-cli -y`

## Description

Read, search and triage the user's Papr RSS subscriptions from the shell via the `papr` CLI. Use when the user wants to catch up on their feeds, find or summarize articles they've subscribed to, check what's unread, star/save articles, subscribe to a new feed, or pull new posts. Triggers on: "what's in my feeds", "any unread RSS", "summarize this feed", "search my subscriptions for X", "mark these read", "subscribe to <url>", "refresh my feeds".

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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)

The rest: https://github.com/l0ng-ai/papr/blob/HEAD/skills/papr-rss/SKILL.md