career-ops

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.

Aktualisiert am

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.

Git

Installiere Git. Der Scaffolder nutzt es intern. Auf den meisten Computern ist es schon installiert. Zum Prüfen öffnest du ein Terminal und führst git --version aus.

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

Terminal
npx @santifer/career-ops init

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

Terminal
cd career-ops
Fü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.

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

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

Terminal
npx playwright install chromium

Schritt 2: KI-Assistenten öffnen

Starte im Ordner career-ops die KI-Coding-CLI, die du installiert hast.

Terminal
claude
Terminal
codex
Terminal
opencode
Terminal
qwen
Terminal
copilot
Terminal
agy

Der 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-ai
Run the auto-pipeline command with the job URL: https://jobs.example.com/senior-engineer-ai
Run the auto-pipeline command with the job URL: https://jobs.example.com/senior-engineer-ai
Run the auto-pipeline command with the job URL: https://jobs.example.com/senior-engineer-ai
Run the auto-pipeline command with the job URL: https://jobs.example.com/senior-engineer-ai
/career-ops https://jobs.example.com/senior-engineer-ai

Wenn 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 scan ein, um Dutzende vorkonfigurierte Karriereseiten von Unternehmen auf einmal zu durchsuchen.
  • Vergleiche Angebote. Wenn du mehrere Berichte hast, gib /career-ops ofertas ein 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.

Auf dieser Seite