Skip to content

Architecture & Product Design

Beyond Binary Blocklists: How WhyFirst Understands Your Intent

On this page
  1. Introduction: The Problem with Traditional Site Blockers
  2. The First Principle: A Simple Question Instead of a Wall
  3. How WhyFirst Evaluates Your Intent
  4. Q1: Catching Evasive Inputs and Random Typing
  5. Q2: Matching Your Intent with Your Own Site Rules
  6. Q3: Allow, Clarify, or Block: A More Flexible Three-Way Choice
  7. Real-World Testing: Is It Fast, Smart, and Reliable?
  8. 1. Understanding Slang and Everyday Excuses Across Languages
  9. 2. Judging Your Intent, Not Just the Website Address
  10. 3. Instant Decisions Without Disrupting Your Flow
  11. 4. Reliable and Consistent, Not Moody or Unpredictable
  12. Privacy & Control: Your Data Stays in Your Hands
  13. 1. Sending Only What Is Strictly Necessary
  14. 2. Local-First by Default
  15. 3. Choose Your Own Decision Model or Run Completely Offline
  16. Conclusion: Regaining Focus, One Intention at a Time

Key Takeaways (TL;DR)

  • The Problem: Modern work relies on the same platforms (YouTube, Reddit, X, GitHub) that host endless distractions. Binary domain blocklists force an impossible choice: either block everything and lose research tools, or unblock everything and fall into doomscrolling.
  • The Solution: WhyFirst replaces rigid blocklists with intent-aware checks. Instead of judging the domain, an AI decision model evaluates your stated reason against your personal purpose for that site.
  • The Benchmarks: Under 0.3s response time, 8-language colloquial slang recognition, and local-first privacy (BYOK & Ollama offline support, zero browsing history leaves your device).

Introduction: The Problem with Traditional Site Blockers

For over two decades, the standard approach of digital self-discipline tools has been simple and blunt: the website blocker. You set up a blacklist of domains (social media, video platforms, discussion boards), and whenever you try to open one during focus hours, a software wall blocks your path, often accompanied by guilt-inducing messages or artificial delays.

Yet anyone who does creative, engineering, or research work knows why this approach constantly breaks down. Modern work does not happen in a sterile vacuum. The very platforms often labeled as "distractions" are frequently essential knowledge hubs:

  • YouTube has endless algorithmic feeds, but it also hosts university lectures, in-depth tutorials, and conference talks indispensable to professionals.
  • Reddit and X can eat up hours of scrolling, but they are also primary sources for real-time news and breaking updates, where niche hardware bugs, driver issues, and system outages are documented first.
  • Conversely, seemingly "virtuous" work tools (such as GitHub, Linear, or Notion) are not immune to distraction: wandering through drama in issue threads or endlessly reorganizing task boards is often just sophisticated procrastination.

Treating an entire website as either purely "good" or purely "bad" fundamentally misunderstands how modern work gets done. When a tool forces you into a rigid binary choice between blocking the site completely or unblocking it completely, most people eventually just turn the blocker off.

The problem is not the website you visit. The problem is your intent at the exact moment you open it. WhyFirst is designed to help surface that intention from your subconscious, making you consciously aware of habits that otherwise run on autopilot.


The First Principle: A Simple Question Instead of a Wall

When WhyFirst intercepts a site you have marked for attention, its mechanism is deliberately simple: a momentary pause and a quiet question: "Why are you visiting this site right now?"

Writing down an answer creates a natural pause. It breaks the automatic reflex of opening a new tab when you feel tired or bored. In many cases, having to put your reason into words is enough to realize, "I don't actually need this right now," and close the tab voluntarily.

However, relying entirely on self-reporting has obvious limits. When we are tired or craving distraction, it is easy to game the system: typing a single letter, mashing random keys, or typing vague excuses just to get through.

This is where AI judgment comes in. But what should AI do in this moment? If it merely acts as a rigid keyword filter, it inherits all the flaws of traditional blockers. If it lectures you like a strict proctor, it feels annoying and intrusive. And if the AI is slow to respond, having to wait breaks your working flow all over again.

Our goal was to design an intent evaluation model that acts not as a strict jailer, but as a calm, helpful mirror.


How WhyFirst Evaluates Your Intent

Instead of a simple pass-or-fail check, WhyFirst looks at your stated reason through three practical, step-by-step considerations.

Q1: Catching Evasive Inputs and Random Typing

The first check is straightforward: did you give an understandable reason, or was it just a reflex to bypass the prompt?

  • Evasive inputs: Random keyboard mashing ("asdfghjkl"), single punctuation marks, empty filler, or candid admissions of avoidance ("just bored", "killing time").
  • Legitimate inputs: Any clear statement of a specific goal, task, or question you want to answer.

This step acts as a quick reality check. If an input has no meaningful purpose, the tool gently holds the page rather than letting the excuse slide through.

Q2: Matching Your Intent with Your Own Site Rules

A big flaw of conventional blockers is imposing one-size-fits-all assumptions about what websites are for. But everyone uses the internet differently. WhyFirst solves this by letting you define the intended role of each site for yourself.

You can tell WhyFirst what a site means in your own daily routine:

"YouTube is where I watch technical tutorials and conference talks."

