A comprehensive web-based tool for tracking job applications with AI-powered job posting analysis, Gmail integration, bulk operations, and advanced filtering capabilities.

git clone https://github.com/lbwalton/ai-job-tracker.git
cd ai-job-tracker

Quick Start: Run ./start_job_tracker.sh to launch the app locally at http://localhost:8080

• Job URL Analysis: Paste any job posting URL for automatic analysis
• Copy & Paste: Paste job posting content directly
• Describe Job: Use natural language to describe your application
• Manual Entry: Complete control with detailed form input

• Automatically extracts company, position, location, salary, and more
• Uses OpenAI GPT to parse job postings and descriptions
• Smart duplicate detection prevents accidental re-entries

• Search & Filter: Find jobs by company, position, location, status, or date range
• Column Sorting: Click headers to sort by any field
• Bulk Operations: Select multiple jobs to update dates, statuses, or delete
• Inline Editing: Click to edit company, position, or location directly

• Full-form editing modal for complete job details
• Editable application dates with automatic "days since" calculation
• Custom status options beyond the standard set
• Source URL tracking with clickable links

• Pre-defined statuses: Applied, Interview, Offer, Rejected
• Add custom statuses for your workflow
• Visual status indicators
• Progress tracking with "days since applied"

• Local browser storage with auto-save (every 30 seconds)
• Automatic backup system with corruption recovery
• Export/Import backup functionality (JSON format)
• CSV export for individual jobs or entire list
• Google Sheets integration
• Bulk data operations

• Connect your Gmail account to track job-related emails
• Automatic email synchronization
• OAuth 2.0 secure authentication
• View email threads associated with applications

• Modern web browser (Chrome, Firefox, Safari, Edge)
• Python 3 (for local server)
• OpenAI API key (optional, for AI analysis features)
• Google Cloud OAuth credentials (optional, for Gmail integration)

1. Clone the repository:

   git clone https://github.com/lbwalton/ai-job-tracker.git
   cd ai-job-tracker

2. Make the launcher executable:

   chmod +x start_job_tracker.sh

3. Launch the application:

   ./start_job_tracker.sh

   The app will automatically open in your browser at http://localhost:8080

4. Configure OpenAI API (optional, for AI features):

   • Get an API key from OpenAI Platform
   • Click "Configuration Setup" in the app
   • Enter your API key in the "OpenAI API Key" field
   • Your key is stored locally and only sent to OpenAI

