Schnellstart
Starte in fünf 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 in etwa fünf Minuten zu deiner ersten bewerteten Stelle. Du richtest den Workspace ein und öffnest deinen KI-Coding-Assistenten. Er richtet dich im Gespräch ein. Danach fügst du eine Stellenanzeige ein, und career-ops liefert dir 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 zehn CLIs vollwertig. Installiere eine davon und melde dich an, bevor du weitermachst.
Node.js 18+ (22.5+ empfohlen)
Installiere Node.js. Mindestens Version 18 ist nötig (sie läuft, zeigt aber eine Warnung), 22.5+ wird empfohlen (sie aktiviert den SQLite-Index für den Tracker). Node.js führt die Hilfsskripte aus und erzeugt die PDFs. 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 (18+) 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 chromiumSchritt 2: KI-Assistenten öffnen
Starte im Ordner career-ops die KI-Coding-CLI, die du installiert hast.
claudecodexopencodeqwencopilotagyDer Agent stellt sich vor
Wenn du deine CLI zum ersten Mal im Workspace startest, führt der career-ops-Agent ein kurzes Onboarding-Gespräch mit dir. Er fragt nach deinem Lebenslauf, nach den Rollen, die du suchst, nach deiner Gehaltsspanne und nach deinen Wünschen zum Arbeitsort. Du bearbeitest nichts von Hand: Du antwortest in normaler Sprache, und der Agent schreibt die Konfigurationsdateien für dich. Das Ganze dauert etwa zwei bis drei Minuten.
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. Direkt danach beginnt das Onboarding von career-ops.
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
Sobald das Onboarding fertig ist, kannst du eine echte Stellenanzeige bewerten. Kopiere die URL einer beliebigen Stellenanzeige und füge sie in den Chat ein. Mit Claude Code oder Antigravity CLI 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-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
Ö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.
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: Eröffne zuerst ein Issue, um die Änderung zu besprechen, und reiche dann deinen PR ein.