feedbinctl 0.1.1

Index and search Feedbin entries from the command line
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130

# feedbinctl

Index compact metadata from Feedbin into SQLite, search it locally, and fetch
complete entries on demand.

*Disclaimer:* This project is an exercise with Codex.

## Install

```sh
cargo install --path .
```

For development, replace `feedbinctl` in the examples below with `cargo run --`.
Both builds use the same operating-system keyring entry.

## Authenticate

```sh
feedbinctl auth
feedbinctl auth --logout
```

`auth` validates your Feedbin username and password before storing them in the
operating-system keyring. For non-interactive environments, `FEEDBIN_TOKEN`
may instead contain `username:password`.

## Maintain the index

```sh
feedbinctl index
```

The first run downloads the complete entry history. Later runs use the exact
`created_at` timestamp from the last completed run as Feedbin's `since` cursor.
This makes the command suitable for cron:

```cron
*/15 * * * * /usr/local/bin/feedbinctl index
```

Entries are fetched and committed one API page at a time. The cursor advances
only after all pages succeed, so an interrupted run can safely be repeated.
Upserts make repeated pages harmless.

To build a complete replacement database while leaving the current database in
place until the download succeeds:

```sh
feedbinctl index --rebuild
```

The default database uses an XDG-style data directory and is separated by
build profile:

- Installed binaries and `cargo run --release`:
  `${XDG_DATA_HOME:-~/.local/share}/feedbinctl/feedbin.sqlite`
- Debug builds such as `cargo run`:
  `${XDG_DATA_HOME:-~/.local/share}/feedbinctl/feedbin-dev.sqlite`

This keeps development indexing separate from the index used by an installed
binary. Both profiles continue to use the same operating-system keyring entry.
`XDG_DATA_HOME`, when set, must be an absolute path.

Use `--database PATH` on `index`, `entries`, or `search` to override it.

## Browse recent entries

```sh
feedbinctl entries --limit 50
```

`entries` reads SQLite and never contacts Feedbin. Results are ordered by
`created_at` and then entry ID, newest first. For the next stable page, pass the
last result's ID:

```sh
feedbinctl entries --limit 50 --before 5154510253
```

This keyset pagination remains stable when a later `index` run inserts newer
entries.

## Search

```sh
feedbinctl search distributed
feedbinctl search 'distributed AND systems'
feedbinctl search 'feed_title:example' --limit 50
```

`search` is local and uses SQLite FTS5 syntax over title, URL, author, and feed
title. Both `entries` and `search` print JSON arrays containing compact metadata:

```json
{
  "id": 5154510253,
  "feed_id": 42,
  "title": "Distributed systems",
  "url": "https://example.com/post",
  "author": "Example Author",
  "feed_title": "Example Feed",
  "feed_url": "https://example.com/feed.xml",
  "site_url": "https://example.com",
  "published": "2026-09-01T12:00:00Z",
  "created_at": "2026-09-01T12:01:00Z"
}
```

## Fetch full content

Search results intentionally omit article bodies. Fetch the selected entry from
Feedbin by ID:

```sh
feedbinctl entry 5154510253
```

`entry` contacts Feedbin and prints the complete current object, including
`summary`, `content`, and `extracted_content_url`.

Every command documents its behavior and examples through Clap:

```sh
feedbinctl --help
feedbinctl index --help
feedbinctl entries --help
feedbinctl search --help
feedbinctl entry --help
```