feeds/ drwxr-xr-x  the session

rssd 0.3.0 · a daemon that writes a directory

The filesystem
is the API.

rssd turns RSS and Atom feeds into a directory tree of plain XML files. No database, no socket, no client library. If it can read a folder, it is a client.

$ uv tool install 'rssd-fs[tui]'
$ brew install alliecatowo/tap/rssd

[ get started ][ how it works ][ github ]

sessionrssd 0.3.0 · real output
$ rss feeds --no-color
NAME       HEALTH    ENTRIES  LAST POLL   TITLE
lwn        ok             15  2026-10-05  LWN.net
rust-blog  ok             10  2026-10-05  Rust Blog
xkcd       ok              4  2026-10-05  xkcd.com

$ ls -la store/rust-blog | tail -n +2
drwxr-xr-x. 1 allie allie   50 Oct  4 19:41 .
drwxr-xr-x. 1 allie allie   32 Oct  4 19:41 ..
drwxr-xr-x. 1 allie allie 2696 Oct  4 19:41 entries
-rw-r--r--. 1 allie allie  344 Oct  4 19:41 feed.xml
-rw-r--r--. 1 allie allie  251 Oct  4 19:41 status.xml

$ ls -l store/rust-blog/entries | tail -n 4
-rw-r--r--. 1 allie allie  8490 Oct  4 19:41 20261001T000000Z-d3cf546b-announcing-rust-1-99-0.r1.xml
lrwxrwxrwx. 1 allie allie    55 Oct  4 19:41 20261001T000000Z-d3cf546b-announcing-rust-1-99-0.xml -> 20261001T000000Z-d3cf546b-announcing-rust-1-99-0.r1.xml
-rw-r--r--. 1 allie allie  3393 Oct  4 19:41 20261002T000000Z-979c2fbd-demoting-i686-windows-targets-to-std-only.r1.xml
lrwxrwxrwx. 1 allie allie    74 Oct  4 19:41 20261002T000000Z-979c2fbd-demoting-i686-windows-targets-to-std-only.xml -> 20261002T000000Z-979c2fbd-demoting-i686-windows-targets-to-std-only.r1.xml
$ xmllint --format store/rust-blog/entries/20260903T000000Z-840ac61d-announcing-rust-1-98-1.xml | cut -c1-110 | head -n 28
<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="https://rssd.dev/entry/1" id="sha256:840ac61de3c7dd0bb03a9e1a86da3a154aa349b309ca44081a12d28de60
  <source>
    <link>https://blog.rust-lang.org/2026/09/03/Rust-1.98.1/</link>
    <feed name="rust-blog" title="Rust Blog">https://blog.rust-lang.org/feed.xml</feed>
    <guid basis="atom-id">https://blog.rust-lang.org/2026/09/03/Rust-1.98.1/</guid>
  </source>
  <title>Announcing Rust 1.98.1</title>
  <author>The Rust Release Team</author>
  <published origin="feed">2026-09-03T00:00:00Z</published>
  <content origin="feed:content" hash="sha256:e46b8520b188c95239ac110d359a03c5e46e19b4a6079d04f903a1f077b9782f
    <paragraph>The Rust team has published a new point release of Rust, 1.98.1. Rust is a programming language
    <paragraph>If you have a previous version of Rust installed via rustup, getting Rust 1.98.1 is as easy as:
    <code>rustup update stable</code>
    <paragraph>If you don't have it already, you can <link href="https://www.rust-lang.org/install.html">get <
    <heading level="2"> What's in 1.98.1</heading>
    <paragraph>Rust 1.98.1 fixes a <link href="https://github.com/rust-lang/rust/issues/161441">miscompilation
    <paragraph>In Rust 1.98.0, in some circumstances, rustc would incorrectly generate a trait object vtable w
    <paragraph>If you'd like to help us out by testing future releases, you might consider using the beta (<co
    <heading level="3"> Contributors to 1.98.1</heading>
    <paragraph>Many people came together to create Rust 1.98.1. We couldn't have done it without all of you. <
  </content>
</entry>

Captured on 2026-10-04: rssd add for blog.rust-lang.org, xkcd.com and lwn.net, one rssd once, then these commands. Every entry is a symlink to its newest revision. Only the line widths were trimmed, and the pipes that do it are in the commands.

entries/ drwxr-xr-x  the guarantees
  • -r--r--r-- atomic-writes.txt

    Every file is written to a temp name, fsynced, then renamed into place. A reader sees the old file or the new one, never a half-written one. Each document is re-parsed with a strict XML parser before the rename, so malformed output cannot reach the tree.

  • lrwxrwxrwx revisions.txt -> *.r2.xml

    Nothing is overwritten. When a publisher edits a post, the new version lands beside the old one as .r2.xml and a stable symlink is repointed. Follow the symlink for current, or list .rN for the whole history.

  • -r--r--r-- vocabulary.xml

    Publisher HTML is mapped onto a small fixed set of tags: paragraph, heading, code, link. Wrapper divs, class attributes and tracking junk are gone, and relative URLs are resolved. Every entry has the same shape, whoever wrote it.

  • -r--r--r-- tree-is-truth.txt

    Each entry embeds its own ID and content hash, so rm -rf var/ is fully recoverable. The daemon rebuilds what it knows by scanning the tree, and writes nothing.

  • -r--r--r-- rss.readonly

    rss is a separate binary from rssd. It opens no file for writing, anywhere, which is the proof that the output tree is a sufficient API for someone else's program.

