Folio Writer
Folio Helper
Una pequeña app complementaria y gratuita que permite a la edición del Mac App Store de Folio Writer compilar con las herramientas que ya tienes instaladas en tu Mac, esas que el aislamiento (sandbox) de Apple no deja que la app ejecute por sí misma.
Versión 1.7 · Gratis · notarizada por Apple · macOS 14 o posterior. Solo la necesitas con la edición del Mac App Store, y solo para usar herramientas que hayas instalado tú.
Novedades de la 1.7: el asistente ahora también puede ejecutar la línea de comandos Codex de OpenAI (codex), para que el proveedor del asistente ChatGPT (Codex) en este Mac, que llega con Folio Writer 1.18, funcione en la edición del App Store. Encuentra codex dondequiera que lo hayan instalado npm, Homebrew o Volta. Si las actualizaciones automáticas están activadas, lo recibirás sin hacer nada.
¿Ya tienes Folio Helper? A partir de Folio Writer 1.8.6 y Folio Helper 1.6.3, las actualizaciones son automáticas: la app busca nuevas versiones aproximadamente una vez al día, verifica la firma de código de la descarga y el asistente en ejecución se reemplaza discretamente en segundo plano, sin diálogos, sin clics, sin nada que aprobar. ¿Prefieres que te pregunte antes? Desactívalo en Ajustes ▸ Compilar; hay un botón de actualización manual en Compilar ▸ Configurar herramientas externas….
¿Usas Folio Writer 1.8.4 o anterior? Esas versiones van con Folio Helper 1.5 (también disponible en el archivo sin número de versión FolioHelper.zip al que apuntan sus enlaces).
Actualizar a mano también funciona: cierra Folio Writer (Folio Helper se cierra con él), reemplaza Folio Helper.app en Aplicaciones por la nueva y vuelve a abrir Folio Writer.
Para qué sirve
La edición del App Store se ejecuta en el entorno aislado (sandbox) de Apple, que prohíbe lanzar programas externos, incluidas las herramientas de composición que hayas instalado con Homebrew, MacTeX o TinyTeX. Folio Helper es un pequeño agente que vive fuera del entorno aislado y ejecuta esas herramientas en nombre de Folio Writer: pandoc, pandoc-crossref, typst, xelatex / pdflatex / lualatex / latexmk, tectonic, quarto y las líneas de comandos claude y codex. Con él instalado, compilar a PDF con tu propio LaTeX, renderizar proyectos .qmd con Quarto y el modo Claude CLI del asistente de escritura (y, desde Folio Writer 1.18, ChatGPT a través de Codex) funcionan en la edición del App Store.
¿Todavía no tienes las herramientas? Instala pandoc, pandoc-crossref, Quarto, Typst y un motor LaTeX con un solo comando en Terminal (muestra un menú para elegir lo que quieres):
curl -fsSL https://foliowriter.app/install-folio-tools.sh | bash
Cómo instalarlo
La forma fácil (Folio Writer 1.8.5 o posterior): abre Compilar ▸ Configurar herramientas externas… y haz clic en Instalar Folio Helper. Folio Writer lo descarga, verifica la firma y lo coloca en Aplicaciones: apruebas la carpeta Aplicaciones una vez, confirmas el único aviso de notarización de macOS, y esa es la última interacción que el asistente necesitará nunca: a partir de ahí se mantiene actualizado automáticamente.
A mano:
- Descarga el zip de arriba y descomprímelo (puede que Safari ya lo haya hecho).
- Arrastra Folio Helper.app a tu carpeta Aplicaciones.
- Ábrelo una vez. No tiene ventana: se registra como asistente en segundo plano y aparece en Ajustes del Sistema ▸ General ▸ Ítems de inicio como «Folio Helper».
- En Folio Writer, abre Compilar ▸ Configurar herramientas externas… y pulsa Volver a comprobar. La tarjeta del asistente lista todas las herramientas que encontró, con su ruta y su versión.
Lo que hace, y lo que no
- Ejecuta solo la lista fija de herramientas de arriba: no se le puede pedir que ejecute nada más.
- Las ejecuta solo cuando Folio Writer se lo pide; se verifica mediante la firma de código que las conexiones vienen de Folio Writer.
- Sin ventana, sin icono en la barra de menús, sin acceso propio a la red, sin recopilar nada. Busca las herramientas en los lugares habituales (Homebrew, MacTeX, TinyTeX, npm, Volta,
/usr/local) y mediante elPATHde tu shell de inicio de sesión.
Desinstalar
Ciérralo (Ajustes del Sistema ▸ Ítems de inicio ▸ desactiva «Folio Helper») y luego elimina Folio Helper.app de Aplicaciones. Folio Writer sigue funcionando; la compilación simplemente se limita a lo que permite el entorno aislado.