Chrome Extension
What is the GrooveOS Chrome Extension?
The GrooveOS Chrome extension is a web clipper — it lets you send selected text, URLs, or full page content to your team's GrooveOS memory in one click, from any website.
You choose the truth level before saving. A competitor's pricing page? Save as
WORKING. A confirmed client requirement? Save as VALIDATED.
It takes 5 seconds.
Clips are tagged with your team scope and project automatically, so they appear alongside Drive documents and chat conversations in your team's shared memory — no manual filing needed.
Installing the extension
A Chrome Web Store listing is on its way. While we're in private beta the extension is distributed as an unpacked folder you load yourself — same install flow for every team member.
- From your team dashboard, click Download Chrome extension to grab the latest
chrome-extension.zip(or ask your admin to share it on Drive). - Unzip it to a folder you'll keep on disk.
- Open Chrome and navigate to
chrome://extensionsin the address bar. - Enable the Developer mode toggle (top right corner).
- Click Load unpacked and select the unzipped folder.
- The GrooveOS icon appears in your Chrome toolbar.
Web Store listing coming soon
Public Chrome Web Store distribution is in the queue. Once it ships, your extension auto-updates without any operator step — same identity, same clips, no re-sign-in.
First use — Sign in
Click the GrooveOS icon in your toolbar. On first use:
- Click Sign in with GitHub.
- Authorize the xbrain GitHub App (members + email read-only — nothing else). See Authentication for the full permissions list.
- Your team scope is resolved automatically based on the GitHub orgs your team has wired up.
You will only need to sign in once — your xbt_ token is stored in
Chrome's secure session storage. Signing out of GrooveOS does not affect your
GitHub account.
Already signed in to GrooveOS?
If you're already signed in on the web app at grooveos.app, the extension picks up the same identity on first click. One sign-in per browser.
Clipping content
There are two ways to clip content from any page:
Right-click menu (fastest)
Select text on any page → right-click → Send to GrooveOS. The clip is saved immediately with your team's default settings.
Popup (full control)
- Click the GrooveOS icon in the toolbar.
- The current page title and URL are pre-filled in the popup.
- Add or edit the content you want to save.
- Choose the truth level:
EPHEMERAL/WORKING/VALIDATED/CANONICAL. - Optionally choose a project scope (defaults to your team's default project).
- Click Send to Brain.
A green confirmation appears. The clip is immediately searchable by your team.
Choosing a truth level
Use WORKING for anything you found but haven't verified. Use
VALIDATED for facts your team has confirmed. Reserve CANONICAL
for ground-truth information that should always appear in AI context. When in doubt,
use WORKING — you can promote it later.
What gets saved
Each clip becomes a memory item tagged with:
| Field | Value |
|---|---|
content |
Selected text, or page title + URL if nothing is selected |
source |
chrome-extension + the page URL |
truth_level |
What you chose in the popup |
team_scope |
Your team (set at login, cannot be changed per clip) |
project_scope |
What you selected, or your team's default project |
visibility |
team (default — visible to all team members) |
Managing clips
Clips appear in your team's memory alongside Drive documents and chat conversations. Search for them from LibreChat, Open WebUI, the Brain Monitor, or the API.
The fastest place to manage clips is the Brain Monitor:
- Promote a clip: click its truth-level badge and pick the new level.
- Soft-delete a clip you don't need: the row goes into a 30-day trash window — restorable until purged.
- Filter the feed by
source=chrome-extensionto see only the clips you've sent.
All actions are logged in the item's audit history with the user who made the change and the timestamp.
What's next
- Memory & Knowledge — Understand truth levels and how to promote clips over time.
- Drive Sync — Automatically index whole folders from Google Drive.
- API Reference — Query clips and all other memory items programmatically.