Aide de Ramille

Installer Ramille

Ramille fonctionne sur macOS 12 ou plus récent. C’est une seule app, universelle, pour les Mac Intel et Apple Silicon.

Ramille utilise le Git installé sur votre Mac, en version 2.38 ou plus récente. S’il manque ou s’il est trop ancien, Ramille vous le dit au démarrage. Vous pouvez installer les outils Apple avec xcode-select --install, ou Git avec brew install git.

Première installation

1. Ouvrez le fichier Ramille.dmg téléchargé.
2. Glissez Ramille dans le dossier Applications.
3. Lancez Ramille depuis Applications. L’app est signée et notarisée par Apple.

Ouvrir un premier dépôt

L’accueil affiche vos favoris et vos dépôts récents. Depuis cet écran :

• ⌘O ouvre un dépôt déjà présent sur votre Mac ;
• « Cloner un dépôt… » demande l’adresse du dépôt (HTTPS ou SSH, sans mot de passe ni jeton), le dossier parent et le nom du dossier ;
• « Initialiser un dépôt… » en crée un nouveau.

Chaque dépôt a quatre écrans : Historique, Modifications, Synchro et Pull requests. ⌘K ouvre la palette, qui donne accès à toutes les commandes.

Mises à jour

Ramille se met à jour avec Sparkle. Une fois par jour, il vérifie s’il existe une nouvelle version. S’il en trouve une, il affiche ses notes de version et n’installe la mise à jour qu’après votre clic. Chaque mise à jour est signée, et Sparkle vérifie la signature avant l’installation.

Pour vérifier tout de suite : menu Ramille › « Rechercher des mises à jour… », aussi dans la palette (⌘K).

Dans Réglages › Mises à jour, vous pouvez couper la vérification quotidienne, voir la version installée et lancer une vérification. Les notes de chaque version sont sur la page Nouveautés.

Connecter GitHub

Ramille lit et écrit chez GitHub par sa propre application GitHub. Vous n’avez pas de jeton à créer.

1. Ouvrez Réglages › Comptes (aussi depuis la palette, ou « Connecter un hébergeur pour voir les PR… » sur l’accueil).
2. Cliquez sur « Se connecter à GitHub… ». Ramille affiche un code et ouvre github.com/login/device dans votre navigateur.
3. Saisissez le code (le bouton « Copier le code » aide), puis autorisez l’application.
4. Installez l’application sur les comptes et organisations dont vous voulez voir les dépôts. Ramille propose « Installer l’App GitHub » et « Gérer les installations GitHub ».
5. De retour dans Ramille, « Tester la connexion » doit afficher votre identifiant GitHub.

Permissions demandées

Quand les permissions de l’application changent, GitHub demande à chaque compte ou organisation où elle est installée de les accepter. D’ici là, GitHub refuse l’écriture (erreur 403). Pour votre compte, allez sur github.com/settings/installations, ouvrez l’application, puis « Review request » et « Accept ». Pour une organisation, même démarche depuis ses réglages › GitHub Apps.

Si GitHub indique que l’application n’est pas installée sur un compte ou une organisation, installez-la depuis sa page GitHub, puis actualisez. Si GitHub refuse le jeton, reconnectez-vous dans Réglages › Comptes.

GitHub Enterprise Server fonctionne avec un jeton personnel doté des portées repo et read:org. Ramille affiche alors les pull requests en lecture seule.

Connecter GitLab

Pour gitlab.com ou votre propre serveur GitLab, Ramille utilise un jeton d’accès personnel.

1. Dans Réglages › Comptes › GitLab, cliquez sur « Créer un jeton GitLab… ».
2. Donnez au jeton les portées api et read_user, avec une expiration courte.
3. Collez le jeton dans Ramille, puis enregistrez et testez.

Avec GitLab, Ramille peut créer des merge requests. Pour les lire et les relire, Ramille les ouvre dans votre navigateur. Les opérations Git (fetch, pull, push) fonctionnent comme avec les autres hébergeurs.

Connecter Azure DevOps

La voie principale est un jeton personnel (PAT), créé pour votre organisation.

1. Dans Réglages › Comptes › Azure DevOps, saisissez le nom de votre organisation.
2. Cliquez sur « Utiliser un jeton personnel (PAT) », puis ouvrez la page des jetons sur dev.azure.com et choisissez « New Token ».
3. Choisissez votre organisation et cochez les portées ci-dessous. Gardez une expiration courte.
4. Copiez le jeton : Azure DevOps ne l’affiche qu’une fois.
5. Collez-le dans Ramille, puis « Enregistrer et tester ».

« Code : Read » suffit pour lire sans commenter ni voter. À l’expiration du jeton, créez-en un nouveau et utilisez « Remplacer le jeton… ».

