Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
144 changes: 135 additions & 9 deletions .cursor/skills/review-pr/SKILL.md

Large diffs are not rendered by default.

1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

### Added

- **Reddit** — New connector that polls watched subreddits and surfaces posts matching your keywords and minimum score (one channel conversation per subreddit). Read-only mode uses application-only OAuth (`client_id` + `client_secret`); enabling commenting during `void setup` runs a browser OAuth flow, stores a `refresh_token`, syncs matching posts as comment threads, and lets you reply via `void reply` / `void send --via reddit`. Tune filters at runtime with `void reddit subreddits|keywords|min-score|config`.
- **Slack** — Sync "Saved for Later" items from the Later view during background sync; view with `void slack saved`. Setup wizard documents the required `search:read` scope.
- **Google News** — New read-only connector that watches the public Google News RSS feed. Each configured keyword triggers its own search; matching articles land in your inbox, filtered by a recency window. Configure with `void gn keywords`, `void gn when`, `void gn language`, and `void gn country` (or interactively via `void setup`). Language/country default to `fr`/`FR`; add one connection per edition to follow several.

Expand Down
24 changes: 24 additions & 0 deletions Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 2 additions & 0 deletions Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ members = [
"crates/void-hackernews",
"crates/void-googlenews",
"crates/void-linkedin",
"crates/void-reddit",
"crates/void-github",
]

Expand Down Expand Up @@ -85,4 +86,5 @@ void-telegram = { path = "crates/void-telegram" }
void-hackernews = { path = "crates/void-hackernews" }
void-googlenews = { path = "crates/void-googlenews" }
void-linkedin = { path = "crates/void-linkedin" }
void-reddit = { path = "crates/void-reddit" }
void-github = { path = "crates/void-github" }
18 changes: 15 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
[![License: AGPL-3.0](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE)
[![Rust](https://img.shields.io/badge/rust-1.95%2B-orange.svg)](Cargo.toml)

**One inbox for everything.** `void` unifies WhatsApp, Telegram, Slack, Gmail, Google Calendar, LinkedIn, GitHub, Hacker News, and Google News into a single local-first command-line tool — one inbox, one search index, one set of commands.
**One inbox for everything.** `void` unifies WhatsApp, Telegram, Slack, Gmail, Google Calendar, LinkedIn, GitHub, Hacker News, Google News, and Reddit into a single local-first command-line tool — one inbox, one search index, one set of commands.

It is built for terminals, shell scripts, and AI agents:

Expand Down Expand Up @@ -116,6 +116,18 @@ void hn keywords add "rust,local-first"
void hn min-score 100
```

### Reddit

Keyword- and score-filtered posts from watched subreddits land in your inbox like any other message. Enable commenting during `void setup` to sync thread comments and reply from the CLI (browser OAuth, stores `refresh_token`).

```bash
void reddit subreddits add "rust,programming"
void reddit keywords add "ai,llm"
void reddit min-score 50
void reddit config
void reply <message-id> --message "Thanks!"
```

### Google News

Keyword-watched articles from the public Google News RSS feed land in your inbox — one search per keyword, filtered by recency:
Expand Down Expand Up @@ -150,14 +162,14 @@ A background daemon keeps a local SQLite database in sync with every connected s
void ◄──────────► SQLite (FTS5) ◄────── sync daemon ──────► services
WhatsApp │ Telegram │ Slack ──── push (WebSocket / MTProto)
Gmail │ Calendar │ LinkedIn │ GitHub │ HN │ Google News ──── polling
Gmail │ Calendar │ LinkedIn │ GitHub │ HN │ Google News │ Reddit ──── polling
```

| Crate | Role |
|-------|------|
| `void-core` | Config, database, models, hooks, `Connector` trait, sync engine |
| `void-cli` | The `void` binary: clap commands, output formatting |
| `void-slack`, `void-gmail`, `void-calendar`, `void-whatsapp`, `void-telegram`, `void-hackernews`, `void-googlenews`, `void-linkedin`, `void-github` | One crate per connector |
| `void-slack`, `void-gmail`, `void-calendar`, `void-whatsapp`, `void-telegram`, `void-hackernews`, `void-googlenews`, `void-linkedin`, `void-github`, `void-reddit` | One crate per connector |

All data stays on your machine in `~/.local/share/void` — no external database, no Docker, no cloud. Layout details: [Configuration](docs/configuration.md#data-storage-layout).

Expand Down
3 changes: 3 additions & 0 deletions crates/void-cli/Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@ void-telegram = { workspace = true }
void-hackernews = { workspace = true }
void-googlenews = { workspace = true }
void-linkedin = { workspace = true }
void-reddit = { workspace = true }
void-github = { workspace = true }
clap = { workspace = true }
tokio = { workspace = true }
Expand All @@ -34,6 +35,8 @@ libc = { workspace = true }
croner = { workspace = true }
sysinfo = { workspace = true }
uuid = { workspace = true }
open = { workspace = true }
urlencoding = { workspace = true }
inventory = { workspace = true }
toml = { workspace = true }

Expand Down
18 changes: 18 additions & 0 deletions crates/void-cli/src/cli.rs
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,9 @@ pub(crate) enum Command {
Hn(commands::hackernews::HackerNewsArgs),
/// Google News configuration (keywords, recency, language, country)
Gn(commands::googlenews::GoogleNewsArgs),
/// Reddit configuration (subreddits, keywords, min-score)
#[command(name = "reddit", alias = "rd")]
Reddit(commands::reddit::RedditArgs),
/// Slack-specific operations (react, edit, schedule, open, forward)
Slack(commands::slack::SlackArgs),
/// WhatsApp-specific operations (media download)
Expand Down Expand Up @@ -186,6 +189,7 @@ async fn async_main(cli: Cli) -> anyhow::Result<()> {
Some(Command::Gmail(args)) => commands::gmail::run(args).await,
Some(Command::Hn(args)) => Ok(commands::hackernews::run(args)?),
Some(Command::Gn(args)) => Ok(commands::googlenews::run(args)?),
Some(Command::Reddit(args)) => Ok(commands::reddit::run(args)?),
Some(Command::Slack(args)) => commands::slack::run(args).await,
Some(Command::Whatsapp(args)) => commands::whatsapp::run(args).await,
Some(Command::Telegram(args)) => commands::telegram::run(args).await,
Expand Down Expand Up @@ -287,13 +291,27 @@ mod tests {
assert!(context::runs_with_local_cache(cmd));
}

#[test]
fn reddit_keywords_list_uses_local_cache() {
let cli = parse(&["void", "reddit", "keywords", "list"]);
let cmd = cli.command.as_ref().expect("command");
assert!(context::runs_with_local_cache(cmd));
}

#[test]
fn slack_saved_uses_local_cache() {
let cli = parse(&["void", "slack", "saved"]);
let cmd = cli.command.as_ref().expect("command");
assert!(context::runs_with_local_cache(cmd));
}

#[test]
fn reddit_min_score_uses_remote_proxy_in_remote_mode() {
let cli = parse(&["void", "reddit", "min-score", "100"]);
let cmd = cli.command.as_ref().expect("command");
assert!(!context::runs_with_local_cache(cmd));
}

#[test]
fn parse_slack_saved_minimal() {
let cli = parse(&["void", "slack", "saved"]);
Expand Down
1 change: 1 addition & 0 deletions crates/void-cli/src/commands/mod.rs
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ pub mod linkedin;
pub mod messages;
pub mod mute;
pub mod pagination;
pub mod reddit;
pub mod remote;
pub mod reply;
pub mod resolve;
Expand Down
Loading