Installation

Install the VibeCheck Chrome extension and sign in with your Google account.

Click Add to Chrome, then pin the extension to your toolbar for quick access.

Build from source

Want the latest features before they reach the store? Build locally:

git clone https://github.com/kosbay/vibe-check.git
cd vibe-check && yarn install
cd extension && yarn build

Then open chrome://extensions, enable Developer mode, click Load unpacked, and select the extension/dist/chrome-mv3 folder. See the Download page for detailed steps.

Required permissions

VibeCheck requests the following permissions:

Permission	Purpose
`activeTab`	Access the current tab for screenshots and DOM capture
`tabCapture`	Record the current tab's screen
`scripting`	Inject content scripts for action tracking and replay
`storage`	Save settings and usage data locally
`identity`	Sign in with your Google account
`offscreen`	Process recordings in the background

Click the VibeCheck icon in your toolbar, then click Sign in with Google. This links your recordings to your account so you can access them on the VibeCheck platform.

You must sign in before recording. VibeCheck uses Google OAuth — we never see or store your password.

Verify installation

After signing in, you should see:

Your Google avatar in the popup header
Recording buttons (Video + Screenshot) enabled
Your usage counter showing remaining recordings for the month

System requirements

Browser: Google Chrome 116 or later
OS: Windows, macOS, or Linux
Display: Works with any resolution; recordings capture at your screen's native resolution

Troubleshooting

Extension icon not visible

Click the puzzle piece (Extensions) icon in Chrome's toolbar and pin VibeCheck.

Make sure you're using a Google account. Third-party cookies must be enabled for accounts.google.com. Try disabling other extensions that may block OAuth popups.

Try signing out and back in. If the issue persists, remove and reinstall the extension.

Download Quick Start