Harness MaxxingDocumentation
📚 Toutes les pages

💬 Utiliser Harness Maxxing · 5 min de lecture

🌿Git & GitHub

Harness Maxxing affiche git sous forme d'images : les branches, les commits, ce qui n'a pas encore été poussé. Deux endroits :

  • Dans une conversation, pour tout le monde : quand Claude parle d'un dépôt, il ajoute un petit bloc git et l'application dessine le vrai graphe de ce dépôt, lu en direct sur le serveur (ou sur GitHub).
  • La page Git (barre latérale -> Git) : tous les dépôts du serveur et de votre compte GitHub, avec vos droits sur chacun ; cliquez sur l'un d'eux pour voir toutes ses branches et ses commits. Activez-la dans Paramètres -> Fonctionnalités.

Tout est en lecture seule : rien n'est jamais validé (commit), poussé ou modifié depuis ces vues.

Les graphes dans le chat

Demandez « où en est-on sur le dépôt acme ? », « qu'est-ce qui n'est pas encore poussé ? », « montre-moi les branches » : Claude répond avec un bloc comme celui-ci, dessiné sous forme de graphe (Telegram affiche le texte) :

```git
repo: /root/sites/acme
branches: main, feat-login
limit: 20
highlight: 3f2a9c1
```
Ligne Signification
repo: le dossier du clone sur le serveur (chemin absolu), ou github:owner/name pour un dépôt GitHub
branches: facultatif : uniquement ces branches (sinon toutes)
limit: facultatif : combien de commits (30 par défaut, 300 au maximum)
highlight: facultatif : les commits à mettre en évidence (ceux dont Claude parle)

Cliquez sur un commit pour voir son message complet, son auteur, sa date et les fichiers qu'il a modifiés (lignes +/-). Code affiche le texte du bloc ; Ouvrir dans Git ouvre la page complète (quand la page Git est activée).

Faites un clic droit sur une étiquette de branche ou sur un commit (appui long sur un téléphone), dans le chat ou sur la page Git : Ouvrir sur GitHub ouvre cette branche ou ce commit sur github.com dans un nouvel onglet, Copier le lien GitHub copie son adresse, et le dernier élément copie le nom de la branche ou le SHA du commit. Une branche ou un commit d'un clone s'ouvre une fois poussé vers origin sur GitHub (avant cela, l'élément indique « pas encore sur GitHub ») ; un graphe lu depuis GitHub ouvre tout.

Le dépôt doit se trouver dans la racine des fichiers (/root par défaut) : les mêmes dossiers que ceux affichés par la page Fichiers.

La page Git

Git dans la barre latérale (raccourci G puis B), une fois Page Git & GitHub activée dans Paramètres -> Fonctionnalités (désactivée par défaut ; les graphes dans les conversations fonctionnent dans les deux cas).

  • Sur ce serveur : chaque dépôt git trouvé sous la racine des fichiers, une seule fois (les dossiers comme node_modules sont ignorés), avec les commits pas encore poussés (↑) ou pas encore récupérés (↓), les fichiers modifiés, son dernier commit et son dépôt GitHub. Les branches n'y sont pas listées : elles se trouvent dans le graphe du dépôt (une carte ne nomme la branche active que lorsque ce n'est pas main/master, ou indique detached). Les dossiers de travail supplémentaires d'un clone (git worktree add, un dossier par branche) ne sont pas affichés comme des dépôts à part entière : le clone indique combien il en a (+3 worktrees).
  • GitHub : chaque dépôt de votre compte (les vôtres, ceux de vos organisations, ceux sur lesquels vous collaborez) avec votre droit dessus (admin, maintain, write, triage, read), privé ou public, et « cloné ici » quand le serveur en possède une copie.
  • Cliquez sur un dépôt : le graphe de ses branches et de ses commits (les 200 plus récents, Afficher plus pour aller jusqu'à 1 000), le détail d'un commit (dans une feuille qui monte du bas sur un téléphone ou une tablette), et, pour GitHub, les pull requests ouvertes. Un clone lié à GitHub dispose d'un bouton pour basculer entre la copie du serveur et GitHub (qui affiche toutes les branches, même celles qui n'ont pas été récupérées sur le serveur). Avec beaucoup de branches, les lignes du graphe se resserrent sur un écran étroit et les noms de branches longs se terminent par « … » (nom complet au survol).

Connecter GitHub

Les clones du serveur n'ont besoin de rien. Pour votre compte GitHub, ajoutez un jeton :

  1. Sur GitHub : Settings -> Developer settings -> Fine-grained tokens -> Generate new token (github.com/settings/personal-access-tokens). Accès aux dépôts : tous les dépôts ; autorisations : Contents, Metadata et Pull requests, en lecture seule.
  2. Dans Harness Maxxing : Paramètres -> Clés -> ajoutez-le, par exemple sous le nom GITHUB_TOKEN.

Tous les jetons GitHub du coffre-fort sont utilisés, quel que soit leur nom (GITHUB_TOKEN, GITHUB_PAT_BLOG...), ainsi que celui de la sauvegarde de la mémoire : ajoutez-en un par compte pour voir plusieurs comptes, ou des jetons limités à quelques dépôts. La page liste les comptes connectés en haut (cliquez sur l'un d'eux pour filtrer), fusionne leurs dépôts (chacun une seule fois, avec votre meilleur droit), indique quelles clés voient chaque dépôt, et signale une clé que GitHub refuse (expirée, révoquée) tout en continuant d'afficher les autres. Pour ouvrir un dépôt, le serveur utilise une clé qui y a accès. Les jetons restent sur le serveur : la page ne voit jamais que leurs noms.

Sécurité

La page ne fait que lire les dépôts : elle ne fait jamais de fetch, de pull ni de push. Un dépôt trouvé sur le serveur peut venir de n'importe où (une archive extraite, un clone fait par Claude) ; c'est pourquoi les réglages d'un dépôt qui feraient exécuter un programme à git pendant la lecture (moniteur de fichiers, vérification de signature, filtres clean, diff externe, hooks) sont désactivés, et un dépôt appartenant à un autre utilisateur système n'est pas ouvert (le contrôle de propriété propre à git). Quand la limite de requêtes de GitHub est atteinte, la page l'indique au lieu d'afficher des dépôts comme manquants.

💡 Bloqué ? Ouvrez une session dans le topic system › help et posez votre question avec vos mots : Claude lit cette doc sur votre serveur et vous répond.✏️ Améliorer cette page