Proyectos y URL

#Añadir un proyecto

1. Archivo → Abrir carpeta de proyecto… (⌘O / CtrlO), Añadir proyecto en la barra lateral o Añadir proyecto… en el menú de proyectos de la barra de título.
2. Elige de dónde viene el proyecto:
   • En este equipo: elige una carpeta.
   • Clonar desde GitHub / GitLab: elige uno de tus repositorios (listados mediante tu sesión de gh o glab) o pega una URL, elige la carpeta superior, y Ferret lo clona y lo abre.
   • Abrir por SSH: elige un host de ~/.ssh/config. La terminal y los agentes se ejecutan en la máquina remota; las revisiones se quedan en este equipo.

El nombre predeterminado es el de la carpeta. Si añades una carpeta que ya está registrada, se abre en su lugar (en macOS y Windows las rutas se comparan sin distinguir mayúsculas y minúsculas). Desde el menú de la barra lateral puedes Renombrar un proyecto o Quitar de la lista. Quitarlo nunca elimina la carpeta.

Las terminales se abren en la carpeta del proyecto y las revisiones se guardan en <project>/.ferret/.

#Guardar URL

1. Abre la página en el navegador integrado.
2. Haz clic en + (Guardar URL actual) en la barra de herramientas del navegador. La URL actual aparece ya rellenada.
3. Escribe un Nombre y haz clic en Guardar.

Solo se aceptan URL http:// y https://. Si dejas el nombre sugerido, se deduce del host:

#Panel de objetivos de revisión

En el modo Feedback, el panel Objetivos de revisión de la derecha muestra todo lo que puedes revisar en el proyecto actual. Cambiar de objetivo no detiene la grabación. Muestra u oculta el panel con Visualización → Mostrar/ocultar objetivos de revisión (⌘⇧K / CtrlShiftK) o con Ocultar panel.

• Objetivos: las URL guardadas del proyecto. Debajo de cada una hay un árbol con las páginas que has visitado en ese sitio. Los sitios visitados que no están guardados aparecen como grupos propios.
• Archivos: la carpeta del proyecto. Un archivo se abre como vista previa (Markdown y Mermaid renderizados, el resto de texto en solo lectura), así que también puedes revisar documentación. El lápiz (Abrir en el editor) lo abre en el editor.

Filtrar objetivos filtra a la vez objetivos, páginas y archivos, con la misma búsqueda aproximada que Ir al archivo…. En la lista, ↑ ↓ Enter o 1–9 cambian de objetivo. Abrir URL… abre una URL puntual y Guardar en las URL del proyecto la conserva.

Los objetivos vienen de projects[].urls en settings.json (consulta el ejemplo). Cada entrada necesita una url, un launchCommand (se ejecuta en una terminal, p. ej. para iniciar una app de escritorio) o un windowMatch (la ventana que se graba). Elegir un objetivo de ventana lo establece como origen de la grabación, así que no se puede hacer mientras grabas. Las páginas visitadas se recuerdan por proyecto, solo en este equipo (hasta 200).

#Abrir y cambiar de entorno

Haz clic en una URL guardada para abrirla. Si la página actual está bajo otra URL guardada, Ferret conserva la ruta, la query y el hash y solo cambia el origen. Por ejemplo, en http://localhost:3000/pricing?plan=pro, al hacer clic en prd se abre https://example.com/pricing?plan=pro.

Se resalta la etiqueta que corresponde a la página actual (el prefijo más largo). Haz clic derecho en una etiqueta o usa su icono de lápiz para editarla o eliminarla (Eliminar). Cuando se abre un proyecto y no hay URL anterior, se carga su primera URL guardada.