# 10 — Vom eigenen Rechner arbeiten

🌍 [English](../../en/10-clone-and-tokens/readme.md) · [Türkçe](../../tr/10-clone-and-tokens/readme.md) · **Deutsch** · [Français](../../fr/10-clone-and-tokens/readme.md) · [Русский](../../ru/10-clone-and-tokens/readme.md)

Für Dokumente genügt der Browser. Für echte Arbeit — viele Dateien auf einmal oder das Ausführen des Codes — kopieren Sie das Repository auf Ihren Rechner.

## Eine Kopie holen

Klicken Sie auf der Repository-Seite auf **Klonen** und kopieren Sie die Adresse.

```bash
git clone https://forge.kabaforce.com/besitzer/projekt.git
cd projekt
```

## Der tägliche Ablauf

```bash
git pull              # holen, was andere geändert haben
# ... Dateien bearbeiten ...
git status            # was habe ich geändert?
git add .             # Änderungen vormerken
git commit -m "Einrichtungsnotizen hinzufügen"
git push              # an KabaForge senden
```

Wird `git push` abgelehnt, hat jemand anderes zuerst gepusht: `git pull` ausführen, gemeldete Konflikte lösen, dann erneut pushen.

## Anmelden auf der Kommandozeile

Ihr KabaForce-ID-Passwort funktioniert über HTTPS nicht. Erzeugen Sie stattdessen ein Token:

1. **Avatar → Einstellungen → Anwendungen → Neues Token erzeugen**.
2. Geben Sie ihm einen Namen und nur die Rechte, die Sie brauchen (`repo` genügt meist).
3. Kopieren Sie es einmal — es wird nie wieder angezeigt.
4. Wenn Git nach einem Passwort fragt, fügen Sie das Token ein.

So werden Sie nur einmal gefragt:

```bash
git config --global credential.helper store
```

## SSH statt Token

1. Erzeugen Sie einen Schlüssel, falls Sie keinen haben: `ssh-keygen -t ed25519`
2. Kopieren Sie `~/.ssh/id_ed25519.pub`.
3. **Avatar → Einstellungen → SSH-Schlüssel → Schlüssel hinzufügen**, einfügen.
4. Klonen Sie mit der SSH-Adresse unter **Klonen**.

Danach fragt nichts mehr nach einem Passwort.

## Nützliche Ergänzungen

| Bedarf | Befehl |
|--------|--------|
| Historie ansehen | `git log --oneline --graph` |
| Lokale Änderungen an einer Datei verwerfen | `git restore datei.md` |
| Branch wechseln | `git switch branch-name` |
| Branch anlegen | `git switch -c neuer-branch` |

## Automatisierung

Repositories lassen sich mit demselben Token auch über die KabaForge-API lesen und schreiben:

```bash
curl -H "Authorization: token IHR_TOKEN" \
  https://forge.kabaforce.com/api/v1/repos/besitzer/projekt/contents
```

Behandeln Sie Tokens wie Passwörter: niemals in eine Datei schreiben, die Sie committen.

---

⬅ [Zurück: 09 — Branches und Pull Requests](../09-branches-and-pull-requests/readme.md) · 📚 [Inhalt](../README.md)