5. Configure Gmail Integration (optional, for email tracking):

   • See README_SETUP.md for detailed Gmail setup instructions
   • Requires Google Cloud OAuth 2.0 credentials
   • Must run app via local server (not file://)

1. Select "Job URL" tab
2. Paste the job posting URL
3. Click "Analyze Job Posting"
4. Review extracted information
5. Click "Save to Tracker"

1. Select "Copy & Paste" tab
2. Copy the entire job posting text
3. Paste into the text area
4. Click "Analyze Job Posting"
5. Save when satisfied

1. Select "Describe Job" tab
2. Write in plain language: "I applied to Google for a Software Engineer position in Mountain View. It's full-time and pays around $150k"
3. Click "Analyze Description"
4. Review and save

1. Select "Manual Entry" tab
2. Fill in all known details
3. Click "Add Job Application"

• Search: Type in the search box to find specific jobs
• Status Filter: Use dropdown to filter by application status
• Date Range: Set "From" and "To" dates to filter by application period
• Clear Filters: Reset all filters and search

• Click any column header to sort by that field
• Click again to reverse the sort order
• Visual indicators show current sort direction

1. Select jobs using checkboxes
2. Use "Select All" to select everything
3. Choose bulk action:
   • Update Date: Set new application date for all selected
   • Update Status: Change status for all selected
   • Delete: Remove all selected jobs

• Inline Edit: Click company, position, or location to edit directly
• Full Edit: Click "Edit" button for complete form editing
• Date Edit: Click date field to change application date
• Status Edit: Use dropdown to change status

• System automatically detects potential duplicates
• Shows existing job details and current status
• Option to add anyway or disregard

ai-job-tracker/
├── job_tracker_app.html    # Main application (single-file web app)
├── start_job_tracker.sh    # Launch script for macOS/Linux
├── start_server.py         # Python HTTP server with auto-browser launch
├── README.md               # This file (main documentation)
├── README_SETUP.md         # Setup guide for quick start and Gmail
├── LICENSE                 # MIT License
└── .gitignore             # Git ignore file

The app uses OpenAI's GPT-3.5-turbo model to analyze job postings and extract:

• Company name
• Job title/position
• Location (including remote work)
• Salary range (if mentioned)
• Job type (full-time, part-time, contract, etc.)
• Experience level required
• Key skills and technologies
• Brief job description

• All data is stored locally in your browser's localStorage
• Auto-save: Automatically saves every 30 seconds
• Automatic backup: Creates backup copy with each save
• Corruption recovery: Automatically restores from backup if data is corrupted
• Manual backup: Export your data as JSON backup file
• Import/Restore: Restore from previously exported backup files
• No external servers or databases (your data stays on your machine)
• Data persists between browser sessions

• Your API key is stored locally only
• Job data never leaves your browser (except for AI analysis)
• No tracking or analytics
• Open source and transparent

AI Analysis Not Working

• Verify your OpenAI API key is correct
• Check your OpenAI account has available credits
• Ensure you have internet connection

Gmail Integration Issues

• Error 400: invalid_request: Make sure you're accessing via http://localhost:8080 (not file://)
• Check that http://localhost:8080 is in your OAuth authorized JavaScript origins
• Verify redirect URI is exactly: http://localhost:8080/job_tracker_app.html
• See README_SETUP.md for detailed Gmail setup instructions

Jobs Not Saving

• Data is auto-saved every 30 seconds - changes should persist automatically
• Check if localStorage is enabled in your browser
• Ensure you're not in private/incognito mode (localStorage is disabled)
• Try exporting a backup and refreshing the page
• Check browser console for error messages

Data Recovery

• The app automatically creates backups - if data is lost, try refreshing the page
• Use "Export Backup" in Configuration Setup to manually save your data
• Use "Import Backup" to restore from a previously exported file

App Won't Start

• Make sure Python 3 is installed: python3 --version
• Make script executable: chmod +x start_job_tracker.sh
• Try running manually: python3 start_server.py

Port 8080 Already in Use

• Edit start_server.py and change PORT = 8080 to another number (e.g., 8081)
• Update any bookmarks and OAuth settings with the new port number

Export Not Working

• Make sure pop-ups are allowed for the page
• Try a different browser
• Check that downloads are enabled

Performance Issues

• Clear old job entries you no longer need
• Use filters to reduce displayed jobs
• Try refreshing the browser

• Check the browser console (F12) for error messages
• Ensure you're using a supported browser
• Verify all form fields are filled correctly
• See README_SETUP.md for setup help

We welcome contributions! Here's how you can help:

1. Fork the repository
2. Create a feature branch: git checkout -b feature-name
3. Make your changes
4. Test thoroughly
5. Submit a pull request

• Keep the single-file architecture
• Maintain compatibility with all supported browsers
• Add comments for complex functionality
• Test all features before submitting

This project is licensed under the MIT License - see the LICENSE file for details.

• OpenAI for providing the GPT API for job posting analysis
• AllOrigins for CORS proxy service
• Google Sheets integration inspiration

• Enhanced email filtering and categorization
• Calendar integration for interview scheduling
• Resume and cover letter management
• Analytics dashboard with success metrics
• Mobile app version
• Team/collaborative features

• v1.5 - Added Gmail integration with OAuth 2.0
• v1.5 - Implemented enhanced data persistence with auto-save and backup/restore
• v1.5 - Added accordion-style configuration UI
• v1.4 - Enhanced editing capabilities
• v1.3 - Added search and filtering
• v1.2 - Implemented bulk operations
• v1.1 - Added AI analysis features
• v1.0 - Initial release with basic tracking

Made with ❤️ for job seekers everywhere

Star this repository if you find it helpful!