Démarrage rapide

Ce guide vous emmène de zéro à votre première offre évaluée en une quinzaine de minutes la première fois. Vous allez préparer l'espace de travail, ouvrir votre assistant de codage IA et coller une offre d'emploi. L'agent termine l'onboarding s'il en faut un, puis 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.

É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 (22.13+, ou 23.4+ sous Node 23) 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 init

Cette 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. Elle n'installe que dans un nouveau dossier : si ./career-ops existe déjà et n'est pas vide, la commande s'arrête sur une erreur sans rien modifier ; la relancer ne répare donc ni ne met à jour un espace de travail existant.

Une fois terminé, placez-vous dans l'espace de travail :

cd career-ops

git clone https://github.com/career-ops-hq/career-ops.git
cd career-ops
npm install

Navigateur 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

npm install saute ce téléchargement lorsque PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD est définie dans votre environnement avec une valeur autre que vide, 0 ou false ; dans ce cas, lancez vous-même la commande ci-dessus. Sous NixOS, sautez cette étape : les navigateurs téléchargés ne peuvent pas y démarrer, et le dev shell du flake du dépôt en fournit à la place qui fonctionnent, comme l'explique le guide NixOS du dépôt principal.

Étape 2 : ouvrir votre assistant IA

Depuis l'intérieur du dossier career-ops, lancez le CLI de codage IA que vous avez installé.

claude

codex

opencode

qwen

copilot

agy

pi

Étape 3 : lancer votre première évaluation

Copiez l'URL de n'importe quelle annonce et collez-la dans le chat. Si votre profil n'est pas encore prêt, l'agent terminera d'abord l'onboarding. Avec Claude Code, Antigravity CLI ou Pi, 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-ai

Lancez la commande auto-pipeline avec l'URL de l'annonce : https://jobs.example.com/senior-engineer-ai

Lancez la commande auto-pipeline avec l'URL de l'annonce : https://jobs.example.com/senior-engineer-ai

Lancez la commande auto-pipeline avec l'URL de l'annonce : https://jobs.example.com/senior-engineer-ai

Lancez la commande auto-pipeline avec l'URL de l'annonce : https://jobs.example.com/senior-engineer-ai

/career-ops https://jobs.example.com/senior-engineer-ai

/skill:career-ops auto-pipeline https://jobs.example.com/senior-engineer-ai

Si 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 :

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

Le rapport inclut Score Evidence après Risk Summary. Cette section couvre cinq dimensions : adéquation du CV, alignement avec North Star, rémunération, signaux culturels et signaux d'alerte. Chaque ligne indique un état de preuve (supported, partial ou unknown), une source ou observation concrète et une question non résolue. La section se termine par un niveau de confiance dans les preuves (High, Medium ou Low), sa justification et jusqu'à trois priorités de vérification.

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 1 à 5. 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 heuristique de signaux comme le fait que l'offre soit toujours ouverte ou republiée à répétition. Il rapporte ce qu'il trouve et vous laisse juger.
• Bloc H — des brouillons de réponses pour le formulaire de candidature, rédigés uniquement lorsque le score atteint au moins 4.5.

Juste après le Bloc G, le Verdict donne la décision en gras (Apply, Consider, Research first ou Skip) et une raison tirée des blocs précédents, pour que vous connaissiez la réponse avant de lire le reste.

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 scan pour 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 ofertas pour 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 une nouvelle fonctionnalité, un nouveau mode ou une nouvelle commande, ou un changement d'architecture. Les corrections de bugs, les nouveaux providers du scanner qui n'exigent aucune authentification, la documentation et les traductions peuvent passer directement par une pull request.