Si Azure DevOps refuse une écriture (403), le jeton n’a pas « Code : Read & write ». S’il refuse le jeton (401), celui-ci a expiré, a été révoqué ou a été créé pour une autre organisation. Votre compte doit aussi avoir le droit de contribuer aux pull requests du dépôt. Ramille ne contourne jamais une stratégie de branche.

« Se connecter avec Microsoft Entra… » ne sert que si votre organisation est rattachée à un annuaire Microsoft Entra (entreprise, école). Microsoft refuse les comptes personnels (outlook.com, hotmail.com) : utilisez alors un jeton personnel.

Azure DevOps Server (sur site) fonctionne avec un PAT « Code : Read & write ». Ramille affiche alors les pull requests en lecture seule.

Connecter Bitbucket

Avec Bitbucket, Ramille affiche les pull requests, leurs modifications, les discussions et l’état de la CI. Commenter, donner un avis ou fusionner depuis Ramille n’est pas encore possible : ouvrez la pull request dans votre navigateur.

Bitbucket Cloud (bitbucket.org)

1. Réglages › Comptes › Bitbucket Cloud › « Ouvrir la page des API tokens Atlassian… ».
2. Choisissez « Create API token with scopes », application Bitbucket. Un jeton sans portées est refusé.
3. Cochez read:user:bitbucket, read:pullrequest:bitbucket et read:repository:bitbucket. Pour créer des pull requests, ajoutez write:repository:bitbucket et read:permission:bitbucket. Gardez une expiration courte.
4. Dans Ramille, saisissez l’adresse e-mail de votre compte Atlassian (pas votre nom d’utilisateur Bitbucket) et le jeton, puis « Enregistrer et tester ».

Bitbucket Data Center

