JobSentinel v2.0

The simplest way to automate your job search

Windows 11+ & macOS 26.1+ (Tahoe) • Zero Technical Knowledge • 100% Private • $0 Forever

Download • Features • Quick Start • Getting Started

⚡ What Changed in v2.0?

JobSentinel v2.0 is a complete rewrite from the ground up.

Why the Rewrite?

The original Python version was powerful but too complex for the target user: someone with zero technical knowledge who just wants to click an installer and have it work.

What's New?

Feature	v1.0 (Python)	v2.0 (Tauri/Rust)
Installation	Requires Python 3.12+, pip, Playwright	Single `.msi` installer, double-click to install
Size	~350MB (with dependencies)	~8MB installer
Startup Time	3-5 seconds	<0.5 seconds
Memory Usage	~500MB	~50MB
Admin Rights	Sometimes required	❌ Never required
Auto-Updates	Manual	✅ Built-in
Platform	Windows, macOS, Linux (complex setup)	Windows 11+ & macOS 26.1+ (Tahoe), Linux coming v2.1+

v2.0 Platform Support

Available Now:

✅ Windows 11+ - MSI installer
✅ macOS 26.1+ (Tahoe) - DMG installer

Coming Soon:

🔜 Linux (v2.1+) - .deb, .rpm, .AppImage

🎯 What is JobSentinel?

JobSentinel is a desktop app that:

Scrapes job boards (Greenhouse, Lever, JobsWithGPT) every 2 hours
Scores jobs using your preferences (skills, salary, location, company)
Alerts you on Slack when high-match jobs are found (90%+ score)

All data stays on your machine. No cloud. No tracking. No subscriptions.

🚀 Installation

Windows 11+

Prerequisites:

Windows 11 or newer
8MB disk space
No admin rights required

Steps:

Download JobSentinel-1.0.0-x64.msi from Releases
Double-click the .msi file
Follow the setup wizard (4 steps, ~2 minutes)
Done! App runs in your system tray

macOS 26.1+ (Tahoe)

Prerequisites:

macOS 26.1 (Tahoe) or newer
8MB disk space
No admin rights required

Steps:

Download JobSentinel-1.0.0-aarch64.dmg (Apple Silicon) or JobSentinel-1.0.0-x86_64.dmg (Intel) from Releases
Open the .dmg file
Drag JobSentinel to Applications
Launch from Applications or Spotlight
Follow the setup wizard (4 steps, ~2 minutes)
Done! App runs in your menu bar

✨ Features

v1.0 (Current)

Feature	Description
3 Job Boards	Greenhouse, Lever, JobsWithGPT (500K+ listings)
Smart Scoring	Skills 40%, Salary 25%, Location 20%, Company 10%, Recency 5%
Slack Alerts	Rich-formatted notifications for high matches
Auto-Scheduling	Scrapes every 2 hours (configurable)
Manual Trigger	Right-click tray icon → "Search Now"
SQLite Database	Local storage, full-text search
Setup Wizard	Interactive first-run configuration

v2.0 Roadmap

Email notifications (SMTP)
Reed.co.uk + JobSpy integration
Resume parsing and job-resume matching
Application tracker
ML-enhanced scoring
macOS support (.dmg installer)
Linux support (.deb, .rpm, .AppImage)

v3.0+ (Cloud)

GCP Cloud Run deployment
AWS Lambda deployment
Multi-user support
Web dashboard

🏗️ Architecture

Tech Stack

Layer	Technology	Purpose
Frontend	React 19 + Vite + TailwindCSS	Modern, responsive UI
Backend	Rust + Tokio	Async job scraping, scoring, notifications
Database	SQLite (SQLx)	Local job storage
Desktop	Tauri 2.1	Cross-platform desktop framework
HTTP	reqwest + scraper	Job board scraping
Notifications	Slack webhooks	Immediate alerts

Directory Structure (Future-Proof)

