iWork Studio

La forma segura de dejar que la IA edite tus archivos de Numbers, Keynote y Pages.

Presentaciones diseñadas a partir de tus datos y tu marca, verificadas tal como se renderizan. Listo para árabe.
Cada cambio se respalda, se verifica y se puede deshacer, y cualquier cosa arriesgada se rechaza, nunca se adivina.

🛡️ Nunca daña tu archivo	🎨 Diseñado a partir de tus datos	ع Árabe de primera clase
Respaldo → cambia una copia → vuelve a leer y compara → intercambio atómico. Los archivos abiertos se dejan en paz. Una llamada deshace cualquier cambio.	Convierte una hoja de cálculo en una presentación de Keynote con diapositivas de gráficos y tablas en tu kit de marca, luego revísala tal como se renderiza.	El texto en árabe y de derecha a izquierda se conserva exactamente, en cada aplicación y cada exportación.

Instalar · Pruébalo · Seguridad · Lo que puede hacer · Todas las herramientas · Para agentes de IA · Registro de cambios

_{15 segundos: datos → presentación diseñada → una reversión segura → árabe. Video HD}

_{▶ Mira la película con sonido (46s) · Lee la historia de lanzamiento}

Instalación

Eso es todo. El instalador configura uv si es necesario, y uv trae su propio Python.

• Delimítalo (recomendado): … | sh -s -- --roots ~/Documents ~/Desktop lo limita a esas carpetas. Otros clientes: configura IWORK_STUDIO_ROOTS (separado por :).
• Carga menos (opcional): ¿solo trabajas en Keynote? Configura IWORK_STUDIO_TOOLSETS=keynote,design (cualquiera de files, numbers, keynote, pages, design; por defecto todos). Menos herramientas mantienen a la IA enfocada y su contexto pequeño. La extensión de Claude Desktop tiene un campo Toolsets; en Claude Code: claude mcp add iwork-studio -e IWORK_STUDIO_TOOLSETS=keynote,design -- uvx --from iwork-studio@latest iwork-studio-mcp. Las capacidades, lectura, búsqueda, deshacer y la lista de kits siempre se cargan.
• Primera ejecución: macOS pregunta una vez si Claude puede controlar Keynote / Pages / Numbers. Haz clic en OK. (¿Lo perdiste? Configuración del sistema → Privacidad y seguridad → Automatización.)
• Verifícalo: pregunta "¿qué puede hacer iwork-studio en este Mac?".
• Eliminar: uvx --from iwork-studio@latest iwork-studio-mcp uninstall

¿Un agente de IA configurando esto para alguien? Elige la fila para su aplicación, ejecútala, luego llama a iwork_capabilities. Las reglas para usar las herramientas están en AGENTS.md.

Solo pregunta, en inglés o árabe

¿No tienes un archivo a mano? Pregunta "copia los ejemplos de iWork Studio a mi Escritorio y convierte sample-sales.numbers en una presentación de junta". Los ejemplos son datos de ventas sintéticos con una hoja en inglés y una en árabe.

"Crea una presentación de 6 diapositivas para una startup de paneles solares con el kit midnight, con notas del presentador, y expórtala a PowerPoint."

"Convierte sales.numbers en una presentación de junta: grafica los trimestres, una tabla de las regiones principales, con nuestro kit Acme."

"Toma las fuentes y colores de brand.key y guárdalos como nuestro kit Acme."

"Revisa pitch.key y arregla cualquier cosa que se desborde o sea demasiado pequeña para leer."

"Haz que budget.numbers se vea profesional con el kit bancario — y muéstrame una vista previa primero."

"Convierte sales.csv en un archivo de Numbers, haz el encabezado en negrita con relleno verde azulado, muestra la columna B como SAR con dos decimales, y agrega una fila de totales."

"En pitch.key, cambia al tema Gradient, haz el título de la diapositiva 1 blanco a 60 pt, agrega una disolución entre cada diapositiva, y pon logo.png en la última diapositiva."

"Agrega un gráfico de barras de ingresos por trimestre para 2025 y 2026 a la diapositiva 4."

"Duplica la diapositiva 3, mueve el texto al frente y agrega notas del presentador: ملاحظات المتحدث"

"Completa los campos Nombre y Fecha en offer-letter.pages, luego expórtalo como PDF protegido con contraseña."

