README.md
July 19, 2025 · View on GitHub
The Interactive Browser.
Alpha software – APIs and security hardening are still evolving.
Quick Start
Download the latest image from the releases page and run it.
In the chat window’s bottom bar:
| Do this | What it enables |
|---|---|
| Sign in with Gmail | Email tooling |
| Sign in with Co-Browser | Persistent memory |
| Enter OpenAI API key | AI features |
That’s all, start browsing and Vibe adapts as you go.
Local Development
# Copy the environment template
cp .env.example .env
# Add your OpenAI key inside .env
# OPENAI_API_KEY=sk-xxxxxxxxxxxxx
# Install dependencies and start the app
pnpm install
pnpm dev
The desktop application will reload automatically as you edit the source code.
Configuration Flags
| Flag | Purpose |
|---|---|
USE_LOCAL_RAG_SERVER=true | Use a locally running RAG server. |
USE_LOCAL_GMAIL_AUTH=true | Use self-hosted Gmail OAuth (see below). |
USE_LOCAL_GMAIL_SERVER=true | Run Gmail MCP server locally (default: cloud). |
Self-Hosted Gmail OAuth
If you prefer to use your own Google Cloud project:
Console (Web) setup
- Select or create a project in the Google Cloud Console.
- Enable the Gmail API in the library.
- Create OAuth credentials (Desktop app) and download the JSON file.
gcloud (CLI) setup
# Authenticate and pick a project
gcloud auth login
# (Optional) create a new project
gcloud projects create YOUR_PROJECT_ID
# Activate the project
gcloud config set project YOUR_PROJECT_ID
# Enable the Gmail API
gcloud services enable gmail.googleapis.com
Create OAuth credentials for a Desktop application in the console (step 3 above) and download the JSON file.
Finish up
mkdir -p ~/.gmail-mcp
mv gcp-oauth.keys.json ~/.gmail-mcp/
Demo
Release Notes
Note
v0.1.8 - July 19, 2025
• Cloud Gmail Support: Gmail MCP server can now run in the cloud, controlled by
USE_LOCAL_GMAIL_SERVERenvironment variable
• Authentication UX: Added lock icon and tooltip to Gmail button showing when CoBrowser sign-in is needed for cloud access
• Enhanced Security: Improved token handling and added secure IPC channel for environment variable access • Flexible Deployment: Gmail integration now works seamlessly in both local and cloud modes
For the full technical changelog, see CHANGELOG.md.
Contributing
Please follow the guidelines in CONTRIBUTING.md.
The project’s code of conduct is available in CODE_OF_CONDUCT.md.