Connecter un dépôt Git à Pyxaura

Ce guide couvre la connexion d'un dépôt de code (côté source de données). Pour l'utiliser
ensuite depuis votre éditeur via MCP, voir le
guide de configuration MCP.

Ce que fait le connecteur Git (et ce qu'il ne fait pas)

Contrairement aux autres connecteurs (upload, Drive, Notion...), le connecteur Git n'indexe pas
votre code comme des documents cherchables par similarité : une recherche par mot-clé ou par
similarité dans le code est déjà bien couverte par les outils existants (grep, recherche de
votre éditeur...) et n'apporte pas de valeur ajoutée ici. Pyxaura construit à la place une carte
structurelle du projet : quelles classes existent, ce qu'elles font, comment elles s'appellent
entre elles, où sont les points d'entrée. C'est ce contexte — plutôt qu'une recherche mot-clé dans
le code source — qui est exposé à votre assistant d'éditeur (voir le guide MCP).

Prérequis

Un plan Starter ou supérieur (le plan Free ne permet pas de connecter de dépôt Git — voir le guide sur les plans).
Un dépôt public, ou un dépôt privé avec un jeton d'accès en lecture seule (recommandé, quel que soit l'hébergeur).

Ajouter un dépôt

Connecteurs → Ajouter → Dépôt Git.
Renseignez l'URL HTTPS du dépôt et la branche à indexer.
Pour un dépôt privé : fournissez un jeton d'accès personnel (PAT) en lecture seule. Le jeton est stocké chiffré, jamais affiché en clair une fois enregistré.
Optionnel : des motifs d'inclusion/exclusion (include_globs/exclude_globs) pour restreindre l'indexation à certains dossiers, et le respect automatique de votre .gitignore.

Langages actuellement couverts

Ruby, JavaScript/TypeScript, Python, PHP, Kotlin, Swift, Dart, Go, Java, Rust et les vues
ERB/Rails sont analysés (classes, méthodes, héritage/implémentation, imports, et pour Ruby en
plus les appels de méthode et associations ActiveRecord ; pour ERB les relations de rendu entre
vues et partials). Les fichiers dans un autre langage (C#, C/C++, YAML de config...) sont ignorés
silencieusement à l'indexation — comptés comme "fichiers ignorés" pour rester transparent sur la
couverture réelle d'un dépôt polyglotte, plutôt que de laisser croire à tort qu'il est
intégralement couvert.

Synchronisation

Seuls les fichiers modifiés depuis le dernier passage (diff Git) sont retraités à chaque
synchronisation — un dépôt actif avec des commits fréquents reste donc à jour rapidement, sans
attendre une réindexation complète.

Sécurité

Le clonage se fait dans un répertoire temporaire isolé, purgé immédiatement après analyse ; le
code n'est jamais exécuté (analyse purement statique de la syntaxe). Les mêmes garde-fous que les
autres connecteurs à URL (protection contre les requêtes vers des adresses internes) s'appliquent
à l'URL du dépôt.

Étape suivante

Une fois le dépôt connecté, créez un jeton MCP dédié à ce dépôt pour le
rendre accessible depuis votre éditeur — voir le
guide de configuration MCP pour la suite.