Démarrage rapide
Démarrez avec career-ops en cinq minutes : installez le système open source de recherche d'emploi par IA, ouvrez votre CLI d'IA et évaluez votre première offre. Aucune connaissance en code requise.
Ce guide vous emmène de zéro à votre première offre évaluée en cinq minutes environ. Vous allez préparer l'espace de travail, ouvrir votre assistant de codage IA, le laisser vous embarquer au fil d'une conversation, puis coller une offre d'emploi — career-ops vous rend un rapport complet, un score et un CV PDF sur mesure.
Ce qu'il vous faut
Vous n'avez pas besoin de savoir coder. Il vous suffit d'être à l'aise pour ouvrir un terminal et lancer une commande.
Vous débutez avec le terminal ?
Si vous n'avez jamais utilisé de ligne de commande, ce n'est pas un problème — mais ce guide n'est pas le bon endroit pour l'apprendre. Pour vous mettre à niveau rapidement, lisez le manuel Command Line for Beginners de freeCodeCamp. Il couvre tout ce dont vous avez besoin pour suivre ce guide. Une fois à l'aise pour ouvrir un terminal et lancer une commande, revenez et reprenez à l'étape 1.
Assistant de codage IA
Installez Claude Code, Gemini CLI, Codex, Qwen Code, OpenCode ou GitHub Copilot CLI — l'assistant de codage IA qui fait tourner ce système. career-ops fonctionne avec tous. Connectez-vous avant de continuer.
Node.js 20 LTS ou ultérieur
Installez Node.js en version 20 LTS ou ultérieure — un runtime JavaScript utilisé pour générer les PDF et exécuter les scripts auxiliaires.
Étape 1 : préparer l'espace de travail
Ouvrez un terminal dans le dossier où vous voulez installer career-ops. La voie recommandée tient en une seule commande ; une voie avancée avec git clone se trouve juste en dessous. Si Node 20+ ou Git manquent, npx refusera de s'exécuter — installez-les d'abord (voir les prérequis ci-dessus).
Recommandé — une seule commande
npx @santifer/career-ops initCette commande clone la dernière release dans ./career-ops, installe les dépendances et met en place la structure de l'espace de travail. Elle détecte aussi quel CLI de codage IA vous avez installé et vous indique la bonne commande pour démarrer. La commande est idempotente — la relancer n'écrase jamais les fichiers que vous avez déjà.
Une fois terminé, placez-vous dans l'espace de travail :
cd career-opsAvancé — clonez le dépôt vous-même
Choisissez cette voie si vous voulez suivre une branche précise, contribuer au projet ou auditer le code avant d'installer les dépendances.
git clone https://github.com/santifer/career-ops.git
cd career-ops
npm installNavigateur headless (une seule fois)
career-ops utilise un Chromium headless pour plusieurs tâches : générer les PDF, vérifier si les annonces sont toujours en ligne et exécuter des scans ATS complets. L'installateur le configure automatiquement après les dépendances ; si cette étape a échoué sur votre machine, installez-le manuellement :
npx playwright install chromiumÉtape 2 : ouvrir votre assistant IA
Depuis l'intérieur du dossier career-ops, lancez le CLI de codage IA que vous avez installé.
claudegeminicodexqwenopencodecopilotL'agent se présentera de lui-même
La première fois que vous lancez votre CLI dans l'espace de travail, l'agent career-ops démarre une courte conversation d'onboarding. Il vous demande votre CV, les types de postes que vous visez, votre fourchette de rémunération et vos préférences de localisation. Rien ne s'édite à la main — vous répondez en langage naturel et l'agent écrit les fichiers de configuration pour vous. La session prend environ deux à trois minutes.
Une question sans rapport que vous pourriez voir
Certains CLI (Claude Code, par exemple) vous demandent si vous faites confiance aux fichiers d'un nouveau dossier la première fois que vous l'ouvrez. Cette question vient du CLI lui-même, pas de career-ops — répondez oui pour continuer. L'onboarding de career-ops démarre juste après.
Étape 3 : lancer votre première évaluation
Une fois l'onboarding terminé, vous êtes prêt à évaluer une vraie offre d'emploi. Copiez l'URL de n'importe quelle annonce et collez-la dans le chat. Avec Claude Code, préfixez-la avec la commande explicite ; avec les autres CLI, collez l'URL et demandez à l'agent de lancer l'auto-pipeline :
/career-ops auto-pipeline https://jobs.example.com/senior-engineer-aiRun the auto-pipeline command with the job URL: https://jobs.example.com/senior-engineer-aiRun the auto-pipeline command with the job URL: https://jobs.example.com/senior-engineer-aiRun the auto-pipeline command with the job URL: https://jobs.example.com/senior-engineer-aiRun the auto-pipeline command with the job URL: https://jobs.example.com/senior-engineer-aiRun the auto-pipeline command with the job URL: https://jobs.example.com/senior-engineer-aiSi vous n'avez pas d'URL, collez à la place le texte complet de la description du poste dans le chat. L'agent reconnaît l'un comme l'autre comme une offre d'emploi et exécute automatiquement le pipeline complet — c'est l'auto-pipeline.
Ce qui se passe ensuite
Une fois l'offre collée, career-ops fait tout ce qui suit de lui-même :
Lecture de la description du poste
Il comprend le poste, les exigences et la rémunération.
Lecture de votre CV
Il s'appuie sur cv.md pour repérer les correspondances et les lacunes par rapport au poste.
Notation de l'offre
Il note le poste de 0 à 5 sur plusieurs dimensions, comme l'adéquation au rôle, la rémunération et la politique de télétravail.
Rédaction d'un rapport
Il enregistre une analyse détaillée dans le dossier reports/.
Génération d'un CV PDF sur mesure
Il produit une version de votre CV adaptée à cette offre précise dans le dossier output/.
Ajout d'une ligne à votre tracker
Il consigne la candidature dans data/applications.md.
L'ensemble du processus prend environ une à deux minutes. À la fin, career-ops vous montre le score et un résumé du rapport.
Lire vos résultats
Ouvrez le fichier de rapport dans reports/. Le nom du fichier suit le motif {number}-{company}-{date}.md. À l'intérieur, vous trouverez :
- Score — un nombre de 0.0 à 5.0. En dessous de 4.0, l'offre n'est probablement pas très adaptée à votre profil.
- Bloc A — un résumé du poste en langage clair.
- Bloc B — un tableau montrant comment votre CV répond à chaque exigence du poste, ainsi que les lacunes éventuelles.
- Bloc C — une recommandation de stratégie pour vous positionner sur ce poste.
- Bloc D — une étude de rémunération comparant l'offre aux taux du marché.
- Bloc E — des notes de personnalisation pour votre candidature.
- Bloc F — une préparation à l'entretien avec des histoires STAR adaptées à cette offre.
- Bloc G — légitimité de l'annonce : une vérification que l'offre est réelle et n'est ni une arnaque ni un « ghost job ».
Votre CV PDF sur mesure se trouve dans le dossier output/. Relisez-le avant de l'envoyer où que ce soit — career-ops ne soumet jamais rien sans votre accord.
Et ensuite ?
Maintenant que votre première évaluation est terminée, voici quelques pistes à explorer :
- Affinez votre profil. Dites quelque chose de nouveau à l'agent sur vous — « Voici plus de contexte : je viens de livrer X. » Il met le profil à jour et les évaluations suivantes gagnent en précision.
- Évaluez d'autres offres. Collez d'autres URL ou descriptions. Chacune vient s'ajouter à votre tracker.
- Scannez les job boards. Tapez
/career-ops scanpour parcourir d'un coup des dizaines de pages carrières d'entreprises préconfigurées. - Comparez les offres. Si vous avez plusieurs rapports, tapez
/career-ops ofertaspour obtenir un comparatif classé.
Dépannage
Un bug ou une question ?
Si quelque chose ne fonctionne pas comme ce guide l'indique, merci de le signaler. Les rapports de bug aident tous ceux qui viendront après vous.
- Signaler un bug : ouvrez une issue sur le dépôt GitHub. Décrivez ce que vous attendiez, ce qui s'est réellement passé, et collez tout message d'erreur que vous avez vu.
- Poser une question : rejoignez la communauté Discord. C'est le moyen le plus rapide d'obtenir de l'aide auprès des autres utilisateurs et de l'auteur.
- Contribuer un correctif : si vous savez corriger le problème vous-même, lisez CONTRIBUTING.md avant d'ouvrir une pull request. En résumé : ouvrez d'abord une issue pour discuter du changement, puis soumettez votre PR.