1. Réglages › Comptes › Bitbucket Data Center : saisissez l’adresse web du serveur telle que votre navigateur l’affiche, chemin compris (par exemple https://git.exemple.fr/bitbucket). Si vos adresses SSH n’utilisent pas le même hôte sur le port 7999, remplissez le champ des hôtes SSH. Puis « Ajouter le serveur ».
2. Cliquez sur « Vérifier ». Ramille demande Bitbucket Data Center 8.19 ou plus récent.
3. Dans Bitbucket : votre avatar › Gérer le compte › Jetons d’accès HTTP › Créer un jeton, avec la permission Lecture sur les projets et les dépôts.
4. Dans Ramille, saisissez votre nom d’utilisateur Bitbucket et le jeton, puis « Enregistrer et tester ».

Réseau d’entreprise

Ramille utilise le proxy réglé dans Git (git config --global http.proxy http://proxy:port). Un proxy défini seulement dans votre shell n’est pas vu quand Ramille est lancé depuis le Finder. Si le certificat d’un serveur est refusé, ouvrez son adresse dans Safari ; si Safari affiche un avertissement, demandez à votre service informatique le certificat de l’autorité interne et ajoutez-le au trousseau Système.

Plusieurs comptes par hébergeur

Vous pouvez connecter plusieurs comptes chez un même hébergeur, par exemple un compte GitHub personnel et un compte professionnel. Dans Réglages › Comptes, utilisez « Ajouter un compte … ».

Pour chaque dépôt, Ramille choisit le compte dans cet ordre :

1. le compte que vous avez choisi pour ce dépôt ;
2. sinon, le compte qui a accès au propriétaire ou à l’organisation de l’adresse du remote ;
3. sinon, le compte par défaut de l’hébergeur.

Pour choisir à la main, cliquez sur « en tant que … » dans l’écran d’une pull request, puis choisissez un compte pour ce dépôt.

Si vos remotes utilisent un alias de ~/.ssh/config (par exemple git@github-pro:organisation/depot.git), Ramille demande à ssh le vrai nom d’hôte, sans se connecter, pour reconnaître l’hébergeur et choisir le bon compte. Il applique aussi vos règles Git insteadOf et pushInsteadOf. Il les lit sans jamais les modifier.

SSH

Ramille lance le ssh du système : votre ~/.ssh/config, votre agent SSH et core.sshCommand s’appliquent comme dans le Terminal. Les agents réglés par IdentityAgent, comme 1Password ou Secretive, fonctionnent aussi.

Phrase de passe

Si votre clé a une phrase de passe, Ramille vous la demande dans sa propre fenêtre et ne la conserve pas. Cochez « Ajouter à l’agent SSH » pour que macOS la range dans votre Trousseau et ne vous la redemande plus.

Empreinte d’hôte

À la première connexion à un serveur, Ramille affiche l’empreinte SHA256 de sa clé d’hôte et vous demande si vous lui faites confiance. Si vous acceptez, la clé est ajoutée à ~/.ssh/known_hosts, comme le ferait ssh.

• Pour github.com, gitlab.com, bitbucket.org et ssh.dev.azure.com, Ramille compare l’empreinte avec les valeurs publiées par ces hébergeurs. Si elle ne correspond pas, Ramille refuse la connexion.
• Pour votre propre serveur, vérifiez l’empreinte auprès de son administrateur avant de lui faire confiance.
• Si une clé d’hôte déjà acceptée a changé, Ramille refuse toujours et affiche la commande ssh-keygen -R, à lancer une fois la nouvelle clé vérifiée.

Ramille ne désactive jamais la vérification des clés d’hôte, même si votre configuration SSH indique StrictHostKeyChecking no.

Trousseau macOS

Ramille garde les jetons de vos comptes et vos clés d’IA dans le Trousseau macOS, un élément par compte. Il n’affiche jamais un jeton. Pour les remotes HTTPS, il utilise aussi les assistants d’identifiants Git que vous avez déjà.

macOS peut demander l’accès à un élément de Ramille avec le mot de passe du trousseau « session ». Causes habituelles : l’élément a été créé par une autre copie de l’app, l’accès a été donné une fois (« Autoriser ») et non pour toujours (« Toujours autoriser »), ou le trousseau n’a plus le même mot de passe que votre session.

Quand le Trousseau refuse l’accès, le compte passe « À vérifier » dans Réglages › Comptes, avec deux boutons :

• « Autoriser l’accès… » : macOS affiche sa demande. Saisissez votre mot de passe de session et choisissez « Toujours autoriser ».
• « Reconnecter » (GitHub, Microsoft Entra) ou « Remplacer le jeton… » (jetons personnels) : le nouveau jeton remplace l’ancien.

Si macOS refuse votre mot de passe de session, ouvrez Trousseaux d’accès. Si vous connaissez l’ancien mot de passe, utilisez Édition › « Modifier le mot de passe du trousseau "session" ». Sinon, Trousseaux d’accès › Réglages › « Réinitialiser mon trousseau par défaut », fermez puis rouvrez votre session, et reconnectez vos comptes dans Ramille.

Essai et licence

Vous pouvez essayer Ramille gratuitement pendant 14 jours d’utilisation, sans carte bancaire. Seuls les jours où vous ouvrez l’app comptent. Après l’essai, votre historique, vos diffs et vos pull requests restent consultables. Une licence est nécessaire pour modifier vos dépôts.

La licence s’achète une fois, 49 € HT. Elle comprend :

• toutes les versions 1.x, avec toutes leurs mises à jour ;
• toute version majeure publiée dans les 12 mois suivant votre achat, avec toutes ses mises à jour ;
• l’utilisation sur 3 Mac au plus.

Polar vend les licences pour notre compte, en tant que marchand de référence : il s’occupe du paiement, de la facture et de la TVA de votre pays. Après l’achat, vous recevez votre clé de licence par e-mail et la saisissez dans Ramille. Pour toute question sur un achat, écrivez-nous. Les conditions complètes figurent dans les conditions de vente et contrat de licence.

Raccourcis clavier

⌘/ affiche les raccourcis de l’écran en cours, avec une recherche. ⌘K ouvre la palette.

Dans un champ de texte, ⌘Z et ⇧⌘Z annulent et rétablissent la saisie. Hors d’un champ, ils annulent et rétablissent la dernière action Git. Sur un clavier AZERTY, ⌘/ se tape avec ⇧ sur la touche « : ».

Confidentialité en bref

• Vos dépôts ne passent par aucun serveur de Ramille. L’app parle directement à vos hébergeurs Git.
• Aucune mesure d’audience ni aucun rapport de plantage n’est envoyé. Le journal d’utilisation reste sur votre Mac.
• Les jetons et les clés d’IA sont gardés dans le Trousseau macOS.
• Les fonctions d’IA sont facultatives. Rien ne part avant que vous ayez vu un aperçu et cliqué pour envoyer. Vous pouvez utiliser un modèle local (Ollama, LM Studio) au lieu d’un fournisseur distant.
• La vérification quotidienne des mises à jour télécharge un fichier chez GitHub, sans compte ni donnée de vos dépôts.

Le détail figure dans la politique de confidentialité.

Signaler un problème

Ramille tient un journal d’utilisation sur votre Mac. Rien n’est envoyé automatiquement.

1. Reproduisez le problème.
2. Choisissez Aide › « Envoyer un rapport… » (aussi dans Réglages › Mises à jour et dans la palette).
3. Ramille ouvre un brouillon dans Mail avec le rapport en pièce jointe. Sans Mail, copiez le rapport ou affichez le fichier dans le Finder.
4. Relisez le rapport, décrivez ce que vous avez fait, ce que vous attendiez et l’heure approximative du problème, puis envoyez-le à ramille@glabs325.com.

Le journal garde des données techniques : commandes lancées, écrans affichés, actions Git avec leur durée et leur résultat, erreurs. Il ne garde jamais le contenu de vos fichiers, les diffs, les messages de commit ni les arguments Git. Les jetons et les adresses e-mail sont masqués, et les chemins de votre dossier personnel deviennent ~/…. Dans Réglages › Mises à jour, vous pouvez désactiver le journal, ouvrir son dossier ou l’effacer.