"En la tabla de invoice.pages, establece la cantidad en B3 a 12 y haz que D9 sea el total de D2:D8."

"Encuentra mis presentaciones de Keynote de esta semana y exporta cada una a PowerPoint."

"Deshaz el último cambio en budget.numbers."

Lo que puede hacer

⚡ = funciona en cualquier lugar, sin necesidad de aplicación (Python puro). Todo lo demás maneja la aplicación real en un Mac con una sesión iniciada, iWork clásico o las aplicaciones Creator Studio.

Cada tipo de archivo: previsualiza cualquier cambio antes de que se haga (dry_run), consulta metadatos, extrae la miniatura de vista previa, encuentra archivos con Spotlight, verifica que una palabra se muestre visiblemente, verifica la fuente/tamaño/color renderizados, lista respaldos y deshacer.

Lo que no hará

A propósito, para que nunca rompa un archivo:

• Los archivos con gráficos son rechazados por las herramientas que funcionan sin la aplicación: su reescritura puede romper silenciosamente el vínculo de un gráfico con sus datos. Las herramientas impulsadas por la aplicación (diapositivas de Keynote, temas, transiciones, imágenes; fórmulas y ordenamiento de Numbers) funcionan en ellos y verifican que cada gráfico siga ahí.
• Los gráficos en Numbers y Pages no se crean: no son confiablemente scriptables, y preferimos rechazar antes que hacer clic en los menús de la aplicación y arriesgar tu archivo. Los gráficos de Keynote se pueden agregar. Para graficar datos ordenados sin tocar un gráfico de Numbers, ordena en una tabla nueva (numbers_sort con to_new_table) y crea una diapositiva de gráfico de Keynote a partir de ella.
• Pages se limita a texto y tablas existentes: reemplazar, establecer cuerpo, marcadores de posición y celdas de tabla. No se pueden crear tablas nuevas (Pages 15 no lo scripta), y los documentos de diseño de página, como la mayoría de las plantillas de cartas, no tienen texto de cuerpo. No hay un analizador de formato de archivo de Pages en ningún lugar, así que no finge uno.
• Fórmulas y desplazamientos de filas: en una tabla que tiene fórmulas, las filas y columnas solo se pueden agregar sin la aplicación. Insertar en el medio dejaría referencias apuntando a las celdas equivocadas.
• No scriptable por Apple, así que no se ofrece: estilos de tabla de Numbers, relleno de formas y alineación de texto en Keynote, eliminar una tabla de Keynote, editar las diapositivas maestras de un tema. Los márgenes de página y la configuración de página están planificados.

Diseñado, no solo editado

Seis kits de diseño convierten una presentación o tabla simple en algo que presentarías: un par de fuentes (latín + árabe, todas incluidas con macOS — nada que instalar), una paleta sobria verificada por contraste WCAG, y una escala tipográfica.

Construye con uno (keynote_build_deck(..., kit="midnight")), reestiliza cualquier cosa (keynote_apply_design, numbers_apply_design), o trae tu marca como colores y fuentes — el contraste se verifica. Los agentes también obtienen una guía de diseño: una idea por diapositiva, títulos que expresan la conclusión, números alineados a la derecha, color sobrio.

Tu marca, una vez. Apunta iwork_extract_design_kit a una presentación o tabla que ya tenga tu estilo: lee las fuentes (latín y árabe) y los colores, y los guarda como un kit con nombre que puedes usar en cualquier lugar donde se use un kit. O guarda tus colores y fuentes directamente con iwork_save_design_kit.

Numbers en diapositivas. Una diapositiva en keynote_build_deck puede llevar un gráfico o una tabla, desde datos o directamente desde una tabla de Numbers: la fila de encabezado da las columnas, la primera columna las filas. Las tablas obtienen la banda de encabezado del kit, fuentes, bandas y números alineados a la derecha, y cada celda se lee de vuelta.

Verifica su propio trabajo. keynote_review_deck renderiza la presentación a través de Keynote y compara cada línea dibujada con su caja de texto: texto fuera de la diapositiva o más allá de su caja es un error; texto que Keynote tuvo que encoger para que quepa, cajas superpuestas, texto menor de 18 pt y diapositivas abarrotadas son advertencias. keynote_slide_image devuelve una diapositiva como imagen, para que un agente pueda mirar antes de decir "listo".

