# 10 — Travailler depuis votre ordinateur

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

Le navigateur suffit pour des documents. Pour le vrai travail — beaucoup de fichiers à la fois, ou exécuter le code — copiez le dépôt sur votre machine.

## Obtenir une copie

Cliquez sur le bouton **Cloner** de la page du dépôt et copiez l'adresse.

```bash
git clone https://forge.kabaforce.com/proprietaire/projet.git
cd projet
```

## La boucle quotidienne

```bash
git pull              # récupérer ce que les autres ont changé
# ... modifier les fichiers ...
git status            # qu'est-ce que j'ai changé ?
git add .             # préparer les modifications
git commit -m "ajouter les notes d'installation"
git push              # les envoyer à KabaForge
```

Si `git push` est refusé, c'est que quelqu'un a poussé avant vous : lancez `git pull`, résolvez ce qu'il signale, puis poussez de nouveau.

## S'authentifier en ligne de commande

Le mot de passe de votre KabaForce ID ne fonctionne pas en HTTPS. Créez plutôt un jeton :

1. **Avatar → Paramètres → Applications → Générer un nouveau jeton**.
2. Donnez-lui un nom et seulement les permissions nécessaires (`repo` suffit en général).
3. Copiez-le une fois — il ne sera plus jamais affiché.
4. Quand git demande un mot de passe, collez le jeton.

Pour ne le saisir qu'une seule fois :

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

## SSH plutôt que des jetons

1. Créez une clé si vous n'en avez pas : `ssh-keygen -t ed25519`
2. Copiez `~/.ssh/id_ed25519.pub`.
3. **Avatar → Paramètres → Clés SSH → Ajouter une clé**, collez-la.
4. Clonez avec l'adresse SSH affichée sous **Cloner**.

Plus aucune demande de mot de passe ensuite.

## Compléments utiles

| Besoin | Commande |
|--------|----------|
| Voir l'historique | `git log --oneline --graph` |
| Annuler les modifications locales d'un fichier | `git restore fichier.md` |
| Changer de branche | `git switch nom-de-branche` |
| Créer une branche | `git switch -c nouvelle-branche` |

## Automatisation

Les dépôts peuvent aussi être lus et écrits via l'API KabaForge avec le même jeton :

```bash
curl -H "Authorization: token VOTRE_JETON" \
  https://forge.kabaforce.com/api/v1/repos/proprietaire/projet/contents
```

Traitez les jetons comme des mots de passe : n'en mettez jamais un dans un fichier que vous commitez.

---

⬅ [Précédent: 09 — Branches et demandes de fusion](../09-branches-and-pull-requests/readme.md) · 📚 [Sommaire](../README.md)