Listeners

What a Listener is, how each form section works, and how to tune it for better matches.

What is a Listener?

A Listener is a saved set of instructions that tells Earshot which Reddit communities to watch and what to look for. Think of it as a pair of ears pointed at the conversations you care about.

Each Listener:

  • Monitors specific subreddits (Reddit communities)
  • Filters posts and comments using keywords and other rules
  • Runs on a schedule you set (every N minutes)
  • Surfaces matches as drafts (Solo) or monitored posts (Scout)

You can have multiple Listeners — for example, one watching founder communities and another watching developer tool discussions.

The goal isn't maximum drafts. It's high-intent threads where you can genuinely help. Tuning is iterative — expect to adjust weekly for the first few weeks.

Screenshot: Listeners list page showing a listener card with status and health metrics
ScreenshotListeners list page showing a listener card with status and health metrics

Creating a Listener

Go to Listeners → New listener. The form walks you through five sections.

Listener basics

FieldWhat it does
Listener nameA label to tell this listener apart from others you create.
Broad topics to focus onTopics and angles the AI should care about when picking posts to reply to.

Screenshot: New listener form showing Listener name and Broad topics to focus on fields
ScreenshotNew listener form showing Listener name and Broad topics to focus on fields

Click Next. Earshot suggests communities based on your topic text.

Communities

  • Suggested communities — click Suggest subreddits to refresh ideas from your focus text, then Add the ones that fit.
  • Search subreddits — type to search the catalog (communities with 10k+ members). Pick up to your plan's subreddit limit per Listener.
  • Community rules — for each selected subreddit, expand Community rules — r/{name} to read moderator rules. This will give you an idea on what's allowed in each subreddit BEFORE you start listening.

Screenshot: Subreddit picker and suggested communities on the new listener form
ScreenshotSubreddit picker and suggested communities on the new listener form

Keyword configuration

FieldWhat it does
Primary keywordsA post or comment must mention at least one of these terms to be considered. Required — at least one.
Posts must also includeOptional extra terms. Choose Any of (match any secondary term) or All of (must match every secondary term).
Negative termsExclude posts that mention both a primary keyword and any of these terms.
Negative authorsSkip posts from these Reddit usernames for this listener only. Enter without u/.
Exact matchMatch standalone terms, domains, and handles — not embedded substrings. On by default.
Case sensitiveUseful for acronyms like RAG that should not match "rag". Off by default.

These rules apply only to this Listener. For account-wide author exclusions, see Global keywords below.

Screenshot: Listener keyword configuration with Primary keywords and Negative terms
ScreenshotListener keyword configuration with Primary keywords and Negative terms

Global keywords

Settings → Global keywords blocks authors account-wide:

LevelWhereScope
Per-listenerNegative authors on the Listener formThis Listener only
Account-wideSettings → Global keywordsNegative authorsAll Listeners

Help text on the settings page: "Posts from these authors are skipped across all listeners." There are no global keyword inclusions — only author exclusions at the account level.

Posts and comments

In the app this section is labeled: What to watch for.

FieldWhat it does
Watch forComments, Posts, or Both.
Check every (minutes)How often this Listener runs. Minimum 10 minutes; maximum 24 hours (1440 minutes). Click Suggest for a recommendation based on subreddit activity.
How deep in the thread?Shown when watching comments. Top-level comments only or I'm okay with more depth (replies to top-level comments).

On Solo, you'll also see Writing voice (attach a Persona) and Knowledge bases (attach reference docs) before the final section. Both are optional. Scout hides these cards.

Fine tuning

In the app this section is a collapsible card titled Fine-tuning.

FieldWhat it does
How strict should filtering be?Loose lets more through; Medium is balanced (default); Tight is more selective.
Minimum comment lengthIgnore comments shorter than this many words. Default: 8. (the default skips short comments which don't add much value)
Skip downvoted commentsDon't draft replies for comments with a negative score. On by default. (the default skips downvoted comments which are likely not worth replying to)

Click Create listener. You'll land on the edit page for your new Listener.

Editing a Listener

On the edit page, all sections are visible at once. The main difference from create:

  • Active toggle — Run this listener on schedule. Turn off to pause scheduled checks.
  • Attached knowledge basesRemove existing links or Attach new ones with the Add knowledge base dropdown.

Save your changes when done.

Listener runs

Listeners run automatically on the schedule you set.

On each listener card you'll see:

  • Next check in {time} — when the next scheduled run is due
  • Last checked {time} ago — when the last run finished
  • Paused — if you've turned off the Active toggle
  • Checking soon — if the Listener has never run yet

While a run is in progress, you'll see Running pipeline… with a progress bar.

Health funnel

Each card shows a Health section with a funnel:

Scanned → Keyword filter → Contextual filter → Drafts (Solo) or Matches (Scout) → Posted

PatternLikely causeFix
High scanned, low keyword filterKeywords too broad or too fewAdd negative terms, tighten primaries
High keyword, low contextualStrictness too tight or focus text too narrowLoosen strictness, broaden your topic description
High contextual, low drafts(shouldn't occur ideally) Solo draft limit or processing issueCheck daily limit
High drafts, low postedYou're rejecting a lot (that's OK!) or not posting yetReview draft quality, tune Persona/KB

Screenshot: Listener card health funnel showing Scanned, Keyword filter, Contextual filter, and Drafts or Matches stages
ScreenshotListener card health funnel showing Scanned, Keyword filter, Contextual filter, and Drafts or Matches stages

Run history

Expand Run history on a listener card to see what each scheduled check did — duration, items scanned, keyword and contextual filter counts, and drafts produced. Use this to tune keywords, strictness, and subreddits.

Scout vs Solo differences

FeatureScoutSolo
Output label on cardMatchesDrafts
Writing voice (Persona)HiddenAvailable
Knowledge basesHiddenAvailable
Listener limitUp to 3Up to 10
Subreddits per ListenerUp to 6Up to 10

What's next