iWork Studio

A maneira segura de deixar a IA editar seus arquivos Numbers, Keynote e Pages.

Apresentações desenhadas a partir dos seus dados e da sua marca, verificadas como renderizadas. Pronto para árabe.
Toda alteração é copiada, verificada e desfeita, e qualquer coisa arriscada é recusada, nunca adivinhada.

🛡️ Nunca danifica seu arquivo	🎨 Desenhado a partir dos seus dados	ع Árabe em primeiro lugar
Backup → altera uma cópia → relê e compara → troca atômica. Arquivos abertos são deixados em paz. Uma chamada desfaz qualquer alteração.	Transforme uma planilha em uma apresentação Keynote com slides de gráficos e tabelas no seu kit de marca e revise-a como renderizada.	Texto em árabe e da direita para a esquerda é preservado exatamente, em todos os apps e em todas as exportações.

Instalar · Experimente · Segurança · O que ele faz · Todas as ferramentas · Para agentes de IA · Registro de alterações

_{15 segundos: dados → apresentação desenhada → rollback seguro → árabe. Vídeo em HD}

_{▶ Assista ao filme com som (46s) · Leia a história do lançamento}

Instalação

É isso. O instalador configura uv se necessário, e o uv traz seu próprio Python.

• Cerque-o (recomendado): … | sh -s -- --roots ~/Documents ~/Desktop limita-o a essas pastas. Outros clientes: defina IWORK_STUDIO_ROOTS (separado por :).
• Carregue menos (opcional): só trabalha no Keynote? Defina IWORK_STUDIO_TOOLSETS=keynote,design (qualquer um de files, numbers, keynote, pages, design; padrão todos). Menos ferramentas mantêm a IA focada e o contexto pequeno. A extensão do Claude Desktop tem um campo Toolsets; no Claude Code: claude mcp add iwork-studio -e IWORK_STUDIO_TOOLSETS=keynote,design -- uvx --from iwork-studio@latest iwork-studio-mcp. Capacidades, leitura, busca, desfazer e a lista de kits sempre carregam.
• Primeira execução: o macOS pergunta uma vez se o Claude pode controlar Keynote / Pages / Numbers. Clique em OK. (Perdeu? Ajustes do Sistema → Privacidade e Segurança → Automação.)
• Verifique: pergunte "o que o iwork-studio pode fazer neste Mac?".
• Remover: uvx --from iwork-studio@latest iwork-studio-mcp uninstall

Agente de IA configurando isso para alguém? Escolha a linha do app deles, execute-a e depois chame iwork_capabilities. As regras para usar as ferramentas estão em AGENTS.md.

Basta pedir, em inglês ou árabe

Sem arquivo à mão? Peça "copie os exemplos do iWork Studio para minha Área de Trabalho e transforme sample-sales.numbers em uma apresentação de diretoria". Os exemplos são dados de vendas sintéticos com uma planilha em inglês e uma em árabe.

"Crie uma apresentação de pitch de 6 slides para uma startup de painéis solares no kit midnight, com notas do apresentador, e exporte para PowerPoint."

"Transforme sales.numbers em uma apresentação de diretoria: faça um gráfico dos trimestres, uma tabela das principais regiões, no nosso kit Acme."

"Pegue as fontes e cores de brand.key e salve-as como nosso kit Acme."

"Revise pitch.key e corrija qualquer coisa que transborde ou seja pequena demais para ler."

"Deixe budget.numbers profissional com o kit banking — e me mostre uma prévia primeiro."

"Transforme sales.csv em um arquivo Numbers, deixe o cabeçalho em negrito com preenchimento verde-azulado, mostre a coluna B como SAR com duas casas decimais e adicione uma linha de total."

"Em pitch.key, mude para o tema Gradient, deixe o título do slide 1 branco a 60 pt, adicione uma dissolução entre cada slide e coloque logo.png no último slide."

"Adicione um gráfico de barras da receita por trimestre para 2025 e 2026 no slide 4."

"Duplique o slide 3, mova o texto para a frente e adicione notas do apresentador: ملاحظات المتحدث"

"Preencha os campos Nome e Data em offer-letter.pages e exporte como PDF protegido por senha."

"Na tabela de invoice.pages, defina a quantidade em B3 como 12 e faça D9 ser o total de D2:D8."

"Encontre minhas apresentações Keynote desta semana e exporte cada uma para PowerPoint."

"Desfaça a última alteração em budget.numbers."

O que ele pode fazer

⚡ = funciona em qualquer lugar, sem precisar do app (Python puro). Todo o resto aciona o app real em um Mac com uma sessão iniciada, iWork clássico ou os apps Creator Studio.

