$ jobx --help

Automate Your Job Hunt with AI

JobX is an AI-powered CLI tool that automates job applications, generates personalized emails, and tracks applications using Google Sheets.

npm install -g jobx
npm versionnpm downloadsGitHub starsLicense

Powerful Features

Everything you need to automate your job search and land your dream role

AI-Powered Email Generation

Generate personalized job application emails using OpenAI API with context-aware content

Google Sheets Integration

Track all your applications in real-time with automatic logging and analytics

Automated Workflow

Complete job application automation from discovery to submission with simple commands

Email Submission

Submit applications directly from CLI with SMTP configuration support

Templates & Profiles

Create reusable templates and profiles for different job application scenarios

Privacy First

All credentials stored locally, API keys only transmitted to respective services

Installation & Quick Start

Prerequisites

Node.js 18 or later
npm or yarn package manager
TypeScript knowledge (helpful but not required)
Google Sheets API credentials (optional)
OpenAI API key (for email generation)

Installation Steps

1

npm install -g jobx

Install JobX globally

2

jobx init

Initialize project configuration

3

jobx test

Validate your configuration

4

jobx mail --generate

Start generating applications

Generated Configuration Files

jobx.config.json

Profile and contact information

jobx.credentials.json

API keys and authentication

jobx.apply.json

Active job application metadata

jobx.mail.md

Generated email output

CLI Commands

All available commands and their options for full job automation control

Usage

jobx init

Description

Sets up jobx.config.json, jobx.credentials.json, and jobx.apply.json files with default values

Configuration

Set up JobX with your credentials and preferences for automated job applications

jobx.apply.json

{
  "company": "Company Name",
  "company_email": "hiring@company.com",
  "company_website": "https://company.com",
  "location": "Remote",
  "subject": "Application for Position Title",
  "position": "Position Title",
  "experience": "2 years",
  "education": "Bachelor's Degree",
  "job_source": "https://jobboard.com/posting/12345"
}

OpenAI API Setup

  1. 1. Visit OpenAI API Keys
  2. 2. Create an API key in your account
  3. 3. Add the key to jobx.credentials.json as open_ai_secret
  4. 4. Ensure your account has credits

Google Sheets Setup

  1. 1. Go to Google Cloud Console and create a project
  2. 2. Enable Google Sheets API
  3. 3. Create a service account and download JSON key
  4. 4. Add client_email and private_key to credentials
  5. 5. Create a Google Sheet and share it with the service account email

Gmail SMTP Setup

  1. 1. Enable 2-factor authentication on your Gmail account
  2. 2. Generate an app-specific password
  3. 3. Add your email to lsa_user
  4. 4. Add the app password to lsa_pass

Quick Start

  1. 1. Run jobx init to create config files
  2. 2. Fill in your credentials in jobx.credentials.json
  3. 3. Update job details in jobx.apply.json
  4. 4. Run jobx mail --generate to create emails