Vega AI Job Capture Extension

Save job listings to your personal dashboard with one click.

This Chrome extension adds a floating button to LinkedIn job pages that lets you save jobs directly to your Vega AI dashboard. All actions are initiated by you. The extension never collects or saves data automatically. Works with both the cloud service and self-hosted Vega AI backends.

✨ Features

• 🎯 Shows on job pages on LinkedIn when you visit them
• 💾 User-initiated save with the floating button
• 📝 Add notes before saving (saved locally too)
• 🔐 Secure authentication: username/password with encrypted storage
• 🌐 Cloud or self-hosted: your choice
• ⚡ Keyboard shortcuts: Ctrl+Shift+V to toggle, Ctrl+S to save
• 🔔 Version updates: Automatic update notifications
• 🔄 Syncs across devices when signed in

🎬 How it Works

1. Go to any LinkedIn job posting
2. Click the floating Vega AI button
3. Add your notes (optional)
4. Hit save and you're done

No more copy-pasting job details.

📥 Get Started

Install the Extension

Direct Download from GitHub (Recommended)

1. Visit the latest release page
2. Download the vega-extension-*.zip file
3. Unzip the file to a folder on your computer
4. Open Chrome and go to chrome://extensions/
5. Turn on "Developer mode" (toggle in top right)
6. Click "Load unpacked" and select your unzipped folder

Alternative: Build from Source

See the Developer Guide below for building from source

Set Up Your Account

1. Create an account at vega.benidevo.com
2. Click the Vega AI icon in your browser toolbar
3. If you're using the cloud service, just sign in
4. For self-hosted backends, switch to Local Mode in settings
5. Browse LinkedIn jobs and start saving!

---

🛠️ For Developers

Click to expand developer setup instructions

Prerequisites

• Node.js 22+ and npm
• Chrome browser

Quick Setup

# Clone and install
git clone https://github.com/benidevo/vega-ai-extension.git
cd vega-ai-extension
npm install

# Build and load
npm run build

Then load the dist folder as an unpacked extension in Chrome.

Development Commands

npm run dev        # Watch mode for development
npm run build      # Production build
npm run test       # Run tests
npm run lint       # Check code style
npm run typecheck  # Check TypeScript types

Configuration

By default, the extension uses username/password auth and connects to the cloud backend. You can change these defaults:

Backend Modes:

• Cloud Mode: https://vega.benidevo.com (default)
• Local Mode: Your own backend (set host/port in settings)

Authentication:

• Username/Password authentication with secure token storage
• Encrypted local storage for credentials
• Automatic session management

Project Structure

The code is organized into these main parts:

• Background: Service worker that handles auth, API calls, and messaging
• Content: Scripts that run on LinkedIn pages to detect jobs
• Popup: The extension popup where users sign in and change settings
• Services: Reusable modules for common functionality

📚 Documentation

• 📖 Development Guide - How to build and contribute
• 🏗️ Technical Design - Architecture and implementation details

🔒 Privacy & Security

Your privacy is priority:

• ✅ User-initiated only: The extension never reads or saves data automatically
• ✅ You control your data: Only saves jobs when you explicitly click the save button
• ✅ No tracking: No analytics, no data collection beyond what you choose to save
• ✅ Encrypted storage: Your authentication tokens are encrypted locally
• ✅ Open source: Review the code to see exactly what the extension does
• ✅ Minimal permissions: Only accesses LinkedIn job pages, nothing else

Read the full Privacy Policy for complete details.

🆘 Need Help?

• 📖 FAQ
• 🐛 Report a bug
• 💡 Request a feature
• 💬 Discussions

📝 License

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

What this means:

• ✅ You can use, study, modify, and distribute the code
• ✅ If you run this software on a server, you must make your source code available to users
• ✅ Any modifications must also be released under AGPL-3.0

For commercial licensing without AGPL requirements, email [email protected].