yawn.ai/docs/browser-extension
…/browser-extension
Sign In
Docs
Browser Extension.yawn SkillsMCP EndpointsAccord of Awake Agents
GitHub
Browser Extension

Download & Setup

Write normally. Yawn fills the missing clarity. Install the extension, connect your account, and let Yawn work alongside you.

Extension Landing Page

v1.0.0 · Manifest V3 · Chrome, Edge, Brave, Arc

Installation

1

Download the extension

Click the download button above or use the direct link to get the .zip file.

2

Unzip the archive

Extract yawn-chrome-extension.zip to a permanent folder on your computer. Do not delete this folder — Chrome reads from it.

3

Open Chrome Extensions

Navigate to chrome://extensions in your browser address bar.

chrome://extensions
4

Enable Developer Mode

Toggle the "Developer mode" switch in the top-right corner of the extensions page.

5

Load Unpacked

Click "Load unpacked" and select the unzipped extension folder (the one containing manifest.json).

6

Pin the extension

Click the puzzle piece icon in Chrome's toolbar, then pin the Yawn extension for quick access.

Developer Tip

Set devMode: true in chrome.storage.sync to point the extension at localhost:3000 instead of yawn.ai. Useful when running the Next.js app locally.

Configuration

Add your API key

Bring your own OpenAI or Anthropic key for LLM rewrites.

  1. Open the extension popup by clicking the 🥱 icon.
  2. Click "Settings" in the footer — this opens the config panel at yawn.ai.
  3. Under SETUP, paste your API key (sk-ant-... or sk-...) and click Save.
  4. The key is encrypted with AES-256-GCM and stored server-side. The extension uses it via /api/extension/rewrite — keys never leave the server.

Activate your license

Enter the license key from your purchase confirmation email.

  1. In the config panel under SETUP, find the "License activated" step.
  2. Enter the email used for purchase and your license key.
  3. Click "Activate" — the system validates against our license server.
  4. Once verified, the green checkmark appears and full features unlock.

Connect your Yawn account

Optional — enables saving insights, memories, and question answers to your Yawn profile.

optional
  1. Click "Connect Yawn Account" in the setup checklist or "Sign in to Yawn" in the popup.
  2. A new tab opens at yawn.ai/auth/extension-callback.
  3. Sign in or create an account with email + password.
  4. On success, your session token is sent to the extension automatically via Chrome messaging.
  5. You can verify the connection in the popup — "Account" should show "Connected".

Choose your web activities

Tell Yawn what you do on the web so it can adapt its suggestions.

  1. In the config panel, check the activity types that match your workflow.
  2. Options: Writing emails, AI prompting, Research, Social media, Coding, Shopping.
  3. Each activity type has sub-settings (tone, format, context) you can customize.
  4. More activities enabled = more tailored suggestions.

Connecting Your Yawn Account

How the auth handoff works under the hood

The Yawn extension uses Chrome's externally_connectable API to securely receive your session token from yawn.ai. Here's the flow:

1.You click "Connect Yawn Account" in the extension
2.New tab opens → yawn.ai/auth/extension-callback
3.You sign in with email + password (Supabase Auth)
4.Page calls chrome.runtime.sendMessage(extensionId, token)
5.Extension stores token in chrome.storage.session
6.✓ Connected — close the tab

The extension must be installed before you open the auth page. If you see "Could not reach the Yawn extension", make sure the extension is loaded and try again.

Self-Hosted Setup

Running your own Yawn instance? Point the extension at your deployment by configuring these values in chrome.storage.sync:

// Open DevTools on the extension's service worker
// (chrome://extensions → "Service Worker" link)
// Then run in the console:

chrome.storage.sync.set({
  devMode: true,
  supabaseUrl: 'https://your-project.supabase.co',
  supabaseAnonKey: 'eyJ...'
})
devModeWhen true, the extension calls localhost:3000 instead of yawn.ai. Set to false for production.
supabaseUrlYour Supabase project URL. Required for token refresh when connected to a self-hosted instance.
supabaseAnonKeyYour Supabase anon (public) key. Used for JWT refresh requests.

Tip: If you want the auth callback to work with your self-hosted instance, add your domain to manifest.json → externally_connectable → matches and set NEXT_PUBLIC_CHROME_EXTENSION_ID in your .env.local.

Keyboard Shortcuts

Alt + YInvoke Yawn on the current text field
Alt + Shift + YToggle Yawn active / inactive
Right-click → "Improve with Yawn"Rewrite selected text

FAQ

yawn.ai/docs/browser-extension

All DocsExtension LandingConnect Account