Guía de Cloud

Cloud ejecuta tareas de forma remota. Inicia una tarea seleccionando un repositorio, o mueve una tarea local existente a la nube, y luego sigue el trabajo desde cualquier cliente disponible que sea compatible con Cloud.

Esta guía usa la app de escritorio como interfaz principal. También incluye comandos de la CLI para mover una tarea local a Cloud y comprobar el estado de la transferencia.

flowchart TD
    A["Comprobar el acceso a la cuenta y al repositorio"] --> B{"¿Dónde vas a empezar?"}
    B --> C["Seleccionar un repositorio e iniciar una tarea en la nube"]
    B --> D["Abrir una tarea local existente"]
    D --> E["Revisar la conversación y los cambios sin commit que se transferirán"]
    C --> F["Cloud prepara y ejecuta la tarea"]
    E --> F
    F --> G["Seguir el progreso, añadir contexto y revisar los resultados"]
    G --> H["Refinar el trabajo o entregarlo mediante un PR"]

1. Antes de empezar

1.1 Cuenta y clientes

Los ejemplos de esta guía usan repositorios de GitHub. Para la instalación y el inicio de sesión, consulta la Guía de la app de escritorio.

1.2 Elige cómo empezar

2. Conecta tu repositorio y comprueba los requisitos

2.1 Conecta GitHub

1. Abre el selector de proyectos en la app de escritorio y busca Cloud.
2. Si Cloud no está disponible, haz clic en el botón de configuración que hay a su lado para abrir la página de conexión con GitHub.
3. Sigue las instrucciones de la página para autorizar GitHub.
4. Vuelve al selector de proyectos, abre Cloud y comprueba que aparece el repositorio de destino.

Usa Search repos para encontrar un repositorio. Si no aparece, revisa la cuenta de GitHub conectada y los repositorios a los que tiene autorizado el acceso.

2.2 Comprueba el repositorio y la rama

Cuando seleccionas un repositorio, Remy empieza con su rama predeterminada. Para usar otra, abre el selector de ramas y elige la rama desde la que debe empezar la tarea.

2.3 Cómo prepara Cloud el entorno

Después de enviar una tarea, Cloud prepara el espacio de trabajo, obtiene el código del repositorio e inicia la ejecución según sea necesario. Este flujo de trabajo no requiere que crees un entorno en la nube con nombre propio.

No des por hecho que las dependencias instaladas en tu ordenador, los servidores de desarrollo locales y las credenciales locales existen en Cloud. Si la tarea necesita dependencias especiales, explica cómo prepararlas y comprobarlas en la documentación del proyecto o en la descripción de la tarea.

Lee primero el README y las instrucciones del proyecto del repositorio.
Confirma cómo instalar las dependencias, ejecutar el proyecto y ejecutar sus pruebas.
Si al entorno le falta algo necesario, identifica qué falta e incluye el error correspondiente.
Ejecuta las comprobaciones que puedas y enumera por separado las que no puedas ejecutar.

3. Inicia una tarea directamente en Cloud

3.1 Selecciona un repositorio y envía la tarea

1. Inicia un chat nuevo y abre Cloud en el selector de proyectos.
2. Busca y selecciona el repositorio de destino, y luego comprueba la rama.
3. Confirma que la opción de ejecución muestra Send to cloud.
4. Elige un modelo disponible, describe la tarea y envíala.
5. Espera a la inicialización y la ejecución, y luego revisa el progreso y los resultados.

Para revisar primero un plan, activa Plan before editing en el menú de ejecución antes de enviar la tarea. Lee el plan y luego confírmalo o explica en el chat los cambios que quieres.

3.2 Deja claros los requisitos

Adapta este ejemplo a tu proyecto:

Encuentra y corrige el problema de paginación que ocurre cuando cambian los filtros en la lista de pedidos.

