Skip to main content
Version: Next

JobOps Documentation

Welcome to the JobOps documentation. This site contains guides for setup, configuration, and day-to-day usage.

Getting Started​

  • Self-Hosting Guide

    • Docker setup instructions
    • Gmail OAuth configuration for email tracking
    • Environment variables reference
    • Demo mode deployment

  • Database Backups

    • Automatic backup scheduling and retention
    • Manual backup creation/deletion
    • Restore workflow and troubleshooting

Workflows​

  • Find Jobs and Apply Workflow

    • Run pipeline first, then review discovered and ready jobs
    • Use fit assessment and score to prioritize applications
    • Mark jobs as applied to trigger webhooks and analytics

  • Post-Application Workflow

    • Track events manually for direct control
    • Or configure automatic Gmail sync and inbox review
    • Move confirmed updates into in-progress tracking

Feature Documentation​

  • Orchestrator

    • Job states explained (discovered, ready, applied, etc.)
    • The ready flow (manual vs auto)
    • PDF generation and regeneration
    • Post-application tracking overview

  • Pipeline Run

    • Run modal controls (Automatic vs Manual)
    • Presets, source/country compatibility, and advanced settings
    • Run estimate and start conditions

  • Job Search Bar

    • Open with Cmd+K / Ctrl+K or the Search button
    • Fuzzy search across title, company, and location
    • Use @status lock syntax to scope results quickly

  • Keyboard Shortcuts

    • Full Jobs-page shortcut reference by context
    • ? shortcut help dialog and Control hint bar behavior
    • Tab-specific actions like skip, move to ready, and mark applied

  • Multi-Select and Bulk Actions

    • Select many jobs using row checkboxes or select-all
    • Run bulk move, skip, and rescore actions from the floating action bar
    • Keyboard support for select, clear, and fast bulk move-to-ready

  • Settings

    • LLM provider/model and task-specific overrides
    • Webhooks, service accounts, and basic auth controls
    • Backup scheduling, scoring thresholds, and danger-zone cleanup tools

  • Reactive Resume

    • Base resume selection and RxResume integration
    • Project inclusion controls (must-include, AI-selectable, max)
    • PDF generation behavior and troubleshooting

  • Applications Overview

    • Applications-per-day trend
    • Conversion analytics and funnel
    • Duration window controls (7d, 14d, 30d, 90d)

  • In Progress Board

    • Pre-application vs post-application workflow split
    • Kanban tracking for higher-attention opportunities
    • Drag-and-drop stage management

  • Ghostwriter

    • One persistent conversation per job
    • Streaming responses, stop, and regenerate
    • Markdown rendering and drawer behavior
    • Writing style settings impact

  • Post-Application Tracking

    • How the Smart Router AI works
    • Gmail integration setup
    • Using the Tracking Inbox
    • Privacy and security details
    • API reference

  • Visa Sponsors

    • Search licensed UK sponsor organizations
    • Review company routes and sponsor ratings
    • Trigger manual data refresh

Extractors​

Quick Reference​

Main Components​

  • Orchestrator: Main application (UI, API, database)
  • Extractors: Specialized job crawlers
  • Shared: Common types and utilities

Key Features​

  1. Job Discovery: Automatically find jobs from multiple sources.
  2. AI Scoring: Rank jobs by suitability for your profile.
  3. Resume Tailoring: Generate custom resumes for each job.
  4. PDF Export: Create tailored PDFs via RxResume integration.
  5. Application Tracking: Monitor your applied jobs.
  6. Email Tracking: Auto-track post-application responses.

Contributing to Documentation​

When adding user-visible behavior:

  1. Update the relevant feature page in current docs.
  2. Add API documentation where relevant.
  3. Keep examples realistic and copy-pasteable.
  4. Include diagrams for non-trivial workflows.

Support​

  • Open an issue for documentation errors.
  • Check these docs before opening support requests.