Scout

A fast, native RSS reader for macOS — and a CLI your AI agent can actually drive.

Scout is two front-ends over one local database:

• A desktop reader — fast, native, offline-first. No account, no cloud.
• scout, an agent-facing CLI — so an autonomous agent (Claude Code, Codex, OpenCode…) can read, search and triage your feeds straight from the shell.

Both read the same database through the shared scout-core crate, so the app and the CLI can never drift apart.

A fork of l0ng-ai/papr, trimmed to a macOS-only scope with its own release channel.

---

The desktop app

• Feeds & folders — subscribe, organize, and import/export OPML.
• Smart views — All, Unread, Starred, and Read Later, with live counts.
• Tags & rules — color-coded tags and rules that tag new articles automatically.
• Full-text — fetch and clean the complete article when a feed ships only a summary.
• AI — a summary at the top of every article, generated on demand with selectable prompt presets, plus article translation. Bring your own API key.
• Audio — a built-in player that follows you from article to article.
• FreshRSS sync — keep read state in step with a FreshRSS server.
• Local-first — everything stays on your machine. No account, no cloud.
• Localized — English, Japanese, and Simplified Chinese.

Install

Grab the .dmg from the latest release — macOS builds are Developer ID signed and notarized. Or build from source:

pnpm install && pnpm tauri build

---

scout — your feeds, handed to your agent

scout is a command-line companion built for autonomous agents to drive over the shell. Point your agent at it and it can work your feeds with no GUI:

• Read — feeds, list, read, full-text search
• Triage — mark read/star/later, extract full text, refresh
• Manage — subscriptions, folders, tags, rules, highlights, OPML
• Sync — FreshRSS / Miniflux

Run bare scout and it prints your unread dashboard plus the next useful commands, so the agent orients with zero manual. Output is TOON — ~40% fewer tokens than JSON — with definitive counts and structured exit codes.

$ scout
unread: 206   starred: 17   later: 0   feeds: 15
articles[10]{id,feed,title,flags,date}:
   3664,V2EX,[Java] 使用 kkRepo 搭建 Maven 私服,unread.star,"2026-06-25"
   ...
help[4]: Run `scout read <id>` to read an article's full text, ...

Hand it to your agent — one line

The bundled scout-rss skill loads on demand when an agent recognizes a feed-related task, so it costs nothing until you use it. Install it with skills:

npx skills add https://github.com/YL404/scout/tree/main/skills/scout-rss

Want the agent proactively aware of your feeds every conversation? scout setup wires up an ambient SessionStart hook (Claude Code, Codex, OpenCode).

Install the CLI

Platform	How
macOS	scout-<target>.tar.gz from the latest release, or cargo build --release -p scout-cli

Full command reference, agent setup, and install options → docs/cli.md