Requisitos:
1. Lee primero la documentación del repositorio y las instrucciones relevantes.
2. Cambia solo el filtrado, la paginación y la lógica directamente relacionada.
3. Sigue los estilos y las convenciones de pruebas existentes del proyecto.
4. Añade y ejecuta las pruebas relevantes.
5. Resume los archivos modificados, los resultados de las comprobaciones y el trabajo pendiente.

No hagas merge del PR.

3.3 Mensajes de texto y adjuntos locales

Los mensajes de tarea enviados directamente a Cloud solo aceptan texto por ahora. No se pueden enviar adjuntos locales, referencias a carpetas ni referencias a código local con estos mensajes.

4. Mueve una tarea local a Cloud

4.1 Inicia la transferencia en la app de escritorio

1. Abre el chat local que quieres continuar y comprueba el proyecto y la tarea actuales.
2. Espera a que termine la ejecución local en curso.
3. Abre el menú de la pestaña del chat y elige Move to Cloud.
4. Si hay archivos sin commit, revisa el número de archivos, la lista y el tamaño estimado de la transferencia, y luego elige si quieres incluirlos.
5. Comprueba el repositorio, el commit y cualquier otro detalle de confirmación que se muestre, y sigue las indicaciones.
6. Espera a que la transferencia se complete correctamente y luego sigue la ejecución en la nube en la tarea original.

Si GitHub no está autorizado, completa la autorización desde la entrada de configuración antes de volver a intentarlo.

4.2 Elige si incluir los cambios sin commit

Cuando aparezca Include uncommitted changes?:

Esta elección determina si se incluyen los cambios sin commit. Revisa el alcance de archivos que se muestra antes de continuar; no des por hecho que se subirá toda la carpeta local.

4.3 Qué cambia después de la transferencia

Una transferencia correcta no significa que la tarea esté completa. Una vez que pase a Cloud, espera a la ejecución, revisa los resultados y atiende cualquier trabajo de seguimiento.

4.4 Inicia una transferencia desde la CLI

En una terminal en la que hayas iniciado sesión en la CLI, enumera los chats del proyecto de destino:

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

Sustituye /path/to/project por la ruta real del proyecto y CHAT_ID, más abajo, por el ID de la conversación correspondiente.

Incluir los cambios sin commit:

remy --workspace "/path/to/project" cloud handoff --chat-id "CHAT_ID" --include-workspace --message "Continue the remaining checks in the cloud and report the results."

Mantener los cambios sin commit en local:

remy --workspace "/path/to/project" cloud handoff --chat-id "CHAT_ID" --exclude-workspace --message "Continue the task in the cloud using the committed code."

Elige el comando que se ajuste a la tarea. Si el directorio de trabajo no tiene cambios sin commit, puedes omitir tanto --include-workspace como --exclude-workspace.

La CLI muestra una vista previa de la transferencia. Comprueba el ámbito de la cuenta, el repositorio, la rama, el commit y el alcance de archivos, y luego escribe yes para confirmar.

4.5 Comprueba o cancela una transferencia

Si una transferencia sigue en curso, comprueba su estado:

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

Si ya tienes el ID del handoff, puedes especificarlo explícitamente:

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

Sustituye HANDOFF_ID por el ID devuelto para esa operación. Si la conexión se interrumpe después de la subida o el resultado es desconocido, comprueba primero esa misma transferencia en lugar de iniciar una nueva.

Para cancelar una transferencia antes de que se haya activado la tarea en la nube:

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

Este comando solo cancela una transferencia que no ha activado una tarea en la nube. No puede cancelar una tarea que ya se ha activado. Para una tarea que ya se está ejecutando en Cloud, ábrela en la app de escritorio y usa el control de detención de la tarea.

El comando cloud status de la CLI comprueba la transferencia. Usa la interfaz de tareas de la app de escritorio para ver el progreso completo de la tarea, continuar la conversación y realizar acciones de PR.

5. Sigue las tareas y trabaja entre dispositivos

5.1 Entiende la etapa actual

Después de solicitar una detención, espera a que se actualice el estado de la tarea y confirma que la ejecución en la nube ha terminado.

5.2 Continúa en la tarea original