Cada tipo de arquivo: pré-visualize qualquer alteração antes de fazê-la (dry_run), consulte metadados, pegue a miniatura da prévia, encontre arquivos com o Spotlight, verifique se uma palavra está visivelmente renderizada, verifique a fonte/tamanho/cor renderizada, liste backups e desfaça.

O que ele não fará

De propósito, para nunca quebrar um arquivo:

• Arquivos com gráficos são recusados pelas ferramentas que funcionam sem o app: a reescrita delas pode quebrar silenciosamente o vínculo de um gráfico com seus dados. As ferramentas que acionam o app (slides do Keynote, temas, transições, imagens; fórmulas e classificação do Numbers) funcionam neles e verificam se cada gráfico ainda está lá.
• Gráficos no Numbers e no Pages não são criados: eles não são confiavelmente scriptáveis, e recusamos em vez de clicar pelos menus do app e arriscar seu arquivo. Gráficos do Keynote podem ser adicionados. Para criar gráficos de dados classificados sem tocar em um gráfico do Numbers, classifique em uma nova tabela (numbers_sort com to_new_table) e crie um slide de gráfico do Keynote a partir dela.
• Pages é limitado a texto e tabelas existentes: substituir, definir corpo, espaços reservados e células de tabela. Novas tabelas não podem ser criadas (o Pages 15 não permite script), e documentos de layout de página, como a maioria dos modelos de carta, não têm texto de corpo. Não há analisador de formato de arquivo Pages em lugar nenhum, então ele não finge ter um.
• Fórmulas e deslocamentos de linha: em uma tabela com fórmulas, linhas e colunas só podem ser anexadas sem o app. Inserir no meio deixaria referências apontando para as células erradas.
• Não é scriptável pela Apple, então não é oferecido: estilos de tabela do Numbers, preenchimento de formas e alinhamento de texto do Keynote, excluir uma tabela do Keynote, editar os slides mestres de um tema. Margens de página e configuração de página estão planejadas.

Desenhado, não apenas editado

Seis kits de design transformam uma apresentação ou tabela simples em algo que você apresentaria: um par de fontes (latim + árabe, todos incluídos no macOS — nada para instalar), uma paleta contida verificada para contraste WCAG e uma escala tipográfica.

Construa com um (keynote_build_deck(..., kit="midnight")), reestilize qualquer coisa (keynote_apply_design, numbers_apply_design) ou traga sua marca como cores e fontes — o contraste é verificado. Os agentes também recebem um guia de design: uma ideia por slide, títulos que declaram a conclusão, números alinhados à direita, cor contida.

Sua marca, uma vez. Aponte iwork_extract_design_kit para uma apresentação ou tabela que já tenha seu visual: ele lê as fontes (latim e árabe) e as cores e as salva como um kit nomeado que você pode usar em qualquer lugar onde um kit seja usado. Ou salve suas cores e fontes diretamente com iwork_save_design_kit.

Números em slides. Um slide em keynote_build_deck pode carregar um gráfico ou uma tabela, a partir de dados ou direto de uma tabela Numbers: a linha de cabeçalho dá as colunas, a primeira coluna as linhas. As tabelas recebem a faixa de cabeçalho do kit, fontes, faixas e números alinhados à direita, e cada célula é lida de volta.

Ele verifica o próprio trabalho. keynote_review_deck renderiza a apresentação pelo Keynote e compara cada linha desenhada com sua caixa de texto: texto fora do slide ou além da caixa é um erro; texto que o Keynote teve que encolher para caber, caixas sobrepostas, texto abaixo de 18 pt e slides lotados são avisos. keynote_slide_image entrega um slide de volta como imagem, para que um agente possa olhar antes de dizer "pronto".

O modelo de segurança

Um app iWork dirá feliz "salvo" sobre um arquivo que acabou de quebrar. Nada aqui confia em "salvo".

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

