Guía rápida

#Antes de empezar

• Un agente de programación que se ejecute en una terminal, instalado y con la sesión iniciada: por ejemplo Claude Code (claude), Codex (codex) o Gemini CLI (gemini). Ferret lo ejecuta en su terminal integrada. Sirve cualquier agente de la lista de compatibles, y también cualquier otro CLI que añadas tú.
• Una aplicación web que puedas abrir por URL, p. ej. un servidor de desarrollo en http://localhost:3000.
• Un micrófono. El feedback es tu voz más el lápiz. Sin micrófono, los círculos del lápiz siguen convirtiéndose en hallazgos, pero sin palabras.

#1. Instalar

Descarga la versión para tu sistema operativo desde la página de descarga y ábrela. La versión de macOS está firmada con un Developer ID y notarizada por Apple, así que se abre como cualquier otra app. Las versiones de Windows y Linux aún no tienen firma de código, por lo que el primer inicio requiere un paso más. Consulta Instalación para Windows SmartScreen, Linux y la compilación desde el código fuente.

#2. Abrir un proyecto y una URL

1. Archivo → Abrir carpeta de proyecto… (⌘O / CtrlO) y elige la raíz de tu repositorio.
2. Escribe la URL de tu servidor de desarrollo en la barra de direcciones del navegador (⌘L / CtrlL) y pulsa Enter.
3. Opcional: haz clic en + (Guardar URL actual) para guardarla como un preajuste de un clic, como local, dev o prd.

Al abrir un proyecto también se inician tus agentes en pestañas de terminal en esa carpeta. De forma predeterminada son Claude Code y Codex; elige los que uses en Ajustes → Agentes → Iniciar al abrir un proyecto (consulta Ajustes).

#3. Grabar

1. Haz clic en Grabar en la barra de título o pulsa ⌘⇧R / CtrlShiftR. La ventana pasa al modo Feedback.
2. Usa la página como siempre y di qué debería cambiar.
3. Mantén pulsada ⌥ / Alt (o elige Lápiz) y arrastra para rodear el punto mientras hablas de él.
4. Haz clic en Detener o vuelve a pulsar ⌘⇧R / CtrlShiftR.

Cada momento en que hablas o rodeas algo se convierte en un hallazgo: una captura de pantalla con tus trazos de lápiz, la petición, las palabras originales, la URL y el elemento que señalaste.

#4. Revisar los hallazgos

Al detener, la ventana vuelve al modo Editor y abre la pestaña Hallazgos.

• Edita un título o una petición directamente.
• Alterna Enviar / No enviar en cada hallazgo, Combinar con el siguiente o Eliminar.
• Deshacer revierte la última edición.

#5. Enviar a un agente

1. Haz clic en Enviar al agente. Se envía al agente de la pestaña de terminal actual o a uno en marcha. La flecha junto al botón permite elegir un agente o una pestaña concretos.
2. Si todavía no hay ningún agente en marcha, Ferret inicia uno primero y envía en cuanto está listo.

Ferret escribe una instrucción en el prompt del agente y la envía. De forma predeterminada empieza así:

Lee "{{path}}" y la imagen de cada hallazgo en la misma carpeta, e implementa todos los hallazgos marcados para enviar. …

El resto pide al agente que compruebe cada cambio en la pantalla real, registre su progreso por hallazgo y termine con una lista de Hecho / No hecho. El agente lee .ferret/reviews/<timestamp>/feedback.md y los PNG que hay a su lado. El vídeo nunca se envía. ¿Usas un agente fuera de Ferret? Haz clic en Copiar para el agente y pégalo.

La instrucción predeterminada sigue el idioma de la interfaz. Puedes sustituirla en Ajustes: consulta Personalizar la instrucción.

#Siguientes pasos

• Conceptos: modos, hallazgos y lo que recibe el agente
• Transcripción y costes: descarga un modelo whisper gratuito que funciona en el dispositivo o usa tu propio endpoint
• Atajos de teclado