RSS Reader using AT Protocol
rssbase.io
feed
atom
rss
reader
atproto
social
improve setup
Romain Gautier
(Jul 7, 2026, 5:59 PM +0200)
7c998234
1386b92a
+70
-4
+18
-2
AGENTS.md
+18
-2
AGENTS.md
···
8
8
- url: rssbase.io
9
9
10
10
## Dev environment tips
11
-
If `DEVENV_ROOT` env variable is defined, just run project binaries (they are available).
12
-
If not, run them by prefixing with `devenv shell ...`
11
+
Project binaries such as `rtk`, `tang`, `dagger`, `docker-buildx`, and `docker-compose` are provided by devenv.
12
+
13
+
If `DEVENV_ROOT` env variable is defined, the devenv environment is active: run project binaries directly.
14
+
If not, run project binaries by prefixing them with `devenv shell ...`.
15
+
16
+
Examples:
17
+
18
+
```bash
19
+
# Active devenv
20
+
rtk git status
21
+
tang issue list
22
+
dagger check
23
+
24
+
# Outside devenv
25
+
devenv shell rtk git status
26
+
devenv shell tang issue list
27
+
devenv shell dagger check
28
+
```
13
29
14
30
## Agent skills
15
31
+33
CONTEXT.md
+33
CONTEXT.md
···
1
+
# RSSBase
2
+
3
+
RSSBase is a feed reader that stores reader-owned data through AT Protocol.
4
+
5
+
## Language
6
+
7
+
**RSSBase**:
8
+
The product and service at rssbase.io: a reader for subscribing to, organizing, and reading feeds.
9
+
_Avoid_: rssbase, RSS Base
10
+
11
+
**Feed reader**:
12
+
An application that lets a reader follow feeds and read their entries in one place.
13
+
_Avoid_: RSS reader, news reader
14
+
15
+
**Reader**:
16
+
A person using RSSBase to subscribe to feeds and read entries.
17
+
_Avoid_: user, customer, account
18
+
19
+
**Feed**:
20
+
A syndicated source of entries that RSSBase can subscribe to and display.
21
+
_Avoid_: RSS feed, source, channel
22
+
23
+
**Entry**:
24
+
A single item published by a feed and shown to a reader.
25
+
_Avoid_: post, article, item
26
+
27
+
**Reader data**:
28
+
Data that belongs to a reader, such as subscriptions, preferences, and reading state.
29
+
_Avoid_: user data, account data
30
+
31
+
**AT Protocol**:
32
+
The decentralized protocol RSSBase uses as the home for reader-owned data.
33
+
_Avoid_: atproto, ATProto, Bluesky
+19
-2
RTK.md
+19
-2
RTK.md
···
4
4
5
5
## Rule
6
6
7
-
Always prefix shell commands with `rtk`.
7
+
Always run shell commands through `rtk`, but remember that `rtk` is a project binary provided by devenv.
8
8
9
-
Examples:
9
+
If `DEVENV_ROOT` is defined, the devenv environment is active and `rtk` is available directly:
10
10
11
11
```bash
12
12
rtk git status
···
15
15
rtk pytest -q
16
16
```
17
17
18
+
If `DEVENV_ROOT` is not defined, wrap commands with `devenv shell` so `rtk` is available:
19
+
20
+
```bash
21
+
devenv shell rtk git status
22
+
devenv shell rtk cargo test
23
+
devenv shell rtk npm run build
24
+
devenv shell rtk pytest -q
25
+
```
26
+
27
+
The same devenv rule applies to other repo-provided binaries such as `tang`, `dagger`, `docker-buildx`, and `docker-compose`.
28
+
18
29
## Meta Commands
19
30
20
31
```bash
···
26
37
## Verification
27
38
28
39
```bash
40
+
# Active devenv
29
41
rtk --version
30
42
rtk gain
31
43
which rtk
44
+
45
+
# Outside devenv
46
+
devenv shell rtk --version
47
+
devenv shell rtk gain
48
+
devenv shell which rtk
32
49
```