• Faça backup primeiro, versionado e privado: em ~/.iwork-studio/backups/ (ou IWORK_STUDIO_BACKUP_DIR), nunca ao lado do seu arquivo, para que os backups não preencham ou sincronizem sua Área de Trabalho e Documentos do iCloud. Os últimos 10 por arquivo são mantidos.
• Nunca por trás do app: se o arquivo estiver aberto no Numbers, Keynote ou Pages, a gravação é recusada. O próximo salvamento do app sobrescreveria silenciosamente a alteração.
• Relido e comparado: exatamente a alteração solicitada aconteceu, e nada mais. Uma edição de célula lê a célula editada de volta e verifica todas as outras células. Uma inserção de linha verifica cada célula em sua nova posição. Uma operação de slide verifica todos os outros slides. Uma classificação verifica se é uma reordenação pura e recusa antecipadamente quando as fórmulas da tabela leem outras linhas (a própria classificação do Numbers as quebraria). Em arquivos com gráficos, cada gráfico é contado antes e depois; em apresentações com tabelas, as células de cada tabela são comparadas. Uma exportação é relida com uma segunda ferramenta independente.
• Troca atômica: o arquivo é substituído em uma única etapa, então uma falha não pode deixar meio arquivo.
• O "ok" do app nunca é confiável. Gravações conduzidas pelo app são relidas do disco, e uma gravação que "teve sucesso" mas não foi aplicada é revertida.
• Desfazer é uma chamada: iwork_list_backups → iwork_restore_backup. A restauração faz backup da versão atual primeiro, então o desfazer também pode ser desfeito.
• Pré-visualize primeiro: toda gravação que altera um documento existente usa dry_run=true (restauração e exportação são as exceções). Ela executa a alteração real em uma cópia descartável, com todas as verificações, e mostra exatamente o que mudaria. Seu arquivo não é tocado.
• Localizar e substituir mantém a formatação: no Pages, apenas os parágrafos que contêm o texto são reescritos.
• Arquivos novos nunca sobrescrevem um existente.
• Recuse, não estrague. O pior caso é um "não" claro, nunca um arquivo quebrado.

Árabe e RTL

• Texto em árabe faz ida e volta exatamente nos três apps, incluindo notas do apresentador, espaços reservados do Pages e células de tabela do Pages.
• A direção do parágrafo é verificada no Pages. Uma substituição que inverte um parágrafo da direita para a esquerda para esquerda para a direita é revertida. O Pages escreve novos parágrafos da esquerda para a direita, mesmo os árabes, e scripts não podem mudar isso, então eles são sinalizados: defina a direção no Pages (Formato › Texto).
• Os valores são mantidos como digitados: dígitos arábico-índicos (١٢٣), texto "$1,234.56" e =… permanecem texto. Passe um número real quando quiser um número.
• Ao verificar um PDF renderizado, afirme uma palavra em árabe. Camadas de texto de PDF reordenam texto RTL com várias palavras.

Todas as 65 ferramentas

Gravações são marcadas como destrutivas e leituras como somente leitura, para que clientes possam perguntar antes de gravar. Toda gravação que altera um arquivo existente usa dry_run=true para uma pré-visualização. Toda ferramenta tem um título, todo parâmetro tem uma descrição, e toda ferramenta diz quando usá-la em vez de suas irmãs. Precisa de menos? Carregue apenas alguns conjuntos de ferramentas (veja Carregar menos em Instalar).

Ferramentas de slide, tema, transição e imagem do Keynote recusam um deck aberto no Keynote (elas nunca fecham uma janela que possa conter trabalho não salvo). Para ocultá-las todas: IWORK_STUDIO_DISABLE_SLIDE_OPS=1.

Prompts. Clientes que mostram prompts MCP obtêm quatro fluxos de trabalho prontos: Pitch deck a partir de um esboço, Deck de relatório a partir de uma tabela do Numbers, Reestilizar com minha marca e Faça esta tabela parecer projetada. Cada um escreve nas regras de design, constrói em uma chamada, pré-visualiza antes de reestilizar e executa a revisão de design antes de considerar o trabalho concluído.

Para agentes de IA

• AGENTS.md: regras de configuração e uso para qualquer agente (Codex, Cursor, Copilot, Gemini; Claude Code lê via CLAUDE.md).
• Instruções MCP: o servidor envia suas regras na conexão, então o modelo as tem mesmo sem este repositório.
• Skill: skill-pack/SKILL.md, descoberta automaticamente pelo Claude Code neste repositório, ou bash skill-pack/install.sh para outros agentes baseados em skill. Inclui scripts CLI com saída JSON para agentes sem MCP.
• llms.txt: um resumo curto legível por máquina.

O contrato: JSON entra, JSON sai. Erros são tipados e dizem o que informar ao usuário: ChartRefusalError, DocumentOpenError, PagesOutOfScopeError, AquaSessionError (sem GUI Mac aqui) e assim por diante. Não tente novamente uma gravação recusada com um truque.

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

Contribuindo

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

O iWork muda entre versões. Se algo quebrar, verifique as capacidades e armadilhas, execute a suíte ao vivo e registre o que mudou. Novas rotas de gravação devem seguir o modelo de segurança e vir com testes que provem o rollback. Clone fora de pastas sincronizadas com iCloud.

Licença

MIT, armadilhas incluídas. Leve-as.