Guide Cloud

Cloud exécute les tâches à distance. Lancez une tâche en sélectionnant un dépôt ou transférez une tâche locale existante vers le cloud, puis suivez le travail depuis un client disponible compatible avec Cloud.

Ce guide utilise principalement l’application de bureau. Il inclut aussi les commandes CLI pour transférer une tâche locale vers Cloud et vérifier l’état du transfert.

flowchart TD
    A["Vérifier le compte et l’accès au dépôt"] --> B{"Où commencerez-vous ?"}
    B --> C["Sélectionner un dépôt et lancer une tâche Cloud"]
    B --> D["Ouvrir une tâche locale existante"]
    D --> E["Examiner la conversation et les modifications non commitées à transférer"]
    C --> F["Cloud prépare et exécute la tâche"]
    E --> F
    F --> G["Suivre l’avancement, ajouter du contexte et examiner les résultats"]
    G --> H["Affiner le travail ou le livrer via une PR"]

1. Avant de commencer

1.1 Compte et clients

Les exemples de ce guide utilisent des dépôts GitHub. Pour l’installation et la connexion, consultez le guide de l’application de bureau.

1.2 Choisir comment commencer

2. Connecter votre dépôt et vérifier les prérequis

2.1 Connecter GitHub

1. Ouvrez le sélecteur de projet dans l’application de bureau et repérez Cloud.
2. Si Cloud est indisponible, cliquez sur le bouton de paramètres à côté pour ouvrir la page de connexion GitHub.
3. Suivez les instructions de la page pour autoriser GitHub.
4. Revenez au sélecteur de projet, ouvrez Cloud et vérifiez que le dépôt cible est présent.

Utilisez Rechercher des dépôts pour trouver un dépôt. S’il manque, vérifiez le compte GitHub connecté et les dépôts auxquels il est autorisé à accéder.

2.2 Vérifier le dépôt et la branche

Lorsque vous sélectionnez un dépôt, Remy commence sur sa branche par défaut. Pour en utiliser une autre, ouvrez le sélecteur de branche et choisissez la branche de départ de la tâche.

2.3 Comment Cloud prépare l’environnement

Après l’envoi d’une tâche, Cloud prépare l’espace de travail, récupère le code du dépôt et démarre l’exécution selon les besoins. Ce processus ne vous demande pas de créer un environnement cloud nommé séparément.

Ne supposez pas que les dépendances installées sur votre ordinateur, les serveurs de développement locaux et les identifiants locaux existent dans Cloud. Si la tâche nécessite des dépendances particulières, expliquez comment les préparer et les vérifier dans la documentation du projet ou la description de la tâche.

Lis d’abord le README du dépôt et les instructions du projet.
Confirme comment installer les dépendances, exécuter le projet et lancer ses tests.
Si l’environnement manque d’un élément requis, identifie-le et inclus l’erreur correspondante.
Exécute les vérifications possibles et énumère séparément celles que tu ne peux pas exécuter.

3. Démarrer une tâche directement dans Cloud

3.1 Sélectionner un dépôt et envoyer la tâche

1. Démarrez une nouvelle conversation et ouvrez Cloud dans le sélecteur de projet.
2. Trouvez et sélectionnez le dépôt cible, puis vérifiez la branche.
3. Confirmez que le paramètre d’exécution affiche Envoyer dans le cloud.
4. Choisissez un modèle disponible, décrivez la tâche et envoyez-la.
5. Attendez l’initialisation et l’exécution, puis examinez l’avancement et les résultats.

Pour examiner d’abord un plan, activez Planifier avant de modifier dans le menu d’exécution avant de soumettre la tâche. Lisez le plan, puis confirmez-le ou expliquez les changements souhaités dans la conversation.

3.2 Clarifier les exigences

Adaptez cet exemple à votre projet :

Trouve et corrige le problème de pagination survenant lors d’un changement de filtre dans la liste de commandes.

Exigences :
1. Lire d’abord la documentation du dépôt et les instructions pertinentes.
2. Modifier uniquement le filtrage, la pagination et la logique directement liée.
3. Respecter les styles et conventions de test existants du projet.
4. Ajouter et exécuter les tests pertinents.
5. Résumer les fichiers modifiés, les résultats des vérifications et le travail restant.