El modelo de seguridad

Una aplicación de iWork dirá felizmente "guardado" sobre un archivo que acaba de romper. Nada aquí confía en "guardado".

backup → change a scratch copy → re-open it and compare → atomic swap
                       ↘ anything off: your file is untouched, the error says why

• Haz una copia de seguridad primero, versionada y privada: en ~/.iwork-studio/backups/ (o IWORK_STUDIO_BACKUP_DIR), nunca junto a tu archivo, para que las copias no llenen ni sincronicen tu iCloud Escritorio y Documentos. Se conservan las últimas 10 por archivo.
• Nunca a espaldas de la app: si el archivo está abierto en Numbers, Keynote o Pages, la escritura se rechaza. El siguiente guardado de la app sobrescribiría silenciosamente el cambio.
• Relectura y comparación: exactamente el cambio solicitado ocurrió, y nada más. Una edición de celda lee la celda editada y verifica todas las demás. Una inserción de fila verifica cada celda en su nueva posición. Una operación de diapositiva verifica todas las demás diapositivas. Una ordenación verifica que sea una reorganización pura, y se rechaza de antemano cuando las fórmulas de la tabla leen otras filas (la propia ordenación de Numbers las rompería). En archivos con gráficos, cada gráfico se cuenta antes y después; en presentaciones con tablas, se comparan las celdas de cada tabla. Una exportación se relee con una segunda herramienta independiente.
• Intercambio atómico: el archivo se reemplaza en un solo paso, por lo que un fallo no puede dejar medio archivo.
• El "ok" de la app nunca se confía. Las escrituras impulsadas por la app se releen del disco, y una escritura que "tuvo éxito" pero no se aplicó se revierte.
• Deshacer es una llamada: iwork_list_backups → iwork_restore_backup. La restauración hace una copia de seguridad de la versión actual primero, para que deshacer también se pueda deshacer.
• Vista previa primero: cada escritura que cambia un documento existente toma dry_run=true (restaurar y exportar son las excepciones). Ejecuta el cambio real en una copia desechable, con todas las verificaciones, y muestra exactamente qué cambiaría. Tu archivo no se toca.
• Buscar y reemplazar conserva el formato: en Pages, solo se reescriben los párrafos que contienen el texto.
• Los archivos nuevos nunca sobrescriben uno existente.
• Rechazar, no mutilar. El peor caso es un "no" claro, nunca un archivo roto.

Árabe y RTL

• El texto árabe viaja de ida y vuelta exactamente en las tres apps, incluyendo notas del presentador, marcadores de posición de Pages y celdas de tabla de Pages.
• La dirección del párrafo se verifica en Pages. Un reemplazo que cambia un párrafo de derecha a izquierda a izquierda a derecha se revierte. Pages escribe nuevos párrafos de izquierda a derecha, incluso los árabes, y los scripts no pueden cambiar eso, por lo que se marcan: establece la dirección en Pages (Formato › Texto).
• Los valores se mantienen como se escribieron: dígitos arábigo-indios (١٢٣), "$1,234.56" y =… el texto sigue siendo texto. Pasa un número real cuando quieras un número.
• Al verificar un PDF renderizado, afirma una palabra árabe. Las capas de texto de PDF reordenan texto RTL de múltiples palabras.

Las 65 herramientas

Las escrituras se marcan como destructivas y las lecturas como solo lectura, para que los clientes puedan preguntar antes de escribir. Cada escritura que cambia un archivo existente toma dry_run=true para una vista previa. Cada herramienta tiene un título, cada parámetro una descripción, y cada herramienta dice cuándo usarla en lugar de sus hermanas. ¿Necesitas menos? Carga solo algunos conjuntos de herramientas (ver Cargar menos en Instalar).

Las herramientas de diapositiva, tema, transición e imagen de Keynote rechazan una presentación abierta en Keynote (nunca cierran una ventana que pueda contener trabajo sin guardar). Para ocultarlas todas: IWORK_STUDIO_DISABLE_SLIDE_OPS=1.

Prompts. Los clientes que muestran prompts de MCP obtienen cuatro flujos de trabajo listos: Presentación de pitch desde un esquema, Presentación de informe desde una tabla de Numbers, Reestilizar con mi marca y Hacer que esta tabla se vea diseñada. Cada uno escribe a las reglas de diseño, construye en una llamada, muestra vista previa antes de reestilizar, y ejecuta la revisión de diseño antes de dar el trabajo por terminado.

