DanielPan12/JobHuntBot

What it solves

JobHuntBot transforms the chaotic process of applying for jobs into a structured, repeatable system. It prevents the common pitfalls of manual job hunting—such as losing track of applications, inconsistent resume versions, and the risk of AI hallucinating personal details—by providing a framework that combines AI automation with human oversight.

How it works

Instead of being a standalone application, JobHuntBot is a set of instructions and templates designed to be used with any AI coding agent (like Claude Code, Cursor, or Codex CLI) that can read local files and control a browser.

1. Initialization: The agent reads SKILL.md and your personal materials to fill out templates for your candidate profile, application rules, and resume strategies.
2. Execution: The agent searches for job leads, classifies them, and—if granted browser access via tools like Playwright—fills out application forms and uploads resumes.
3. Safety Gates: The agent is strictly forbidden from guessing sensitive legal or identity information and must pause for explicit human confirmation before clicking the final submit button.
4. Tracking: All progress is logged into CSV files, which are then visualized through a local, zero-dependency Node.js dashboard that tracks application status and interview schedules.

Who it’s for

Job seekers who use AI coding agents and want to automate the tedious parts of job applications (searching and form-filling) while maintaining total control over the final submission and data privacy.

Highlights

• Agent-Agnostic: Works with any AI agent capable of reading files and using a browser.
• Human-in-the-Loop: Explicit safety boundaries prevent the AI from fabricating experience or submitting applications without consent.
• Local Dashboard: A simple, private HTML/Node.js interface to track "Pending", "Applied", and "Ended" jobs without sending data to an external server.
• Structured Knowledge: Uses an "answer bank" and "experience bank" to ensure consistent and truthful responses across different applications.