Para refinar un resultado, abre la misma tarea en la nube y explica qué debe cambiar:

Ahora, al cambiar los filtros, la lista vuelve a la página 1, pero no se actualiza.
Corrige solo la lógica de actualización y conserva los cambios ya completados.
Añade y ejecuta las pruebas relevantes, y luego resume los resultados.

No hagas merge del PR.

Después de una interrupción de red, vuelve a abrir la tarea original y comprueba su estado actual y la última respuesta antes de decidir si reenviar un mensaje. Si la lista de tareas no se actualiza, es posible que siga mostrando los últimos registros que obtuvo.

5.3 Continúa desde otro dispositivo

1. Inicia sesión en Remy Desktop en otro dispositivo con la misma cuenta y confirma el mismo ámbito de equipo.
2. Busca la tarea en la nube en la barra lateral.
3. Ábrela y espera a que se carguen los mensajes y el estado más recientes.
4. Revisa los resultados o añade requisitos en la misma tarea.

El ordenador que inició la tarea no necesita permanecer en línea. Las tareas en la nube pueden continuar después de que cierres la app de escritorio, te desconectes o apagues el ordenador. Las preguntas que necesiten tu respuesta esperarán a que respondas.

Trabaja entre dispositivos con cualquier cliente compatible con Cloud.

6. Revisa y entrega los resultados

6.1 Comprueba los resultados de la tarea

Un resultado de tarea o un PR generado no sustituye la comprobación de las pruebas y del comportamiento real.

6.2 Entrega el trabajo mediante un PR

Si necesitas un PR, indícalo en la tarea. Por ejemplo:

Prepara un PR con los cambios completados.
Describe el problema resuelto, los cambios principales, las comprobaciones que se ejecutaron y el trabajo pendiente.
Si esta tarea ya tiene un PR, actualiza ese PR.

No hagas merge.

Cuando la tarea crea un PR, aparece una tarjeta Draft PR o PR. Haz clic en su enlace para abrir el PR en tu navegador y revisar la rama de trabajo, la rama de destino y el diff real.

Para hacer merge desde Remy, revisa primero el PR y luego elige Merge PR en la tarjeta. Comprueba las ramas de origen y de destino en el cuadro de diálogo de confirmación antes de continuar. El merge modifica el repositorio remoto; usa el estado devuelto para confirmar el resultado.

6.3 Tu carpeta local no se actualiza automáticamente

Los resultados de Cloud no se sincronizan automáticamente con tu directorio de trabajo local. Después de hacer merge de un PR, o cuando quieras retomar el trabajo en local, obtén e inspecciona el código con el flujo de trabajo de Git habitual de tu proyecto.

El panel local Changes no muestra necesariamente los cambios más recientes de la tarea en la nube.

7. Solución de problemas y limitaciones conocidas

7.1 Acceso, ejecución y resultados

7.2 Límites actuales

• Una transferencia de local a la nube se ajusta a la vista previa y al alcance que selecciones. No copia todo tu ordenador ni tu entorno de ejecución local.
• Los mensajes que inician o continúan tareas de Cloud solo aceptan texto por ahora.
• Tu elección en la transferencia determina si se incluyen los archivos locales sin commit.
• Comprobar una transferencia en la CLI es distinto de seguir la ejecución de la tarea en la nube.
• Los resultados de Cloud no se sincronizan automáticamente en local. Confirma la entrega revisando el código real, los resultados de las comprobaciones y el estado del PR.

8. Obtén ayuda y sigue explorando

8.1 Informa de un problema

Usa Send feedback en la tarea correspondiente. Para los comandos de comentarios de la CLI, consulta la Guía de la CLI.

Indica si el problema ocurrió al iniciar una tarea, al mover trabajo local a Cloud, al seguir una tarea o al entregar un PR. Incluye el repositorio y la rama, cualquier ID de tarea o de handoff y el mensaje de error.

Si no puedes abrir la tarea ni usar la entrada de comentarios, contacta con soporte en support@corepass.com.

8.2 Sigue explorando