When an intervention happens, the AI does not judge the website in isolation. It compares your stated reason against the purpose you personally set for that site:

  • Writing "Watching a tutorial on a development framework" on YouTube matches your study rule, so it is approved.
  • Writing "Checking out trending movie trailers" on that same site contradicts your declared purpose, so it is held back.
  • Conversely, typing "Browsing gossip on user profiles" on GitHub is recognized as distraction, even though GitHub is generally a work tool.

This alignment turns the AI into a partner helping you stick to your own goals, rather than an arbitrary censor.

Q3: Allow, Clarify, or Block: A More Flexible Three-Way Choice

In real life, our intentions are rarely purely black and white. Many visits start in a fuzzy middle ground: "Checking recent industry discussions" or "Looking at tech news."

A rigid blocker either falsely stops you when you genuinely need to explore, or lets vague browsing slide into aimless scrolling. WhyFirst handles this ambiguity with three distinct options:

  1. Allow: Your reason is specific, clear, and fits your declared purpose for the site (for example, "Looking up configuration syntax for Docker macvlan"). You proceed immediately.
  2. Block: Your reason describes procrastination, boredom, or mindless browsing (such as "Procrastinating until our meeting starts"). The intervention holds firm.
  3. Clarify: Your reason is on the borderline or a bit too vague. Rather than shutting you out, WhyFirst asks a single helpful follow-up question: Can you name the specific question or topic you need to look into?

The Clarify option gives you a gentle moment to reflect, turning a vague impulse into a clear, focused task.


Real-World Testing: Is It Fast, Smart, and Reliable?

Good ideas need to hold up in daily use. We put our evaluation model through rigorous testing across 8 major languages (Chinese, English, Japanese, Korean, French, German, Spanish, and Russian) to see how it performs under real-world conditions.

1. Understanding Slang and Everyday Excuses Across Languages

When people procrastinate, they rarely write formal academic sentences. They use colloquial idioms and workplace slang:

  • Korean "월급루팡" (slacking on the clock)
  • Japanese "サボり" (cutting corners / slacking off)
  • French "glander" (loafing around)
  • German "rumgammeln" (idling away time)
  • Spanish "hacer el vago" (playing lazy)
  • Russian "позалипать" (spacing out)
  • Chinese "划水等下班" (coasting until clock-out)

In multilingual testing, the model recognized these everyday expressions with high accuracy, identifying casual excuses without needing fragile, hardcoded lists of slang words for every language.

2. Judging Your Intent, Not Just the Website Address

To make sure the model truly understands your purpose rather than blindly judging website names, we tested deliberate swaps between work and entertainment sites:

  • Legitimate research on entertainment platforms: When users entered serious research and debugging reasons on platforms like X, TikTok, or video sites, the system correctly allowed access every time.
  • Distraction on work tools: When users entered clear distraction reasons (like "just scrolling through drama") on tools like GitHub, Linear, or Slack, the system correctly blocked access every time.

The test confirmed that your stated intent matters far more than the website's general reputation.

3. Instant Decisions Without Disrupting Your Flow

An intervention should never leave you staring at a loading spinner. Powered by the latest Jev family of decision models, while accurately understanding your real intent:

  • The evaluation completes in about 0.3 seconds on average (less than a third of a second);
  • Because WhyFirst evaluates your reason only after you actively confirm and submit it, the response appears almost instantaneously, keeping your working rhythm smooth and uninterrupted.

4. Reliable and Consistent, Not Moody or Unpredictable

A common frustration with AI chatbots is unpredictability: asking the exact same question on different days can sometimes lead to different answers. WhyFirst is calibrated specifically for consistency. Given the same reason and context, the system's decisions remain steady and predictable: it will not approve a reason one minute and reject the exact same reason the next.


Privacy & Control: Your Data Stays in Your Hands

Introducing AI into browser interactions naturally brings up privacy questions. WhyFirst was built from day one as a local-first tool designed to keep your personal data strictly private.

1. Sending Only What Is Strictly Necessary

When an AI evaluation takes place, the request contains only minimal necessary details:

  • The reason you typed into the prompt box;
  • The normalized domain name of the site you are visiting (such as "youtube.com");
  • (Optional) Any custom context you added for that site and how you intend to use it healthily.

Full page URLs, search parameters, browsing history, webpage text, cookies, and personal accounts never leave your browser.

2. Local-First by Default

The extension checks your privacy settings locally before making any network call. If you turn off reason storage in settings, no remote request is initiated, and the extension falls back to local rules on your device.

3. Choose Your Own Decision Model or Run Completely Offline

For users who want complete independence over their setup, WhyFirst provides flexible control:

  • Direct integration with the Jev decision model: You can connect directly to our dedicated Jev model family, optimized specifically for fast and accurate intent evaluation;
  • Bring Your Own Key (BYOK) or run locally: You can plug in your own API key for models like OpenAI's GPT series or DeepSeek, with requests going straight from your browser to your chosen provider without passing through any WhyFirst servers. And if you are a privacy-first enthusiast, you can pair it with local models like Ollama, running entirely on your own machine with zero internet connection, zero data leaving your device, and no ongoing API costs.

Conclusion: Regaining Focus, One Intention at a Time

Managing your attention does not have to be an all-or-nothing battle between extreme restrictions and total loss of focus.

By replacing blunt blocklists with thoughtful, context-aware intent checks, WhyFirst turns moments of automatic distraction into conscious choices. You stay in control of your tools, your rules, and your data, while enjoying a calm companion that simply helps you remember what you set out to do.