CareerForge is a professional-grade desktop command center designed to supercharge your job search. It uses advanced AI to transform your professional "Source of Truth" (a master profile) and a target Job Description into a perfectly tailored application kit.

Current Version: 1.0.19

• The Writer (gemini-2.5-pro): Handles heavy cognitive tasks like layout design, strategy narratives, and resume drafting with a massive thinking budget.
• The Judge (gemini-2.5-pro): A specialized "Surgical Refinement" agent that audits the generated resume HTML to fix formatting, ensure strict one-page fit, and scrub artifacts.
• The Assistant (gemini-2.5-flash): Powers fast tasks like job parsing, company intel retrieval, and profile generation.

• Master Profile Wizard: Don't have a master resume? The built-in 5-step wizard interviews you and generates a perfectly structured Markdown profile to use as your "Source of Truth".
• Smart Clipboard Auto-Fill: One click analyzes the text in your clipboard to instantly populate the Job Title, Company, and Description fields. No more manual copy-pasting.
• Usage & Cost Tracker: Monitor your token consumption and estimated API costs in real-time via the built-in dashboard.

• Modular Generation: Choose exactly what you need. Only want a CV? Uncheck the rest. Need the full suite? Generate Cover Letter, Strategy, Interview Prep, and Outreach emails.
• Company Recon Dossier: Generates a dedicated intel cheat sheet with company values, recent initiatives, and insider talking points to help you ace the interview.
• Resume Skins: Instantly transform the look of your resume with professional themes (Modern Blue, Executive Serif, Tech Minimalist) without regenerating content.
• WYSIWYG "Direct Edit": Toggle "Edit Mode" to click and type directly on the resume preview. No code required.
• Native PDF Export: Generate clean, print-ready PDFs for your Resume and Cover Letter.

• Interactive Pipeline: Manage your applications from "Applied" to "Offer". Visual timeline allows you to mark stages as current or add custom steps (e.g., "Home Assignment").
• After-the-Fact Generation: Did you only generate a Resume initially? Go to your History, open the application, and click "Generate Cover Letter" (or Intel, or Strategy) to create missing assets using the original context.
• Persistent Data: Your profile, API key, and application history are stored securely in your operating system's standard application data folder (%APPDATA%), ensuring they survive updates.

• Node.js: (Version 16 or higher recommended)
• Google Gemini API Key: You can get a free API key from Google AI Studio.

1. Clone the repository

   git clone https://github.com/yourusername/careerforge.git
   cd careerforge

2. Install Dependencies

   npm install

3. Run in Development

   npm run app

4. Package for Distribution (Windows) To create a distributable .exe installer:

   npm run dist

   The installer will be located in the release/ folder.

Upon first launch, enter your Gemini API Key.

• Check "Remember Key" to save it locally.

Your "Source of Truth" is a .md or .txt file containing your entire professional history.

• Upload: Drag and drop your existing file.
• Create: Click "Don't have a profile?" to launch the Profile Wizard and generate one from scratch.
• Persist: Check "Remember this profile" to save it to disk.

1. Inputs: Copy a job post and click "Auto-Fill from Clipboard".
2. Modular Options: Check the boxes for the assets you want (Resume is mandatory).
3. Generate: Click "Generate Assets". The cinematic progress bar will track the drafting and refinement phases.

• Skins: Use the dropdown in the Resume tab to change the visual style.
• Edit Mode: Toggle this to fix typos or rephrase content directly on the page.
• Download: Export your documents to PDF.

1. Save: Click "Application Sent" to save the kit to the Applications tab.
2. History: Navigate to the "Applications" tab to view your timeline.
3. Generate Missing: If you skipped the Cover Letter or Intel Dossier earlier, you can click the "Generate" button inside the history card to create it now.

The app stores all user data in %APPDATA%\CareerForge (Windows) to ensure persistence across updates.

• user_data/profile.md: Your master profile.
• user_data/config.json: Encrypted-like storage for API key.
• user_data/Kits/applications.json: The database of all your applications and their current status.
• user_data/usage.json: Log of API token usage.

• Developer Tools: Press F12 at any time to open the console and view internal logs, API request status, and state changes.

Built with React, Electron, TailwindCSS, and Google Gemini.