Para agentes de IA

• AGENTS.md: reglas de configuración y uso para cualquier agente (Codex, Cursor, Copilot, Gemini; Claude Code lo lee vía CLAUDE.md).
• Instrucciones de MCP: el servidor envía sus reglas al conectarse, para que el modelo las tenga incluso sin este repositorio.
• Skill: skill-pack/SKILL.md, auto-descubierto por Claude Code en este repositorio, o bash skill-pack/install.sh para otros agentes basados en skills. Incluye scripts CLI con salida JSON para agentes sin MCP.
• llms.txt: un resumen corto legible por máquina.

El contrato: JSON entra, JSON sale. Los errores están tipados y dicen qué decirle al usuario: ChartRefusalError, DocumentOpenError, PagesOutOfScopeError, AquaSessionError (no hay GUI de Mac aquí) y así sucesivamente. No reintentes una escritura rechazada con un truco.

Python

pip install iwork-studio      # Python 3.12

from iwork_studio import numbers_structure, numbers_format, numbers_io, keynote_io, keynote_slides, exporter, backups

from iwork_studio import keynote_deck, design, review

keynote_deck.build_deck("pitch.key", [{"title": "شمس", "body": "Clean energy for every home"},
                                      {"title": "Why now", "body": ["Trust", "Access"]},
                                      {"title": "Riyadh leads growth", "chart": {"type": "bar", "from": "sales.numbers"}}],
                        kit="midnight")                                  # macOS + Keynote
review.review_deck("pitch.key")["findings"]                              # macOS + Keynote
design.extract_kit("brand.numbers", name="Acme", save=True)
numbers_structure.import_csv("sales.csv", "sales.numbers")
design.apply_to_numbers("sales.numbers", "banking")
numbers_format.set_cell_style("sales.numbers", "A1:D1", bold=True, fill_color="#1A7F79", font_color="#FFFFFF")
numbers_format.set_number_format("sales.numbers", "B2:B99", "currency", currency_code="SAR", decimal_places=2)
numbers_io.edit_cell("sales.numbers", "B2", 2500)
keynote_io.edit_text("pitch.key", "2025", "2026")
keynote_slides.set_presenter_notes("pitch.key", 1, "ملاحظات")          # macOS + Keynote
exporter.export("pitch.key", "pptx")                                     # macOS + Keynote
backups.restore_backup("sales.numbers", backups.list_backups("sales.numbers")[0]["name"])

pure Python file parsers (headless, deterministic)  →  .numbers everything, .key text
the real app via AppleScript / JXA                   →  .key slides & theming, .pages text & tables, formulas, sort, export, render checks
MCP server · CLI scripts · skill                     →  thin wrappers over the same library and the same safety model

src/iwork_studio/   numbers_io · numbers_format · numbers_structure · keynote_io · keynote_slides · keynote_theme
                    keynote_deck · keynote_table · design · review · preview · pages_io · app_ops · exporter
                    helpers · format_check · render_verify · pdf · backups · apps · mcp_server
mcpb/               Claude Desktop extension manifest (scripts/build_mcpb.sh builds the .mcpb)
skill-pack/         SKILL.md · CLI scripts · references (capabilities, traps, pins); also the Claude Code plugin
.claude-plugin/     plugin marketplace (one plugin: skill-pack/)
tests/              headless suite (CI) · `pytest -m aqua` = live suite for a Mac with iWork
install.sh          one-line setup for the Claude desktop app

Contribuyendo

git clone https://github.com/Arkanji/iwork-studio.git && cd iwork-studio
uv run --extra test pytest -m "not aqua"      # headless suite, what CI runs
uv run --extra test pytest -m aqua            # live suite: a Mac with Numbers, Keynote and Pages
scripts/live.sh                               # the same, unattended: logs to ~/.iwork-studio/probes, quits the apps it opened

iWork cambia entre versiones. Si algo se rompe, revisa las capacidades y trampas, ejecuta la suite en vivo y fija qué cambió. Las nuevas rutas de escritura deben seguir el modelo de seguridad y venir con pruebas que demuestren la reversión. Clona fuera de carpetas sincronizadas con iCloud.

Licencia

MIT, trampas incluidas. Tómalas.