First run
Workspace, AI provider, profile setup, and dependency health.
Choose a workspace
The app needs a local ai-job-search checkout. Onboarding detects a default path or lets you pick another folder. Settings → Workspace can change it later and reveal it in Finder.
Pick an AI provider
Open Settings → AI Providers. Connect Claude Code and/or Codex, set a default engine, and optionally override models. Details: AI Providers.
Complete profile setup
Use /setup to import a CV, point at a documents folder, or answer a short interview. You can re-run sections:
/setup --section skills/setup --section experience/setup --section search
Verify dependencies
Open Settings → Dependencies and click Re-check. Fix anything red before scraping or drafting — especially provider sign-in and LaTeX for PDFs.
Skip is allowed. You can skip setup and fill Profile later, but ranking and apply quality depend on a grounded profile.