Skip to content

Repository files navigation

⚡ CareerForge

CareerForge Laptop Hero Banner

Local, Zero-Cost, Privacy-First AI Job Search Engine & Career Co-Pilot
Packageable as an Open-Source Skill for Claude Code, Gemini / Antigravity, and OpenAI Codex / Cursor.

Live Website GitHub Repository MIT License


🌐 Live Website & Documentation

Visit the interactive website and full visual guide at:
👉 https://cerint.github.io/CareerForge/


🤖 Multi-Agent Compatibility Matrix

CareerForge natively supports all major AI agent platforms:

AI Agent Engine Skill Location Supported Auto-Discovery Status
Claude Code .claude/skills/careerforge/SKILL.md ✅ Native
Gemini / Antigravity .agents/skills/careerforge/SKILL.md ✅ Native
OpenAI Codex / Cursor .codex/skills/careerforge/SKILL.md ✅ Native

✨ Features

  • 🔎 Multi-Platform Scraper: Queries LinkedIn, Indeed, Glassdoor, ZipRecruiter (python-jobspy) and the official German Bundesagentur für Arbeit REST API.
  • URL Text Extractor: Uses trafilatura to strip ads, headers, and navigation menus from any job URL.
  • 📄 Dual Typst Resume Generator:
    • resume_ats.pdf: Single-column 100% ATS parser friendly.
    • resume_design.pdf: Visual 2-column sidebar design with accent typography and candidate photo support.
  • 📝 Dual Cover Letter Generator:
    • cover_letter_design.pdf: Formatted cover letter matching CV visual typography.
    • cover_letter_ats.pdf: Simple unadorned cover letter for portal uploads.
  • 📁 Automated Submission Bundling (submission_bundle/): Packages your tailored CVs, Anschreiben, and master certificates from documents/ into a single drag-and-drop subfolder with clean filenames ready for portal uploads.
  • 📩 Recruiter Research & Cold Outreach (/outreach): Researches hiring managers or team leads on company pages and drafts 100-word personalized InMail messages.
  • 🎨 Authentic Tone & Photo Support: Reads your past real cover letters to mirror your personal voice, preferred greetings, and bullet structures.
  • 📊 ATS Match Scoring: Calculates Baseline Match % (before tailoring) and Tailored Potential % (~95%+).
  • 🎤 STAR Mock Interview Simulator: Interactive terminal interview prep with Situation-Task-Action-Result scoring.
  • 📋 Markdown Kanban Tracker: Live application status board (tracker.md).

🛠️ Quickstart & Environment Setup

1. Clone & Bootstrap Environment

git clone https://github.com/cerint/CareerForge.git
cd CareerForge

# Run cross-platform setup script
python scripts/setup_environment.py

2. First-Time Interactive Onboarding

Launch your AI agent (Claude Code, Gemini, Antigravity, Codex) and run:

/setup

During onboarding, you will be guided through 5 structured setup questions:

  1. Choose Resume Setup: Import your existing CV (preserves your custom fonts/colors/design) or select a built-in Typst template.
  2. Profile Photo Preference: Include candidate photo on visual design resume vs text-only.
  3. Import Cover Letter Tone: Paste past cover letters into templates/sample_cover_letters.md to train the agent on your voice.
  4. Language Preference: German, English, or Dual-Language setup.
  5. Set Search Preferences: Specify target job titles and regions.

⚡ Slash Command Reference

Command Action Example
/setup Run 5-question interactive onboarding protocol /setup
/score <url_or_filepath> Calculate Baseline & Tailored ATS Match Score /score https://linkedin.com/jobs/view/12345
/tailor <url_or_filepath> Tailor bullets, compile dual PDFs (ats + design), package submission_bundle/ & log in tracker /tailor https://boards.greenhouse.io/stripe/jobs/6789
/outreach <company_or_url> [name] Research hiring manager and generate 100-word cold InMail /outreach "Arsipa Herne" "Christian"
/search <query> <location> Run multi-source job scraper /search "Junior Data Analyst" "NRW, Germany"
/interview Start interactive STAR mock interview session /interview

📄 License

MIT License — 100% Free & Open Source.

About

Local, zero-cost, privacy-first AI job search engine & career co-pilot. Scrapes job boards, extracts URLs with Trafilatura, compiles dual ATS & modern design Typst resumes, bundles submission attachments, and runs STAR interview simulations.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages