Browser Extension
The Q browser extension lets you hand any web page off to Q without leaving the tab. Open the popup, pick a project, tell Q what to do, and Q runs the task in your workspace in the background.
Currently in review — the extension is awaiting approval from the Chrome Web Store. Once approved (typically 1–3 business days after submission), we'll update this page with the install link and announce it in the changelog. In the meantime, the documentation below describes the full feature set so you can plan your workflow.
The browser extension is available on all paid plans and uses your normal AI credit budget. It requires an active Q account at heyq.com.
What You Can Do
Typical uses look like this:
- Browsing a competitor's release notes → "Create a DEV mission to copy this feature"
- Reading an industry report → "Update our market size in the Strategy files to the new $23B number"
- Landing on a competitor's homepage → "Add this competitor to the comparison matrix with a short summary"
- Reviewing a blog post → "Summarize the key points and save as a new page in the Growth folder"
The extension supports the full sidebar Q, so anything Q can do inside HeyQ — create files, update missions, edit pages, read your project — it can do from the popup too.
Installation
Install from the Chrome Web Store
Once the extension is approved, search for Q Web Trigger in the Chrome Web Store or follow the install link from your Account Settings. The extension works in Chrome, Edge, Brave, Arc, and any other Chromium-based browser. Until approval comes through, the install link will be inactive — we'll announce availability in the changelog.
Sign in at heyq.com
Make sure you're logged into heyq.com in the same browser. The extension reuses your existing session cookie — there is no separate API key setup.
Pin the extension (optional)
Click the puzzle icon in the Chrome toolbar and pin Q for one-click access.
Using the Extension
Open the popup on any page
Click the Q icon in the toolbar, or right-click anywhere on the page and pick Ask Q about this page. The extension reads the URL, title, and visible text of the current tab — only at the moment you click.
Pick a project
Choose which Q project this page relates to. The list shows every project you have access to, across all workspaces.
Type what you want Q to do
Anything you'd normally ask the sidebar Q works here. Examples: - "Create a DEV mission to copy the feature on this page." - "Update /strategy/market-size.md with the new $23B figure." - "Add this competitor to /competitors/index.md with a 2-line summary."
Submit and close
Hit Send. The job runs in the background via QStash, so you can close the popup and even the browser tab. The result lands in your Past runs tab, together with a deep link back to the affected file.
Capability Allowlist
You control which actions Q is allowed to perform from the extension on a per-project basis. In Project Settings → Integrations → Browser Extension, toggle:
| Capability | What it allows |
|---|---|
| Create | Q can create new files, missions, and pages. |
| Update | Q can edit existing files, missions, and pages. |
| Delete | Q can delete content. Off by default — turn on only if you trust the extension-mediated flow. |
| Firecrawl (deep scrape) | Lets Q use the firecrawlSingleUrlScrape tool when the cheap in-page text isn't rich enough. |
If Q tries to do something the allowlist forbids, it explains what it wanted to do and asks you to enable the capability.
Start conservative: Create and Update on, Delete and Firecrawl off. Turn on deeper capabilities once you've run a few jobs and trust the output.
Past Runs
Because QStash runs jobs in the background, you can close the popup or the tab and still see the final result:
- Open the popup on any page → Past runs tab
- Each row shows a status badge (running / done / error), the prompt, the originating URL, and the time
- Click a row to see the full result text and any deep links Q produced
Past runs are scoped to your user account and are not shared with other workspace members.
How It Works (Data Flow)
The extension is deliberately minimal about what it sends to our servers:
- When you open the popup and click Send, the extension POSTs to
https://heyq.com/api/q-web-trigger/jobswith:- the tab's URL and title
- a plain-text excerpt of the page's visible content
- any text you had selected
- the prompt you typed
- the target project ID
- The request is authenticated with your existing HeyQ login cookie — no separate API key is stored in the extension.
- Our server creates a job in your workspace and hands it off to a background worker via Upstash QStash.
- The worker runs the full sidebar Q, which may call our AI providers (OpenAI, Anthropic, Google via Vercel AI Gateway) and the Firecrawl tool if you allowed it.
- The popup polls for the final result and shows it with deep links back into HeyQ.
Nothing is transmitted passively or in the background. The extension does not install a persistent content script — the scrape function is injected only when you explicitly click Send or pick the context-menu entry.
For the complete story on what we store and how, see the Privacy Policy, in particular section 2.5 "Browser Extension Data".
Limits
To keep things stable and prevent accidental runaway jobs, the extension is rate-limited per user:
- 5 jobs per minute
- 30 jobs per hour
If you hit the limit, the popup shows a friendly message and you can retry after the window resets. Most real-world use stays far below this.
Troubleshooting
"Sign in on heyq.com" — You're not logged into HeyQ in this browser. Open heyq.com, sign in, then reopen the popup.
"You've hit the Q extension rate limit" — You've exceeded 5 jobs in the last minute or 30 jobs in the last hour. Wait a moment and try again.
Q says it tried something but was blocked — The capability allowlist for that project disallowed the action. Open Project Settings → Integrations → Browser Extension and toggle the required capability on.
"No projects available" — The extension only shows projects your account has access to. Make sure you're signed in as the right user and, if this is a fresh workspace, that you have at least one project created.
The popup loses state when I switch tabs — The popup persists in-flight
jobs via chrome.storage.session, so closing and reopening it should bring
you back to the running job. If it doesn't, check Past runs — the job is
still tracked there.
Uninstalling
Right-click the Q icon in the toolbar → Remove from Chrome. This removes the extension only. Any data already stored in your Q workspace is unaffected and can be deleted from within HeyQ at any time.
Privacy and Permissions
The extension requests the minimum permissions needed:
activeTab— read the tab you explicitly interact with, only at the moment you clickscripting— inject the one-shot scrape function on demandstorage— remember the active job ID and selected project between popup openscontextMenus— the "Ask Q about this page" right-click entrycookies+host_permissions: heyq.com— attach your existing HeyQ session cookie to API calls
The extension never runs on pages you haven't explicitly engaged with. Full details are in the Privacy Policy.