Ne fusionne pas la PR.

3.3 Messages textuels et pièces jointes locales

Les messages de tâche envoyés directement à Cloud n’acceptent actuellement que du texte. Les pièces jointes locales, références de dossiers et références de code local ne peuvent pas être envoyées avec ces messages.

4. Transférer une tâche locale vers Cloud

4.1 Démarrer le transfert dans l’application de bureau

1. Ouvrez la conversation locale à poursuivre et vérifiez le projet actuel et la tâche.
2. Attendez la fin de l’exécution locale actuelle.
3. Ouvrez le menu de l’onglet de conversation et choisissez Déplacer vers Cloud.
4. S’il existe des fichiers non commités, examinez leur nombre, leur liste et la taille estimée du transfert, puis choisissez de les inclure ou non.
5. Vérifiez les informations affichées sur le dépôt, le commit et les autres détails de confirmation, et suivez les invites.
6. Attendez la réussite du transfert, puis suivez l’exécution cloud dans la tâche d’origine.

Si GitHub n’est pas autorisé, terminez l’autorisation depuis l’entrée des paramètres avant de réessayer.

4.2 Choisir d’inclure ou non les modifications non commitées

Lorsque Inclure les modifications non commitées ? apparaît :

Ce choix détermine si les modifications non commitées sont incluses. Examinez le périmètre de fichiers affiché avant de poursuivre ; ne supposez pas que tout le dossier local sera envoyé.

4.3 Ce qui change après le transfert

Un transfert réussi ne signifie pas que la tâche est terminée. Une fois dans Cloud, attendez l’exécution, examinez les résultats et traitez le travail de suivi éventuel.

4.4 Démarrer un transfert depuis le CLI

Dans un terminal où vous êtes connecté au CLI, listez les conversations du projet cible :

remy --workspace "/path/to/project" history list

Remplacez /path/to/project par le chemin réel du projet et CHAT_ID ci-dessous par l’identifiant de la conversation concernée.

Inclure les modifications non commitées :

remy --workspace "/path/to/project" cloud handoff --chat-id "CHAT_ID" --include-workspace --message "Poursuis les vérifications restantes dans le cloud et présente les résultats."

Conserver les modifications non commitées en local :

remy --workspace "/path/to/project" cloud handoff --chat-id "CHAT_ID" --exclude-workspace --message "Poursuis la tâche dans le cloud à partir du code commité."

Choisissez la commande adaptée à la tâche. Si le répertoire de travail ne comporte aucune modification non commitée, vous pouvez omettre à la fois --include-workspace et --exclude-workspace.

Le CLI affiche un aperçu du transfert. Vérifiez le périmètre de compte, le dépôt, la branche, le commit et le périmètre des fichiers, puis saisissez yes pour confirmer.

4.5 Vérifier ou annuler un transfert

Si un transfert est toujours en cours, vérifiez son état :

remy --workspace "/path/to/project" cloud status --chat-id "CHAT_ID"

Si vous disposez déjà de l’identifiant de transfert, vous pouvez l’indiquer explicitement :

remy --workspace "/path/to/project" cloud status --chat-id "CHAT_ID" --handoff-id "HANDOFF_ID"

Remplacez HANDOFF_ID par l’identifiant renvoyé pour cette opération. Si la connexion est interrompue après l’envoi ou si le résultat est inconnu, vérifiez d’abord ce même transfert au lieu d’en lancer un nouveau.

Pour annuler un transfert avant l’activation de la tâche cloud :

remy --workspace "/path/to/project" cloud cancel --chat-id "CHAT_ID" --handoff-id "HANDOFF_ID"

Cette commande annule uniquement un transfert n’ayant pas activé de tâche cloud. Elle ne peut pas annuler une tâche déjà activée. Pour une tâche déjà en cours dans Cloud, ouvrez-la dans l’application de bureau et utilisez sa commande d’arrêt.

La commande cloud status du CLI vérifie le transfert. Utilisez l’interface de tâche de l’application de bureau pour suivre l’avancement complet, poursuivre la conversation et effectuer des actions sur les PR.

5. Suivre les tâches et travailler sur plusieurs appareils

5.1 Comprendre l’étape actuelle

Après une demande d’arrêt, attendez la mise à jour de l’état de la tâche et confirmez la fin de l’exécution cloud.

