Jules lokal einrichten (macOS) – von 0 bis bereit

Jules lokal einrichten (macOS) – Schritt für Schritt

Diese Anleitung bringt dich von „0“ zu: Jules funktioniert + Website läuft live im Browser, damit du Änderungen sofort sehen kannst.

Was du danach kannst

  • • Du öffnest 2 Terminals: eins lässt die Website laufen, eins ist zum Steuern (Git/Jules).
  • • Du gibst Jules Aufgaben im Web-Interface oder per CLI.
  • • Du holst Jules’ Änderungen mit einer Session-ID in dein lokales Projekt → Browser aktualisiert sich.
  • • Du speicherst die Änderungen mit Git wieder nach GitHub.

Wichtig (damit du’s richtig erwartest)

Jules „läuft“ nicht als Programm, das deinen Mac steuert wie Photoshop. Jules arbeitet remote (Cloud) und liefert dir am Ende einen Patch / Änderungen.

Live im Browser bekommst du, indem du deine Website lokal startest (z.B. npm start). Dann wendest du Jules-Änderungen an – und siehst die Änderung sofort.

Deine Projekt-Daten

Hier eintragen → weiter unten werden die Copy-&-Paste Befehle automatisch passend gebaut.

Das wird nur für den Clone-Link benutzt.

~/

Beispiel: Wenn hier arseni steht, ist dein Projektordner ~/arseni.

Manche Projekte haben z.B. frontend/ oder web/. Wenn nicht: leer lassen.

Sehr wichtig: In Listen steht oft nur 14055…. Das ist zu kurz. Nimm die vollständige Zahl aus der URL im Jules Web: /session/DEINE_ZAHL/…

0) Wo gebe ich das ein?

Alles passiert im Terminal (Apple Tool). So findest du es:
Cmd + Space → „Terminal“ tippen → Enter.

Warum 2 Terminals?

Wenn du deine Website startest (z.B. npm start), läuft das dauerhaft und blockiert dieses Terminal. Deshalb:

  • • Terminal 1: Website läuft live (bleibt offen).
  • • Terminal 2: Git/Jules-Befehle (ziehen, committen, pushen).

1) Homebrew installieren (App-Store für Entwickler-Tools)

Homebrew ist der einfachste Weg, Tools wie Node zu installieren. Wenn du Homebrew schon hast: du kannst diesen Schritt überspringen.

Terminal – erst prüfen, ob Brew schon da ist
Wenn Brew fehlt: installieren
Wenn danach „brew: command not found“ kommt

Manchmal ist Brew installiert, aber dein Terminal kennt den Pfad noch nicht. Das hier macht Brew für das aktuelle Terminal sofort verfügbar:

2) Git sicherstellen (damit du Repos klonen kannst)

Git brauchst du, um den Code von GitHub auf deinen Mac zu holen. Auf macOS kommt Git meist über „Xcode Command Line Tools“.

Terminal – prüfen
Wenn Git fehlt

Dann installierst du die Command Line Tools. macOS zeigt dir ein Fenster – einfach bestätigen.

3) Node & npm sauber installieren (empfohlen: Node LTS)

Jules wird über npm installiert. npm kommt mit Node.js.

Wichtig für Laien: Viele Web-Projekte laufen stabiler mit einer LTS-Version (Long Term Support). Deshalb nutzen wir nvm (Node Version Manager). Damit kannst du jederzeit die Node-Version wechseln.

A) nvm installieren (über Homebrew)
B) nvm im Terminal „aktivieren“

Das macht nvm bei jedem neuen Terminal automatisch verfügbar. (Du machst das einmal, danach ist Ruhe.)

Danach: Terminal einmal schließen und neu öffnen (damit die Änderung aktiv ist).

C) Node LTS installieren und benutzen

4) Jules installieren & einloggen

Jetzt installierst du Jules einmal global. Danach kannst du überall jules … tippen.

Das Login öffnet normalerweise automatisch deinen Browser. Wenn nicht: Jules zeigt dir einen Link an – den einfach öffnen.

Terminal – Jules installieren + Login
Kurzer Test

Wenn das klappt, siehst du eine Versionsnummer und ggf. deine verbundenen Repos.

5) Repo auf den Mac holen (klonen)

Damit du live testen kannst, muss der Code lokal auf deinem Mac liegen. Danach ist dein Projekt unter ~/ORDNER.

Terminal – klonen + in den Ordner wechseln
Wenn du unsicher bist, ob du im richtigen Ordner bist: pwd zeigt dir den aktuellen Pfad.

6) Website lokal starten (damit du Änderungen live siehst)

Ab hier nutzt du idealerweise 2 Terminals:
Terminal 1 lässt die Website laufen, Terminal 2 ist für Jules/Git.

Terminal 1: Installation + Start

Der erste Start dauert oft länger, weil viele Pakete installiert werden. Wenn du ERESOLVE siehst, nutzen wir --legacy-peer-deps (kommt bei älteren Projekten vor).

Wenn es läuft, steht meistens sowas da:
Local: http://localhost:3000
Dann Browser öffnen: http://localhost:3000

Falls npm start nicht existiert

Manche Projekte heißen anders (z.B. npm run dev). So findest du heraus, was es gibt:

7) Jules-Änderungen reinziehen (und live sehen)

Jetzt kommt der „magische“ Teil: Du wendest Jules’ Ergebnis lokal an – während die Website im anderen Terminal läuft.

Danach: Browser kurz refreshen oder kurz warten (oft aktualisiert es automatisch).

Terminal 2: Patch anwenden

Wenn du hier einen 404 bekommst, ist es fast immer eine abgeschnittene Session-ID. Nimm die volle Zahl aus der Jules-URL.

8) Wenn alles passt: Änderungen nach GitHub speichern

Wenn du die Änderung im Browser siehst und alles okay ist, speicherst du es mit Git:
(1) Dateien vormerken → (2) Commit machen → (3) Push nach GitHub.

Terminal 2: Commit & Push

Tipp: Die Commit-Nachricht in den Anführungszeichen kannst du immer anpassen.

Troubleshooting (häufige Probleme, einfache Lösungen)

„Ich kann im Terminal nichts mehr eingeben“

Wenn npm start läuft, blockiert das Terminal absichtlich. Lösung: zweites Terminal öffnen oder im gleichen Terminal mit Ctrl + C stoppen.

„npm error ERESOLVE“ (Dependency Konflikt)

Lösung: einmalig npm install --legacy-peer-deps benutzen. (Das macht nichts „kaputt“, es ist bei älteren Projekten normal.)

„jules remote pull … 404 NOT_FOUND“

In 90% der Fälle ist die Session-ID zu kurz (aus einer Liste mit „…“). Nimm die vollständige Zahl aus der Jules Web URL.

Notfall: alles zurücksetzen (nur wenn du noch NICHT committed hast)