theaayushstha1/apply-job

Job Application Agent

Automated job application system with multi-channel recruiter outreach.

Quick Start

/apply-job <url>              # Apply to specific job
/apply-job search <query>     # Search and batch apply
/apply-job outreach <url>     # Recruiter outreach only
/apply-job status             # View statistics
/apply-job score <url>        # Score job fit only

Setup Required

Before first use, ensure these files exist:

| File | Purpose | |------|---------| | $APPLIER_HOME/data/profile.json | Your personal info (from template) | | $APPLIER_HOME/data/applications.json | Application tracking | | $APPLIER_HOME/resume/master_resume.md | Your complete resume | | $APPLIER_HOME/templates/cover_letter.md | Cover letter template | | $APPLIER_HOME/templates/cold_email.md | Cold email template |

$APPLIER_HOME = ~/job-applier-agent (cross-platform)

See SETUP.md for installation instructions.

---

Core Principles

AUTO-PROCEED Mode

• DO NOT ask for confirmation at routine steps
• JUST DO IT - proceed through entire workflow automatically
• ONLY STOP for: login walls, CAPTCHA, critical errors, fit score < 5.0

⚠️ Outreach Order (CRITICAL)

1. Find recruiters on LinkedIn (names, titles, URLs)
2. Discover email addresses (WebSearch company email pattern)
3. Send cold emails via Gmail FIRST
4. THEN send LinkedIn connection requests
5. Track everything in applications.json

Email = PRIMARY (higher response rate). LinkedIn = SECONDARY.

---

Workflow: Apply to Job URL

Step 1: Extract Job Description

1. Navigate to job URL with Playwright
2. Capture page snapshot
3. Extract: title, company, location, requirements
4. Identify key skills/technologies

Step 2: Score Job Fit (0-10 each)

• Technical Fit: Skills match percentage
• Level Match: Appropriate for experience level
• Location: Remote/local/relocation
• Mission: Company alignment

Score >= 5.0 → AUTO-PROCEED | Score < 5.0 → Notify user

Step 3: Tailor Resume

1. Read $APPLIER_HOME/resume/master_resume.md
2. Reorder projects by relevance to JD
3. Emphasize matching skills (use JD keywords)
4. Save to $APPLIER_HOME/applications/<Company>/

Rules: Never add fake skills. Never fabricate metrics. Only reorder/emphasize.

Step 4: Generate Cover Letter

1. Read $APPLIER_HOME/templates/cover_letter.md
2. Research company (WebFetch)
3. Personalize for role + company
4. Keep to 250-350 words
5. Save to $APPLIER_HOME/applications/<Company>/

Step 5: Auto-Fill Application

Use Playwright to fill forms based on platform:

• LinkedIn Easy Apply
• Company career pages (Greenhouse, Lever, Workday, ADP, etc.)
• Upload resume, add cover letter if field exists

Step 6: Track & Screenshot

1. Take confirmation screenshot
2. Update $APPLIER_HOME/data/applications.json
3. Update stats

Step 7: Recruiter Outreach

See WORKFLOWS.md for detailed outreach steps.

Summary:

1. Search LinkedIn for company recruiters (3+ people)
2. Discover emails via WebSearch (company email pattern)
3. Send cold emails via Gmail (use template)
4. Send LinkedIn connections (after emails)
5. Track all outreach in applications.json

---

Recruiter Contact Discovery

Use publicly available contact information only:

1. Check the recruiter's LinkedIn profile for contact info
2. Check the company careers page for recruiter contact details
3. Use the company's public contact form if no direct contact is available

---

Profile Configuration

All personal data comes from $APPLIER_HOME/data/profile.json:

{
  "personal": {
    "name": "Your Name",
    "email": "[email protected]",
    "phone": "123-456-7890",
    "location": "City, State"
  },
  "links": {
    "website": "https://yoursite.com",
    "linkedin": "linkedin.com/in/you",
    "github": "github.com/you"
  },
  "education": {
    "school": "University Name",
    "degree": "BS Computer Science",
    "gpa": "3.9",
    "graduation": "May 2026"
  },
  "headline": "Your professional headline",
  "top_skills": ["Python", "React", "AWS"],
  "flagship_project": {
    "name": "Project Name",
    "description": "Brief description",
    "users": "100+"
  },
  "work_auth": true,
  "willing_to_relocate": true,
  "location_preference": ["Remote", "NYC", "SF"]
}

See profile-template.json for full template.

---

Application Tracking

$APPLIER_HOME/data/applications.json schema:

{
  "applications": [{
    "id": "company-date-001",
    "company": "Company Name",
    "role": "Job Title",
    "url": "https://...",
    "platform": "linkedin|greenhouse|workday|adp",
    "applied_date": "2026-01-27",
    "status": "applied|interviewed|rejected|offer",
    "fit_score": 7.5,
    "cover_letter": true,
    "outreach": [{
      "name": "Recruiter Name",
      "title": "Technical Recruiter",
      "email": "[email protected]",
      "linkedin": "linkedin.com/in/...",
      "email_sent": true,
      "connection_sent": true,
      "date": "2026-01-27"
    }]
  }],
  "stats": {
    "total": 0,
    "applied": 0,
    "interviewed": 0,
    "emailsSent": 0,
    "connectionsSent": 0
  }
}

---

Cold Email Template

Subject: Referral Request - [Role] Application | [School] [Major] Senior

Hi [First Name],

I just applied for the [Role] position at [Company] and wanted to reach out.

I'm a [Major] senior at [School] ([GPA] GPA) graduating [Graduation].
[Flagship project description with metrics].

[1-2 sentences about why THIS company excites you]

Would appreciate if you could review my application or put in a referral.

Thanks!
[Name]
[Website]
[Phone]

Rules: Under 150 words. Personalize company line. Include contact info.

---

Error Handling

| Error | Action | |-------|--------| | Login required | Notify user, wait for "continue" | | CAPTCHA | Notify user, wait | | Rate limit | Wait 60s, retry once, skip if still blocked | | Email failed | Log, continue with LinkedIn | | Form field missing | Screenshot, ask user |

---

Reference Files

| File | Content | |------|---------| | WORKFLOWS.md | Detailed step-by-step workflows | | SETUP.md | Installation & configuration | | profile-template.json | Profile data template |

---

Path Variables

| Variable | Default | Description | |----------|---------|-------------| | $APPLIER_HOME | ~/job-applier-agent | Base directory | | $APPLICATIONS_DIR | $APPLIER_HOME/applications | Per-company files |

Cross-platform: Use ~/ which expands to home directory on all OS.

---

Best Practices

1. Email FIRST, LinkedIn SECOND - Always send emails before connections
2. AUTO-PROCEED - Don't ask, just do (except critical errors)
3. Track everything - Update applications.json after every action
4. Personalize - Reference specific company details in outreach
5. Screenshot - Capture confirmation for records
6. Be honest - Never fabricate skills or metrics

---

Line Count: ~280 (under 500 ✓) Cross-Platform: Yes (uses ~/ paths) ✓ User-Agnostic: Yes (data in profile.json) ✓