reader/ drwxr-xr-x  rss tui

A vim-flavoured terminal reader with three panes: feeds, entries, and the article. It reads the filesystem and nothing else, so the daemon does not need to be running.

rss tui100x26, captured from tmux
   lwn                 │ >Demoting i686 Windows targets to std-only  │ Demoting i686 Windows
 > rust-blog           │  Announcing Rust 1.99.0                     │ targets to std-only
   xkcd                │  Announcing a Maintainer in Residence:      │ Rust Blog  ·  3d ago
 ~                     │ Scott Schafer for the Cargo team            │ by Mateusz Mikuła, Ralf Jung
 ~                     │  GitHub Actions leaking secrets when Miri   │ --------------------------
 ~                     │ output is cached                            │
 ~                     │  Be alert: targeted attacks on prominent    │ With Rust 1.100.0, the
 ~                     │ Rustaceans                                  │ following changes to
 ~                     │  Rust debugging survey 2026 results         │ 32-bit Windows targets
 ~                     │  Announcing Rust 1.98.1                     │ will happen:
 ~                     │  Announcing rustup 1.29.1                   │
 ~                     │  Announcing our first Maintainers in        │ - `i686-pc-windows-msvc`
 ~                     │ Residence                                   │   Tier 1 *with* host tools
 ~                     │  Enabling the next-generation trait solver  │   target will be demoted
 ~                     │ on nightly                                  │   to Tier 1 *without* host
 ~                     │ ~                                           │   tools.
 ~                     │ ~                                           │
 ~                     │ ~                                           │ - `i686-pc-windows-gnu`
 ~                     │ ~                                           │   Tier 2 *with* host tools
 ~                     │ ~                                           │   target will be demoted
 ~                     │ ~                                           │   to Tier 2 *without* host
 ~                     │ ~                                           │   tools.
 ~                     │ ~                                           │
 ~                     │ ~                                           │ Builds of the standard
 ~                     │ ~                                           │ library will continue to
 -- NORMAL --  feed:rust-blog  pane:reader  1/10  0%

j/k move, h/l change pane, Enter reads, / searches, :links numbers every outbound URL. Full key list.

var/ drwxr-xr-x  events.jsonl

Every action appends one JSON line. If you see entry.new, the file already exists and is complete.

eventsthe tail of the same run
$ tail -n 4 var/events.jsonl | cut -c1-150
{"v":1,"seq":43,"ts":"2026-10-05T02:41:34.203Z","event":"entry.new","feed":"lwn","data":{"id":"sha256:c6d5b2f4df92f72423830cf9cae43cf086a3da5b57428b2b
{"v":1,"seq":44,"ts":"2026-10-05T02:41:34.203Z","event":"feed.health-changed","feed":"lwn","data":{"health":"ok"}}
{"v":1,"seq":45,"ts":"2026-10-05T02:41:34.216Z","event":"feed.poll-succeeded","feed":"lwn","data":{"entries":15,"written":15,"next_poll_in":900}}
{"v":1,"seq":46,"ts":"2026-10-05T02:41:34.217Z","event":"daemon.stopping","data":{}}
bin/ drwxr-xr-x  install

Python 3.12 or newer. Pick one:

installpypi · homebrew
$ uv tool install 'rssd-fs[tui]'
$ brew install alliecatowo/tap/rssd

$ rssd add https://blog.rust-lang.org/feed.xml --name rust-blog
$ rssd once
$ rss tui

Bring your subscriptions from any other reader with OPML, and take them back out the same way:

opmlreal output
$ rssd import subscriptions.opml
  added hnrss.org  https://hnrss.org/frontpage
  added blog.rust-lang.org  https://blog.rust-lang.org/feed.xml

2 added, 0 skipped (already subscribed or invalid)
$ rssd export
<?xml version='1.0' encoding='utf-8'?>
<opml version="2.0">
  <head>
    <title>rssd subscriptions</title>
  </head>
  <body>
    <outline type="rss" text="lwn" title="lwn" xmlUrl="https://lwn.net/headlines/rss"/>
    <outline type="rss" text="rust-blog" title="rust-blog" xmlUrl="https://blog.rust-lang.org/feed.xml"/>
    <outline type="rss" text="xkcd" title="xkcd" xmlUrl="https://xkcd.com/atom.xml"/>
  </body>
</opml>

OPML in detail · getting started · every command