5.2 Poursuivre dans la tâche d’origine

Pour affiner un résultat, ouvrez la même tâche cloud et expliquez ce qui doit changer :

Changer les filtres ramène maintenant la liste à la page 1, mais elle ne s’actualise pas.
Corrige uniquement la logique d’actualisation et préserve les modifications déjà terminées.
Ajoute et exécute les tests pertinents, puis résume les résultats.

Ne fusionne pas la PR.

Après une interruption réseau, rouvrez la tâche d’origine et vérifiez son état actuel et sa dernière réponse avant de décider de renvoyer un message. Si la liste des tâches ne s’actualise pas, elle peut encore afficher les derniers enregistrements récupérés.

5.3 Poursuivre depuis un autre appareil

1. Connectez-vous à Remy Desktop sur un autre appareil avec le même compte et confirmez le même périmètre d’équipe.
2. Trouvez la tâche cloud dans la barre latérale.
3. Ouvrez-la et attendez le chargement des messages et de l’état les plus récents.
4. Examinez les résultats ou ajoutez des exigences dans la même tâche.

L’ordinateur ayant lancé la tâche n’a pas besoin de rester en ligne. Les tâches Cloud peuvent continuer après la fermeture de l’application de bureau, la déconnexion réseau ou l’arrêt de votre ordinateur. Les questions nécessitant votre réponse attendront votre intervention.

Travaillez sur plusieurs appareils avec tout client compatible avec Cloud.

6. Examiner et livrer les résultats

6.1 Vérifier les résultats de la tâche

Un résultat de tâche ou une PR générée ne remplace pas la vérification des tests et du comportement réel.

6.2 Livrer le travail via une PR

Si vous avez besoin d’une PR, précisez-le dans la tâche. Par exemple :

Prépare une PR pour les modifications terminées.
Décris le problème résolu, les principales modifications, les vérifications exécutées et le travail restant.
Si cette tâche possède déjà une PR, mets à jour cette PR.

Ne la fusionne pas.

Lorsque la tâche crée une PR, une carte Brouillon de PR ou PR apparaît. Cliquez sur son lien pour ouvrir la PR dans votre navigateur et examiner la branche de travail, la branche cible et le diff réel.

Pour fusionner depuis Remy, examinez d’abord la PR, puis choisissez Fusionner la PR sur la carte. Vérifiez les branches source et cible dans la boîte de confirmation avant de poursuivre. La fusion modifie le dépôt distant ; utilisez l’état renvoyé pour confirmer le résultat.

6.3 Votre dossier local ne se met pas à jour automatiquement

Les résultats Cloud ne sont pas automatiquement synchronisés avec votre répertoire de travail local. Après avoir fusionné une PR, ou pour reprendre le travail local, récupérez et examinez le code avec le processus Git habituel du projet.

Le panneau local Modifications n’affiche pas nécessairement les dernières modifications de la tâche cloud.

7. Dépannage et limites connues

7.1 Accès, exécution et résultats

7.2 Limites actuelles

• Un transfert du local vers le cloud suit l’aperçu et le périmètre sélectionné. Il ne copie pas tout votre ordinateur ni votre environnement d’exécution local.
• Les messages lançant ou poursuivant des tâches Cloud n’acceptent actuellement que du texte.
• Votre choix de transfert détermine si les fichiers locaux non commités sont inclus.
• Vérifier un transfert dans le CLI est différent de suivre l’exécution de la tâche cloud.
• Les résultats Cloud ne se synchronisent pas automatiquement en local. Confirmez la livraison en vérifiant le code réel, les résultats des vérifications et l’état de la PR.

8. Obtenir de l’aide et poursuivre la découverte

8.1 Signaler un problème

Utilisez Envoyer un retour pour la tâche concernée. Pour les commandes de retour CLI, consultez le guide CLI.

Précisez si le problème s’est produit lors du lancement d’une tâche, du transfert du travail local vers Cloud, du suivi d’une tâche ou de la livraison d’une PR. Incluez le dépôt et la branche, l’identifiant de tâche ou de transfert éventuel et le message d’erreur.

Si vous ne pouvez pas ouvrir la tâche ou utiliser l’entrée de retour, contactez l’assistance à support@corepass.com.

8.2 Poursuivre la découverte