JobSentinel/
├── src-tauri/                # Rust backend
│   ├── src/
│   │   ├── core/            # Platform-agnostic business logic
│   │   │   ├── config/      # Configuration management
│   │   │   ├── db/          # SQLite database layer
│   │   │   ├── scrapers/    # Job board scrapers
│   │   │   ├── scoring/     # Multi-factor scoring
│   │   │   ├── notify/      # Slack notifications
│   │   │   └── scheduler/   # Job search scheduling
│   │   ├── platforms/       # Platform-specific code
│   │   │   ├── windows/     # Windows 11+ (v1.0)
│   │   │   ├── macos/       # macOS 13+ (v2.1+)
│   │   │   └── linux/       # Linux (v2.1+)
│   │   ├── cloud/           # Cloud deployment (v3.0+)
│   │   │   ├── gcp/         # Google Cloud Platform
│   │   │   └── aws/         # Amazon Web Services
│   │   └── commands/        # Tauri RPC commands
│   └── migrations/          # SQLite migrations
├── src/                     # React frontend
│   ├── pages/               # Setup Wizard, Dashboard
│   ├── components/          # Reusable UI components
│   └── lib/                 # Utilities
└── docs/                    # Documentation

Key Design Principles:

✅ Core business logic is platform-agnostic (works on Windows, macOS, Linux, cloud)
✅ Platform-specific code is isolated with conditional compilation
✅ Cloud deployment modules are separate (no bloat in desktop app)
✅ No refactoring needed when adding macOS, Linux, or cloud support

📖 Configuration

First-Run Setup Wizard

Job Titles: What roles are you looking for?
- Example: "Security Engineer", "Product Security Engineer"
Location: Remote, hybrid, or onsite?
- Example: Remote + Hybrid
Salary: Minimum salary in USD
- Example: $150,000
Slack (optional): Webhook URL for alerts
- Create at: https://api.slack.com/messaging/webhooks

Configuration File

Location:

Windows: %LOCALAPPDATA%\JobSentinel\config.json
macOS: ~/.config/jobsentinel/config.json

{
  "title_allowlist": ["Security Engineer", "Product Security"],
  "keywords_boost": ["Kubernetes", "AWS", "IAM"],
  "location_preferences": {
    "allow_remote": true,
    "allow_hybrid": true,
    "allow_onsite": false
  },
  "salary_floor_usd": 150000,
  "immediate_alert_threshold": 0.9,
  "scraping_interval_hours": 2,
  "alerts": {
    "slack": {
      "enabled": true,
      "webhook_url": "https://hooks.slack.com/services/..."
    }
  }
}

🎨 UI Preview

Setup Wizard

Interactive 4-step configuration

Dashboard

Recent jobs, statistics, manual search trigger

(Screenshots coming soon)

🔒 Privacy & Security

Feature	Status
Local-First	✅ All data on your machine
Zero Telemetry	✅ No tracking, no analytics
No Admin Rights	✅ Installs to `%LOCALAPPDATA%`
HTTPS Only	✅ Encrypted scraping
Open Source	✅ Audit the code
Code Signed	🔜 Coming soon

📝 Development

Prerequisites

Rust 1.83+
Node.js 20+
Tauri CLI 2.1+

Setup

# Clone repository
git clone https://github.com/cboyd0319/JobSentinel
cd JobSentinel

# Install dependencies
npm install

# Run in development mode
npm run tauri:dev

# Build for production
npm run tauri:build

Documentation

📖 Documentation Hub - Complete documentation index
🚀 Quick Start Guide - User installation and setup guide
💻 Getting Started - Developer setup and contribution guide
🍎 macOS Development - macOS-specific development guide
🤝 Contributing - Contribution guidelines
📊 Analysis Report - Complete security and code analysis

❓ Frequently Asked Questions (FAQ)

General Questions

Q: Is JobSentinel really free? A: Yes! 100% free, forever. No subscriptions, no hidden costs, no premium tiers. JobSentinel is open source under the MIT license.

Q: Do I need to create an account? A: No! JobSentinel runs entirely on your local machine. No account, no login, no cloud sync. Your data stays private.

Q: What job boards does it support? A: Currently Greenhouse, Lever, and JobsWithGPT (covering 500K+ job listings). More scrapers planned for v1.1+ (Reed.co.uk, LinkedIn, etc.).

Q: Can I use this for non-tech jobs? A: Absolutely! While designed for tech roles, JobSentinel works for any jobs posted on Greenhouse, Lever, or JobsWithGPT.

Q: Does it work offline? A: Partially. The app runs offline, but it needs internet to scrape job boards and send Slack notifications.

Privacy & Security

Q: What data does JobSentinel collect? A: Nothing! Zero telemetry, zero analytics, zero tracking. All data stays on your machine. We literally can't see your data.

