Schnellstart
Starte in etwa fünfzehn Minuten mit career-ops: Installiere das Open-Source-KI-System für die Jobsuche, öffne deine KI-CLI und bewerte deine erste Stellenanzeige. Programmierkenntnisse brauchst du nicht.
Mit dieser Anleitung kommst du beim ersten Mal in etwa fünfzehn Minuten zu deiner ersten bewerteten Stelle. Du richtest den Workspace ein, öffnest deinen KI-Coding-Assistenten und fügst eine Stellenanzeige ein. Der Agent erledigt das nötige Onboarding und liefert dir dann einen vollständigen Bericht, eine Bewertung und einen maßgeschneiderten Lebenslauf als PDF.
Was du brauchst
Du musst nicht programmieren können. Du solltest nur ein Terminal öffnen und einen Befehl ausführen können.
Neu im Terminal?
Wenn du noch nie mit einer Kommandozeile gearbeitet hast, ist das kein Problem. Lernen kannst du es aber an anderer Stelle besser als in dieser Anleitung. Am schnellsten geht es mit dem englischsprachigen Handbuch Command Line for Beginners von freeCodeCamp. Es erklärt alles, was du für diese Anleitung brauchst. Sobald du ein Terminal öffnen und einen Befehl ausführen kannst, komm zurück und mach mit Schritt 1 weiter.
KI-Coding-Assistent
Installiere Claude Code, Codex, OpenCode, Qwen Code oder GitHub Copilot CLI. Das ist der KI-Coding-Assistent, der dieses System ausführt. career-ops unterstützt elf CLIs vollwertig. Installiere eine davon und melde dich an, bevor du weitermachst.
Node.js 22.13+
Installiere Node.js. Nötig ist Version 22.13 oder neuer (bei Node 23 23.4 oder neuer). Node.js führt die Hilfsskripte aus und erzeugt die PDFs. Ältere Versionen bestehen die Einrichtungsprüfung nicht, weil der SQLite-Index des Trackers ein neueres Node braucht. Deine Version prüfst du mit node --version.
Schritt 1: Workspace einrichten
Öffne ein Terminal in dem Ordner, in dem career-ops liegen soll. Der empfohlene Weg braucht nur einen Befehl. Darunter findest du einen Weg für Fortgeschrittene mit git clone. Wenn Node (22.13+, bei Node 23 ab 23.4) oder Git fehlen, startet npx nicht. Installiere dann zuerst beides (siehe Voraussetzungen oben).
Empfohlen: ein Befehl
npx @santifer/career-ops initDer Befehl klont das neueste Release nach ./career-ops, installiert die Abhängigkeiten und legt die Workspace-Struktur an. Außerdem erkennt er, welche KI-Coding-CLI du installiert hast, und zeigt dir den passenden Befehl zum Starten. Er installiert nur in einen neuen Ordner: Wenn ./career-ops schon existiert und nicht leer ist, bricht der Befehl mit einem Fehler ab und ändert nichts. Ein zweiter Aufruf repariert oder aktualisiert also keinen bestehenden Workspace.
Wechsle danach in den Workspace:
cd career-opsFür Fortgeschrittene: das Repository selbst klonen
Nimm diesen Weg, wenn du einem bestimmten Branch folgen, etwas zum Projekt beitragen oder den Code prüfen willst, bevor du die Abhängigkeiten installierst.
git clone https://github.com/career-ops-hq/career-ops.git
cd career-ops
npm installHeadless-Browser (einmalig)
career-ops braucht ein headless Chromium für mehrere Aufgaben: Es rendert PDFs, prüft, ob Stellenanzeigen noch online sind, und führt vollständige ATS-Scans aus. Der Installer richtet es nach den Abhängigkeiten automatisch ein. Falls dieser Schritt auf deinem Rechner fehlgeschlagen ist, installiere es von Hand:
npx playwright install chromiumnpm install überspringt diesen Download, wenn PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD in deiner Umgebung auf einen Wert gesetzt ist, der weder leer noch 0 noch false ist. Führe den Befehl oben dann selbst aus. Unter NixOS lässt du diesen Schritt weg: Die heruntergeladenen Browser starten dort nicht, und die Flake-Dev-Shell des Repositorys stellt stattdessen funktionierende bereit, wie die NixOS-Anleitung des Core-Repositorys erklärt.
Schritt 2: KI-Assistenten öffnen
Starte im Ordner career-ops die KI-Coding-CLI, die du installiert hast.
claudecodexopencodeqwencopilotagypiDas Onboarding beginnt, wenn dein Profil gebraucht wird
Vor deiner ersten Stellenbewertung oder einem anderen Ablauf, der dein Profil braucht, prüft der career-ops-Agent deine Einrichtung und führt bei Bedarf ein kurzes Onboarding-Gespräch mit dir. Du kannst ihn auch direkt bitten, das Onboarding zu starten. Er fragt nach deinem Lebenslauf, nach den Rollen, die du suchst, nach deiner Gehaltsspanne und nach deinen Wünschen zum Arbeitsort. Du antwortest in normaler Sprache, und der Agent schreibt die Konfigurationsdateien für dich. Das Ganze dauert etwa zwei bis drei Minuten. Wenn du nur den Workspace erkundest, Code ansiehst oder deine Einrichtung prüfst, startet das kein Onboarding und legt keine Profildateien an.
Für Entwickler: Die Einrichtungsprüfung läuft über node doctor.mjs --json und liest nur. Das Onboarding legt die fehlenden Personalisierungsdateien (modes/_profile.md, modes/_custom.md, modes/_brief.md und voice-dna.md) mit node doctor.mjs --json --init-templates aus ihren Vorlagen an und überschreibt nie eine Datei, die du schon hast.
Eine Abfrage, die nicht von career-ops kommt
Manche CLIs, zum Beispiel Claude Code, fragen beim ersten Öffnen eines neuen Ordners, ob du den Dateien darin vertraust. Diese Abfrage kommt von der CLI selbst, nicht von career-ops. Bestätige sie, um weiterzumachen. Damit startet das Onboarding von career-ops noch nicht.
Du zahlst für Claude Pro oder Max? Prüfe, worüber diese Sitzung abgerechnet wird
Führe node doctor.mjs im Ordner career-ops aus, bevor du deine erste Bewertung startest. Das Skript zeigt dir in einer Zeile, worüber abgerechnet wird.
Wenn in deiner Umgebung ANTHROPIC_API_KEY gesetzt ist, nutzt deine CLI diesen Key und rechnet pro Token ab, auch wenn du für Pro oder Max zahlst. Diese Rangfolge legt Claude Code fest, nicht career-ops. Der Doctor erkennt sie nur und weist dich darauf hin. Wenn du stattdessen dein Abo nutzen willst, entferne die Zeile export ANTHROPIC_API_KEY=... aus ~/.zshrc, ~/.bashrc, ~/.profile oder aus einer .env im Projekt. Starte dann dein Terminal neu und führe /login aus. Wenn du bewusst API-Guthaben nutzen wolltest, ist alles in Ordnung.
Die anderen CLIs legen jeweils selbst fest, ob sie das Abo oder einen Key verwenden. Das prüft career-ops nicht. Mehr dazu findest du in den FAQ.
Schritt 3: Erste Bewertung ausführen
Kopiere die URL einer beliebigen Stellenanzeige und füge sie in den Chat ein. Ist dein Profil noch nicht fertig, erledigt der Agent zuerst das Onboarding. Mit Claude Code, Antigravity CLI oder Pi setzt du den Befehl davor. Bei den anderen CLIs fügst du die URL ein und bittest den Agenten, die auto-pipeline auszuführen:
/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-ai/career-ops https://jobs.example.com/senior-engineer-ai/skill:career-ops auto-pipeline https://jobs.example.com/senior-engineer-aiWenn du keine URL hast, füge stattdessen den vollständigen Text der Stellenbeschreibung in den Chat ein. Der Agent erkennt in beiden Fällen eine Stellenanzeige und führt automatisch die komplette Pipeline aus. Das ist die auto-pipeline.
Was danach passiert
Sobald du die Stelle eingefügt hast, erledigt career-ops Folgendes selbstständig:
Liest die Stellenbeschreibung
Erfasst die Rolle, die Anforderungen und die Vergütung.
Liest deinen Lebenslauf
Gleicht cv.md mit der Rolle ab und findet Übereinstimmungen und Lücken.
Bewertet die Stelle
Bewertet die Rolle auf einer Skala von 1 bis 5 nach mehreren Dimensionen, zum Beispiel Passung zur Rolle, Vergütung und Remote-Regelung.
Schreibt einen Bericht
Speichert eine ausführliche Auswertung im Ordner reports/.
Erstellt einen maßgeschneiderten Lebenslauf als PDF
Legt im Ordner output/ eine Version deines Lebenslaufs ab, die auf genau diese Stelle zugeschnitten ist.
Trägt die Bewerbung in deinen Tracker ein
Fügt der Datei data/applications.md eine Zeile für die Bewerbung hinzu.
Das Ganze dauert etwa ein bis zwei Minuten. Danach zeigt dir career-ops die Bewertung und eine Zusammenfassung des Berichts.
Deine Ergebnisse lesen
Der Bericht enthält nach der Risk Summary den Abschnitt Score Evidence. Er deckt fünf Dimensionen ab: CV-Match, North-Star-Ausrichtung, Vergütung, kulturelle Signale und Red Flags. Jede Zeile hält einen Evidenzstatus fest (supported, partial oder unknown), eine konkrete Quelle oder Beobachtung und eine offene Frage. Der Abschnitt endet mit einer Stufe für das Vertrauen in die Evidenz (High, Medium oder Low), ihrer Begründung und bis zu drei Prüfprioritäten.
Öffne die Berichtsdatei in reports/. Der Dateiname folgt dem Muster {number}-{company}-{date}.md. Darin findest du:
- Score: eine Zahl von 1 bis 5. Alles unter 4,0 heißt, dass die Stelle wahrscheinlich nicht besonders gut passt.
- Block A: eine Zusammenfassung der Rolle in einfacher Sprache.
- Block B: eine Tabelle, die zeigt, wie gut dein Lebenslauf zu jeder Anforderung der Stelle passt und wo Lücken sind.
- Block C: eine Empfehlung, wie du dich für diese Rolle positionierst.
- Block D: eine Gehaltsrecherche, die das Angebot mit dem Marktniveau vergleicht.
- Block E: Hinweise, wie du deine Bewerbung persönlich zuschneidest.
- Block F: Vorbereitung auf das Vorstellungsgespräch mit STAR-Geschichten, die auf diese Stelle zugeschnitten sind.
- Block G: Seriosität der Anzeige. Eine heuristische Prüfung achtet auf Signale, etwa ob die Anzeige noch offen ist und ob sie immer wieder neu veröffentlicht wird. Der Block berichtet, was er findet, und überlässt das Urteil dir.
- Block H: Antwortentwürfe für das Bewerbungsformular. Sie werden nur geschrieben, wenn die Bewertung bei 4,5 oder höher liegt.
Direkt nach Block G nennt der Abschnitt Verdict die Entscheidung fett gedruckt (Apply, Consider, Research first oder Skip) und einen Grund, der sich auf die Blöcke darüber stützt. So kennst du die Antwort, bevor du den Rest liest.
Deinen maßgeschneiderten Lebenslauf als PDF findest du im Ordner output/. Sieh ihn dir an, bevor du ihn verschickst. career-ops schickt nie etwas ohne deine Zustimmung ab.
Wie es weitergeht
Deine erste Bewertung ist fertig. Das kannst du als Nächstes ausprobieren:
- Verfeinere dein Profil. Erzähl dem Agenten etwas Neues über dich, zum Beispiel: „Hier noch mehr Kontext: Ich habe gerade X veröffentlicht.“ Er aktualisiert dein Profil, und künftige Bewertungen werden genauer.
- Bewerte weitere Stellen. Füge weitere URLs oder Beschreibungen ein. Jede davon landet in deinem Tracker.
- Durchsuche Jobbörsen. Gib
/career-ops scanein, um Dutzende vorkonfigurierte Karriereseiten von Unternehmen auf einmal zu durchsuchen. - Vergleiche Angebote. Wenn du mehrere Berichte hast, gib
/career-ops ofertasein und du bekommst einen Vergleich mit Rangfolge.
Fehlerbehebung
Bug gefunden oder eine Frage?
Wenn etwas nicht so funktioniert, wie es in dieser Anleitung steht, melde es bitte. Bug-Reports helfen allen, die nach dir kommen.
- Bug melden: Eröffne ein Issue im GitHub-Repository. Beschreibe, was du erwartet hast und was tatsächlich passiert ist, und füge die Fehlermeldungen ein, die du gesehen hast.
- Frage stellen: Komm in die Discord-Community. Dort bekommst du am schnellsten Hilfe von anderen Nutzern und vom Autor.
- Fix beitragen: Wenn du das Problem selbst beheben kannst, lies CONTRIBUTING.md, bevor du einen Pull Request öffnest. Kurz gesagt: Für ein neues Feature, einen neuen Modus oder Befehl oder eine Änderung an der Architektur eröffnest du zuerst ein Issue. Bugfixes, neue Scanner-Provider ohne Authentifizierung, Dokumentation und Übersetzungen kannst du direkt als Pull Request einreichen.