jobseek-cli
v1.0.4
Published
JobSeek CLI - AI-powered job search from your terminal
Maintainers
Readme
JobSeek CLI
AI-powered job search from your terminal. Search jobs, manage applications, optimize your resume, track unemployment claims, and prep for interviews — all without leaving the command line.
Features
- 🔍 Automated Job Search — Search Dice with AI-powered matching and scoring
- 🚀 Launch Pad — Open LinkedIn, Indeed, Glassdoor, and more in one command
- 📄 Resume Management — Upload, optimize for ATS, and generate download links
- 📝 Application Generation — AI-crafted cover letters and tailored resumes
- 🎯 Job Matching — Score any job against your profile (0-100%)
- 📊 Gap Analysis — Identify recurring skill gaps across your matches
- 💬 Interview Prep — Get STAR-format answer suggestions for any question
- 🏛️ Unemployment Insurance — Track claims, log work search, generate certification logs
- 🔑 SSH Authentication — Passwordless login with your SSH keys
Quick Start
npm install -g jobseek-cli
jobseek login
jobseek profileThe js shorthand alias is also available:
js login
js profileAuthentication
Browser SSO (recommended)
Opens your browser for Google/GitHub sign-in:
js login --browserAPI Key
Paste a key from your dashboard:
js login --key sk_live_your_key_hereSSH Key
Authenticate using an SSH key registered with JobSeek:
js login --sshRun
js loginwithout flags for an interactive prompt.
Commands
Profile & Resume
| Command | Description |
|---------|-------------|
| js profile | View your full profile (summary, skills, experience, education) |
| js profile form-data | Get structured data for form filling (--fields name,email,phone) |
| js resume | View your current resume |
| js resume upload <file> | Upload a resume PDF |
| js resume optimize | Optimize resume for ATS (--feedback "make summary more technical") |
| js resume link | Generate temporary download link (--open to open in browser) |
js resume upload ~/Documents/resume.pdf
js resume optimize --feedback "emphasize leadership experience"Job Search
| Command | Description |
|---------|-------------|
| js search launch | Open job boards in your browser (--query "React developer") |
| js search auto | Run automated Dice search with AI analysis |
| js jobs | List analyzed job matches |
| js jobs analyze | Find best fits and identify skill gaps |
| js jobs evaluate | Score a specific job against your profile |
# Automated search with filters
js search auto --keyword "Senior Engineer" --remote --posted SEVEN
# List top matches
js jobs --min-score 80 --sort matchScore
# Analyze a specific job
js jobs evaluate --title "Staff Engineer" --company "Acme" --file job-description.txt
# Skill gap analysis
js jobs analyze --mode gapssearch auto options
| Flag | Description |
|------|-------------|
| --keyword <text> | Search keyword |
| --location <text> | Location (omit for remote) |
| --remote | Remote jobs only |
| --hybrid | Hybrid jobs |
| --onsite | On-site jobs |
| --contract | Contract positions |
| --posted <days> | Posted within: ONE, THREE, SEVEN |
| --max-matches <n> | Max full matches to analyze (default: 10) |
| --min-score <n> | Minimum match score threshold (default: 60) |
Run
js search autowithout flags for an interactive wizard.
Applications
| Command | Description |
|---------|-------------|
| js apps | List job applications |
| js apps generate | Generate cover letter and tailored resume |
| js apps update <company> | Update application status |
# List applications with filters
js apps --status interview --sort matchScore
# Generate materials for a company
js apps generate --company "Stripe"
# Update status
js apps update "Acme Corp" --status interviewing --notes "Phone screen with hiring manager"apps update statuses
received · interviewing · rejected · offer · accepted · declined
Unemployment Insurance
| Command | Description |
|---------|-------------|
| js claims | List your UI claims and upcoming certifications |
| js claims create | Create a new claim (--state CA) |
| js claims log | Log a work search activity |
| js claims generate-log | Generate formatted log for certification period |
| js claims rules <state> | Show state-specific UI rules and contact info |
| js claims guidance | Get AI-powered guidance for your situation |
| js claims prefill | Pre-fill certification answers from tracked activities |
# Create a claim
js claims create --state NY --weekly-benefit 45000
# Log a work search activity
js claims log --date 2026-02-10 --type JOB_APPLICATION --employer "Acme" --title "Engineer"
# Generate log for certification
js claims generate-log --start 2026-02-01 --end 2026-02-14
# State rules lookup
js claims rules CA
# Get personalized guidance
js claims guidance --state NY --situation "Laid off from tech job 2 weeks ago"
# Pre-fill certification
js claims prefill --start 2026-02-01 --end 2026-02-14Activity types
JOB_APPLICATION · NETWORKING_EVENT · CAREER_COUNSELING · JOB_INTERVIEW · RESUME_SUBMISSION · EMPLOYER_CONTACT · ONLINE_JOB_SEARCH · TRAINING_WORKSHOP · OTHER
Interview Prep
# Inline question
js question "Tell me about a time you led a cross-functional project"
# Interactive prompt
js questionReturns multiple STAR-format answer suggestions tailored to your resume, plus tips.
Account
| Command | Description |
|---------|-------------|
| js whoami | Show current authenticated user |
| js usage | Show AI token/credit balance |
| js logout | Remove stored API key |
SSH Keys
| Command | Description |
|---------|-------------|
| js ssh-key add | Register an SSH public key (--key ~/.ssh/id_ed25519.pub) |
| js ssh-key list | List registered SSH keys |
| js ssh-key remove | Remove a registered SSH key |
Global Options
| Flag | Description |
|------|-------------|
| --json | Output as JSON (for scripting) |
| --no-color | Disable color output |
| --api-url <url> | Override API base URL |
| --api-key <key> | Override API key (per-command) |
Configuration
Credentials are stored in ~/.jobseek/config.json (mode 0600):
{
"apiKey": "sk_live_...",
"apiUrl": "https://www.getjobseek.com"
}Environment Variables
| Variable | Description |
|----------|-------------|
| JOBSEEK_API_KEY | API key (overrides config file) |
| JOBSEEK_API_URL | API base URL (overrides config file) |
| NO_COLOR | Disable color output (no-color.org) |
Priority: CLI flag > environment variable > config file > default.
Scripting & Automation
Use --json for machine-readable output:
# Get match scores as JSON
js jobs --min-score 80 --json | jq '.[].matchScore'
# Export applications to CSV
js apps --json | jq -r '.[] | [.job.company, .job.title, .status] | @csv'
# Use in CI/CD or cron jobs
JOBSEEK_API_KEY=sk_live_... js search auto --keyword "DevOps" --remote --jsonRelated
- getjobseek.com — Web dashboard
- jobseek-mcp — MCP server for Claude
- Chrome Extension — One-click job analysis from any job board
License
MIT © Shawn Mitchell
