> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetype.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# Feeds

> Subscribe to feeds, read new entries, and keep articles, videos, books and papers in your library.

Feeds follows RSS and Atom feeds, YouTube channels and, through an RSSHub server, X and Threads accounts. It also keeps your reading library: what you saved to read. It comes with Archetype and is on by default. General setup is in [Plugins](https://docs.archetype.ing/en/extend/plugins.md).

## In the sidebar

**Feeds** has three columns: sources, entries and the entry itself (a list, then the entry, on a small screen).

* **Discover** offers a short catalog of sources (articles, X accounts, YouTube channels, podcasts) and finds a feed from a website's address or a feed's own address. Adding one checks the feed and brings its recent entries.
* Opening an entry marks it read; **Mark unread** undoes it. A YouTube entry plays in the page.
* **Save** keeps an entry in your **Library**.
* **Mute words** hides entries with words you do not want to see, for every feed, a folder or one source. A source can also keep only entries with some words. Nothing is deleted.
* Right-click a source (or its `…` button) to move it to a folder or **Unsubscribe**. Saved copies stay.
* **Import OPML** and **Export OPML** are at the foot of the source list. Export writes the file to your Downloads folder.

Feeds checks for new entries every 15 minutes, with or without the page open, and when you open it.

## Ask about what you read

The **Feed agent** button, at the bottom right, offers **Summarize** and **Translate** for the open entry, answered in place by the folder's model. **Continue to conversation** takes it on to a conversation, after you look it over. With no entry open it offers **Summarize the current timeline**, **Catch up on unread entries** and **Ask about this feed**.

## What the agent can do

| Tool | What it does |
| - | - |
| `list_feed_sources` | Lists your sources and unread counts. Read only. |
| `search_feed_entries` | Searches collected entries by source, words, unread and dates. Read only. |
| `read_feed_entry` | Reads one entry and its original address. Does not mark it read. |
| `list_reading`, `read_reading` | Lists and reads your library. Read only. |
| `save_reading` | Saves an address, or a note of your own, to your library. |
| `update_reading` | Changes a library item: status (unread, reading, done), summary, note, tags. |
| `remove_reading` | Deletes a library item when you ask. |

The tools read only what was already collected on this computer. Muted entries are left out unless asked for.

## Notices

`feed.entry`: a subscribed feed has a new entry, with its title, source, address, kind and folder. Muted entries are not told. Wake an agent with it in [Automations](https://docs.archetype.ing/en/use/automations.md).

## Settings

In **Manage → Plugins → Feeds**:

| Setting | What it does |
| - | - |
| **RSSHub server** | The RSSHub server for X and Threads. Archetype trusts this server, even at a private or Tailscale address. Sign-ins to X stay on RSSHub. |
| **Content folder** | A folder of Markdown notes you already keep, a folder per kind (`youtube/`, `books/`, `articles/`, `papers/`). The library reads it at start and when it changes. |

## Turn it off

Set `"plugins": { "reading": false }` in `~/.config/archetype/config.json`, or turn it off in **Manage → Plugins**. Its data is kept.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.