PerchAI
Cómo usar Perch

App de escritorio

Perch Terminal Desktop para macOS, Windows y Linux. Cómo instalarla, cómo mantenerla actualizada, y qué hace que el navegador no puede.

Perch Terminal Desktop es el agente completo. Trabaja desde las carpetas de tu computadora: lee y edita archivos, ejecuta comandos en una terminal, maneja un navegador y lanza ayudantes. El chat web responde preguntas y busca; la app de escritorio hace el trabajo.

One account

Tu cuenta web y tu cuenta de escritorio son la misma cuenta, con la misma memoria y el mismo uso incluido. Inicia sesión una sola vez.

Instalación

Descárgala desde la página de escritorio. Hay compilaciones para Mac con Apple silicon e Intel, Windows x64 y Linux x64 (en beta).

  • Mac. Abre el DMG, arrastra Perch Terminal a Aplicaciones y ábrela desde ahí. La app está firmada y notarizada. Ejecutarla desde el DMG funciona, pero ahí no puede actualizarse sola, así que muévela a Aplicaciones.
  • Windows. Ejecuta el instalador e iníciala desde Inicio. Si SmartScreen avisa, elige More info y luego Run anyway: la compilación de Windows no está firmada con EV durante el acceso anticipado.
  • Linux. En Ubuntu o Debian instala el .deb, que además instala el perfil de seguridad que Ubuntu necesita para el sandbox de Perch. En otras distribuciones usa el AppImage: dale chmod +x y luego ejecútalo. Los AppImage necesitan FUSE 2 (libfuse2, o libfuse2t64 en Ubuntu 24.04 y posteriores).

La primera vez

  1. Inicia sesión con Google o GitHub.
  2. Aprueba una carpeta. Perch solo lee y escribe dentro de las carpetas que apruebas. Empieza por la carpeta donde está el trabajo.
  3. Pídele que lea primero. La primera respuesta útil suele llegar después de que Perch inspeccionó los archivos, no antes.

Una carpeta que apruebas queda aprobada, y la lista de chats agrupa tus chats bajo las carpetas a las que pertenecen.

Actualizaciones

La app se mantiene al día sola. Busca una versión nueva poco después de que se abre la ventana y luego cada pocas horas, la descarga en segundo plano y muestra Restart to update cuando está lista. Al elegir eso, la instala y vuelve a iniciar Perch. Si nunca lo eliges, la actualización se instala cuando sales.

Para comprobarlo a mano, elige Check for Updates… en el menú Perch Terminal en Mac, o en Help en Windows y Linux.

Dos detalles de plataforma:

  • En Mac, la app no puede reemplazarse a sí misma mientras se ejecuta desde el DMG. Muévela a Aplicaciones, o elige Move to Applications cuando Perch te lo ofrezca.
  • En una instalación .deb de Linux, la actualización pide tu contraseña, porque el paquete se instala con el gestor de paquetes del sistema. Esa se instala solo con Restart to update, nunca al salir.

Qué agrega la app de escritorio

Solo aquíQué es
Carpetas y archivos localesLeer, escribir, mover y editar archivos en las carpetas que apruebas.
Una terminalEjecutar comandos, incluso en segundo plano.
El navegador del agenteUn navegador real en un panel lateral que Perch maneja, usando las sesiones en las que tienes la sesión iniciada.
Comandos de barraObjetivos, investigación profunda, /verify y el resto. Consulta Comandos de barra.
Sub-agentes y FlockAyudantes dentro de un turno, y un equipo planificado para una tarea difícil.
Conectores MCP en tu computadoraHerramientas que se ejecutan como un programa en esta máquina.
Modelos localesEjecutar Perch con un modelo servido desde tu propia computadora.

Los paneles laterales

El lado derecho de la ventana contiene tres paneles, uno a la vez:

  • Browser. El navegador del agente, con barra de direcciones y atrás, adelante y recargar, así puedes tomar el volante en cualquier momento. También puede salir a su propia ventana.
  • Files. Los archivos de este chat, y un visor para uno de ellos.
  • Terminal. Lo que Perch ejecutó, y su salida.

El panel Context window del cuadro de mensaje muestra con qué se armó el turno actual, incluidas las notas de memoria que recibió. Consulta Memoria y Contexto.

En Pro y Ultra la app también tiene una pestaña de agentes de CLI, donde Claude Code y Codex se ejecutan con tus propios planes, cada uno en su propia copia de tu repositorio.

Perch Terminal en un navegador

En Pro y Ultra, Perch Terminal también se abre en el navegador en chat.perchai.app/agents/desktop. Es la misma superficie, ejecutándose en la nube en lugar de en tu máquina, así que tiene un espacio de trabajo propio en vez de tus carpetas locales.