📄 PDF Tool

Herramientas para tus PDFs — sin subir nada a internet. Como app de escritorio o como comando para agentes de IA y scripts.

Comprime, une, divide, protege y marca tus documentos —y conviértelos desde imágenes— desde tu propio ordenador. Gratis, de código abierto y sin anuncios.

✨ Qué puedes hacer

🔐 Todo ocurre en tu equipo. Tus archivos nunca salen de tu ordenador.

En Comprimir PDF, el modo predeterminado busca la reducción máxima: primero reduce las imágenes y, solo si no basta, convierte páginas en imagen (lo avisa, porque se pierde el texto seleccionable). Con Conservar texto y enlaces nunca lo hace; el icono de ayuda explica la diferencia.

⬇️ Descargar e instalar

Ve a la página de descargas y elige el archivo de tu sistema:

🍎 macOS

1. Descarga el archivo .dmg y ábrelo.
2. Arrastra PDF Tool a la carpeta Aplicaciones.
3. Ábrela desde Aplicaciones. macOS mostrará un aviso y no dejará abrirla aún (es normal: la app no está firmada, pero es segura).
4. Ve a Menú Apple () → Ajustes del Sistema → Privacidad y Seguridad.
5. Baja hasta la sección Seguridad: verás un mensaje que dice que se bloqueó “PDF Tool”. Pulsa Abrir de todas formas y confirma con tu contraseña o Touch ID.
   _{Solo hay que hacerlo la primera vez. A partir de ahí se abre con doble clic como cualquier app.}

🪟 Windows

1. Descarga el instalador (.exe) y ejecútalo.
2. Si aparece SmartScreen: Más información → Ejecutar de todas formas.
   _{(El aviso sale porque el instalador no está firmado; es seguro.)}

✅ Tus ajustes se guardan fuera de la app, así que se conservan al actualizar. Cuando publique una nueva versión, la app te avisa con un banner.

🤖 Para agentes de IA y la línea de comandos

Las mismas herramientas están disponibles como comando, pensado para agentes (Claude Code, Cursor, Copilot…) y scripts. Todo sigue ocurriendo en tu equipo.

pipx install pdf-tool-cli                    # solo la CLI (sin la app de escritorio)
pdf-tool list --json                         # qué herramientas hay y qué aceptan
pdf-tool compress informe.pdf --json         # comprimir y obtener el resultado en JSON
pdf-tool merge a.pdf b.pdf --output-name todo
echo "$CLAVE" | pdf-tool protect a.pdf --password-stdin

Cada herramienta tiene su ayuda (pdf-tool compress --help). Códigos de salida: 0 ok · 1 error al procesar · 2 uso inválido · 3 algún archivo del lote falló. pipx install 'pdf-tool-cli[gui]' instala además la app (comando pdftool).

Plugin para Claude Code

Una skill le enseña a Claude Code a usar pdf-tool para crear o modificar PDFs en lugar de escribir scripts: pide permiso antes de instalar la CLI, ejecuta las herramientas con --json y te explica el resultado. Para instalarla, dentro de Claude Code:

/plugin marketplace add juanMaAV92/pdf-tool
/plugin install pdf-tool@pdf-tool

🤝 Contribuir

¡Las contribuciones son bienvenidas! Puedes abrir un issue con ideas o errores, o mandar un pull request. La arquitectura es modular: añadir una herramienta nueva es crear una carpeta y la app y la CLI la descubren solas. En el roadmap está lo que viene: una skill para que los agentes de IA usen la CLI.

poetry install --all-extras   # incluye Flet (extra [gui]) para la app
poetry run pdftool        # abre la app
poetry run pytest         # corre los tests

git tag vX.Y.Z
git push origin vX.Y.Z

poetry run flet build macos --project pdf-tool --product pdf-tool     # -> build/macos/pdf-tool.app
poetry run flet build windows --project pdf-tool --product pdf-tool   # -> build/windows/