Quick Start

This guide gets you from a fresh install to a cleaner X feed in a few minutes.

1. Open the Welcome Flow

After a fresh install, XpressPurge opens a welcome page.

From there you can:

open https://x.com/home and try the extension immediately;
open Options and set up filters first.

If the onboarding wizard appears in Options, you can use it to create starter rules and optionally bundle them into a starter preset. A fresh local state does not ship with permanent default rules or presets already enabled.

2. Turn Filtering On

Click the XpressPurge icon in your browser toolbar.

In the popup:

make sure the main switch is On;
check the Hidden today, Rules, and Presets numbers;
use Open X if you are not already on X.

3. Create Your First Rule From a Post

On X, look for the small flame button added to detected posts.

Click the flame button to open the post menu. Depending on the post and your plan, you can:

hide the author;
add a quick keyword rule;
train a reviewed rule from this post;
open the full rule modal;
open XpressPurge Options.

This is the fastest way to teach XpressPurge what you want to remove.

4. Create or Edit Rules in Options

Open Options > Rules.

Click Create rule, then choose:

Rule type: what the extension should match;
Action: Hide, Boost, Snooze, or Show-only;
Values: keywords, handles, domains, post content chips, or an engagement number;
Preset: optional group where the rule should belong.

Free includes up to 5 custom rules and up to 5 values per rule. Pro unlocks unlimited rules, unlimited values, Boost, Snooze, and Show-only.

5. Add Presets When You Need Them

Presets are optional. They are useful when you want groups of rules you can toggle on and off together.

Open Options > Presets to create one.

Free includes up to 2 custom presets and up to 2 active presets at a time. Pro removes those limits.

6. Check Smart Rules or Analytics if You Have Pro

If you have Pro:

open Smart to opt in to local feed history, save a Smart Profile, and analyze your last 500 retained posts;
open Analytics to view hidden-post impact, top rules, top presets, top hidden accounts, and range-based charts.

Both features stay local-first. Smart Rules feed history is opt-in and clearable.

7. Keep It Local or Enable Sync

By default, XpressPurge keeps your data local.

If you have Pro, you can enable browser sync from Sync. It syncs rules, presets, active presets, filtering state, hide behavior, and Show-only mode through your browser account.

Browser sync does not include Smart Rules feed history, hidden-log previews, or analytics events.