Q: Is my Slack webhook secure? A: Yes. Webhooks are validated (must start with https://hooks.slack.com/services/), stored locally, and only used for job alerts you configure.

Q: Can someone else access my job data? A: Only if they have physical access to your computer. JobSentinel stores data in standard OS directories with your user permissions.

Setup & Configuration

Q: How long does setup take? A: ~2 minutes. The 4-step wizard covers job titles, location, salary, and Slack notifications (optional).

Q: Can I change my preferences later? A: Yes! Edit the config file:

Windows: %LOCALAPPDATA%\JobSentinel\config.json
macOS: ~/.config/jobsentinel/config.json

Q: What's a good starting configuration? A: See Configuration Presets below for role-specific templates.

Q: Do I need a Slack webhook? A: No, it's optional. Without Slack, you'll still see all jobs in the dashboard - you just won't get instant notifications.

Job Scraping & Scoring

Q: How often does it check for new jobs? A: Every 2 hours by default (configurable in config.json). You can also trigger manually via "Search Now".

Q: How accurate is the job scoring? A: Very good for title/salary/location matching. The algorithm uses: Skills (40%), Salary (25%), Location (20%), Company (10%), Recency (5%).

Q: Why am I not finding any jobs? A: Common fixes:

Broaden your title allowlist (try variations: "Engineer", "Developer", "Specialist")
Allow multiple locations (Remote + Hybrid)
Lower salary floor to $0 initially
Check that Greenhouse/Lever companies are hiring

Q: Can I search specific companies? A: Yes! Add company URLs to config.json:

{
  "greenhouse_urls": ["https://boards.greenhouse.io/cloudflare"],
  "lever_urls": ["https://jobs.lever.co/netflix"]
}

Technical Questions

Q: Does this require Python/Node.js/etc? A: No! JobSentinel is a single-file installer. No dependencies, no setup. Just double-click and go.

Q: What's the system requirements? A: Minimal:

Windows: Windows 11+, 8MB disk, no admin rights
macOS: macOS 26.1+ (Tahoe), 8MB disk, no admin rights

Q: Can I run multiple instances? A: Not recommended. One instance per user is optimal to avoid duplicate notifications and database conflicts.

Q: How do I update to a new version? A: Download the new installer and run it. Your config and database will be preserved.

Troubleshooting

Q: JobSentinel won't start A: Check:

Is it already running? (Check system tray/menu bar)
Run with RUST_LOG=debug to see error messages
Try reinstalling from the latest .msi/.dmg

Q: Slack notifications not working A: Verify:

Webhook URL starts with https://hooks.slack.com/services/
Slack app has permission to post
At least one job scores ≥90% (or your configured threshold)
Check logs with RUST_LOG=debug

Q: Database errors A: Rare, but if it happens:

Close JobSentinel
Backup database file
Delete database (will be recreated)
Restart JobSentinel

Q: High CPU usage A: JobSentinel only uses CPU during scraping (a few minutes every 2 hours). If constantly high, check for multiple instances running.

Comparison with Alternatives

Q: How is this better than LinkedIn Easy Apply? A:

✅ Privacy-first (LinkedIn tracks everything)
✅ Automated scoring (LinkedIn requires manual review)
✅ Covers more job boards (LinkedIn is just LinkedIn)
✅ Slack alerts for instant notifications
✅ 100% free (LinkedIn Premium is $40/month)

Q: How is this different from Indeed/Glassdoor? A: JobSentinel is an automation tool, not a job board. It scrapes multiple boards, scores jobs based on your preferences, and alerts you immediately.

Q: What about JobSpy or other scrapers? A: Most require Python setup, command-line knowledge, and manual configuration. JobSentinel is designed for zero technical knowledge - just click and go.

🎯 Configuration Presets

Quick-start templates for common roles:

Security Engineer

{
  "title_allowlist": ["Security Engineer", "AppSec Engineer", "Product Security"],
  "keywords_boost": ["Penetration Testing", "SAST", "DAST", "Threat Modeling", "AWS", "Kubernetes"],
  "location_preferences": { "allow_remote": true, "allow_hybrid": true, "allow_onsite": false },
  "salary_floor_usd": 150000
}

Frontend Developer

{
  "title_allowlist": ["Frontend Engineer", "Frontend Developer", "React Developer"],
  "keywords_boost": ["React", "TypeScript", "Next.js", "TailwindCSS", "GraphQL"],
  "keywords_exclude": ["Angular", "jQuery"],
  "location_preferences": { "allow_remote": true, "allow_hybrid": false, "allow_onsite": false },
  "salary_floor_usd": 120000
}

Backend Engineer

{
  "title_allowlist": ["Backend Engineer", "API Engineer", "Platform Engineer"],
  "keywords_boost": ["Python", "Go", "Rust", "Kubernetes", "PostgreSQL", "Microservices"],
  "location_preferences": { "allow_remote": true, "allow_hybrid": true, "allow_onsite": false },
  "salary_floor_usd": 140000
}

DevOps/SRE

{
  "title_allowlist": ["DevOps Engineer", "SRE", "Platform Engineer", "Infrastructure Engineer"],
  "keywords_boost": ["Kubernetes", "Terraform", "AWS", "Docker", "CI/CD", "Monitoring"],
  "location_preferences": { "allow_remote": true, "allow_hybrid": false, "allow_onsite": false },
  "salary_floor_usd": 150000
}

Data Scientist

{
  "title_allowlist": ["Data Scientist", "ML Engineer", "Machine Learning Engineer"],
  "keywords_boost": ["Python", "TensorFlow", "PyTorch", "SQL", "Statistics", "Deep Learning"],
  "location_preferences": { "allow_remote": true, "allow_hybrid": true, "allow_onsite": false },
  "salary_floor_usd": 130000
}

Product Manager

{
  "title_allowlist": ["Product Manager", "Senior Product Manager", "Group Product Manager"],
  "title_blocklist": ["Associate", "Junior", "Intern"],
  "keywords_boost": ["B2B", "SaaS", "Analytics", "User Research"],
  "location_preferences": { "allow_remote": true, "allow_hybrid": true, "allow_onsite": false },
  "salary_floor_usd": 140000
}

🤝 Contributing

We're not accepting contributions yet while v2.0 is in alpha. Check back in Q2 2025!

📜 License

MIT License - See LICENSE

✅ Commercial use
✅ Modification
✅ Distribution
✅ Private use
📋 License and copyright notice required

💬 Support

⭐ Star Us

If JobSentinel helps you land your next job, give us a star ⭐

Made with ❤️ for job seekers who value privacy

⬆ Back to top

Name		Name	Last commit message	Last commit date
Latest commit History 551 Commits
.github		.github
browser-extension		browser-extension
docs		docs
logs		logs
public		public
src-tauri		src-tauri
src		src
.env.example		.env.example
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
Dockerfile.dev		Dockerfile.dev
LICENSE		LICENSE
README.md		README.md
config.example.json		config.example.json
eslint.config.js		eslint.config.js
index.html		index.html
package-lock.json		package-lock.json
package.json		package.json
postcss.config.js		postcss.config.js
tailwind.config.js		tailwind.config.js
tsconfig.json		tsconfig.json
tsconfig.node.json		tsconfig.node.json
vite.config.ts		vite.config.ts

License

cboyd0319/JobSentinel

Folders and files

Latest commit

History

Repository files navigation

JobSentinel v2.0

The simplest way to automate your job search

⚡ What Changed in v2.0?

Why the Rewrite?

What's New?

v2.0 Platform Support

🎯 What is JobSentinel?

🚀 Installation

Windows 11+

macOS 26.1+ (Tahoe)

✨ Features

v1.0 (Current)

v2.0 Roadmap

v3.0+ (Cloud)

🏗️ Architecture

Tech Stack

Directory Structure (Future-Proof)

📖 Configuration

First-Run Setup Wizard

Configuration File

🎨 UI Preview

Setup Wizard

Dashboard

🔒 Privacy & Security

📝 Development

Prerequisites

Setup

Documentation

❓ Frequently Asked Questions (FAQ)

General Questions

Privacy & Security

Setup & Configuration

Job Scraping & Scoring

Technical Questions

Troubleshooting

Comparison with Alternatives

🎯 Configuration Presets

Security Engineer

Frontend Developer

Backend Engineer

DevOps/SRE

Data Scientist

Product Manager

🤝 Contributing

📜 License

💬 Support

⭐ Star Us

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Uh oh!

Contributors 5

Uh oh!

Languages