newsblur cli

Engineering Community

Skill notes

Setup

auth login opens a browser for OAuth authorization. The token is stored at ~/.config/newsblur/. For self-hosted instances, pass --server or set NEWSBLUR_SERVER:

Readonly Mode

The CLI has a readonly mode that blocks all write operations (saving, sharing, training, subscribing, marking as read). Useful when handing the CLI to an AI agent. Check current readonly status: Disabling readonly logs you out and requires browser re-authentication. An AI agent cannot silently toggle this off. If you are operating in readonly mode, all write commands will fail with an error. Read commands work normally.

Output Formats

Every command supports these flags: --json — structured JSON output, pipe to jq --raw — unformatted plain text Default — human-readable formatted output

Stories

List unread stories across all feeds: Filter by folder or limit results: Full-text search across your archive: View saved/starred stories, optionally filtered by tag: Browse stories from rarely-publishing feeds (easy to miss in a busy river):

Daily Briefing

Get an AI-curated briefing with top stories, infrequent site gems, and long reads:

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
Engineering
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
94 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@samuelclay · MIT
Token usage
Lean
Setup complexity
Plug-and-play
External API key
Not required
Operating systems
Unspecified (assume cross-platform)
Runtime requirements
Python >=3.11
Detected file/system behavior
  • Read-only
  • Write / modify
Network behavior
External requests
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

Output preview newsblur-cli.preview
# Scripting Examples

newsblur stories list --json | jq -r '.items[] | "\(.title) - \(.feed_title)"'

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.