Skip to content

Pages Native 0.5.0

Latest

Choose a tag to compare

@viames viames released this 20 Oct 07:17

Pages Native 0.5.0 adds structured search, guided native models with typed table fields, reusable recipes, batch generation and complete history from the available recipe state. Native .pages remains the editing format; all document operations use Apple's public scripting API.

  • 36 MCP tools and two Codex setup/use skills, with a bundled Node.js runtime requiring no user-side npm installation.
  • Batch generation: preview all 1–10 records before creating sequential new outputs; per-item results, default stop-on-error, optional continuation after ordinary errors, and no automatic retries. Uncertain native state always stops.
  • Recipe history: retain definitions and deduplicated opaque saved model copies, compare revisions, compose from a historical model and restore as a new current revision. Deleting the current recipe retains history. Pre-0.5 versions or model bytes that were already lost cannot be recovered.
  • Typed model fields: explicit numbers, dates, formulas, literal strings and deliberate optional clears, with compatible native base formats preserved. Pages boolean/checkbox writes are rejected before mutation because the app coerces or rejects them.
  • Stronger preview/revision checks: text/cell formatting, tables, objects and facing pages recheck exposed state before writing. Lightweight document discovery avoids unnecessary pagination.

Migration from 0.1: mutation tools now default to preview. Review the plan, then apply the identical request with mode:"apply" and its expected_revision. A preview does not perform the edit. Back up the complete recipe library, including its hidden history; older plugin versions must not modify a managed 0.5 library.

Validation: 70 portable tests passed; 76 native checks passed on one Mac with macOS 27.0.1, Pages 14.5 and Node.js 24.19.0. The actual installed MCP stdio server separately passed historical batch generation, restoration, currency/formulas, source preservation and saved reopen, with calculated totals 265 and 115. Native PDF/PNG output was visually inspected. Exact code fingerprints are in the verification documentation. Other Pages/macOS environments remain unverified.

Requirements: logged-in macOS desktop, Apple Pages, Node.js 22+ and Automation permission. No Accessibility, clipboard automation, private Pages parser or Word editing backend. Named paragraph styles cannot be assigned through the public API used here; font/size/color formatting is distinct, and semantic style preservation during model filling is not certified. Comments, tracked changes and chart series/type/title remain excluded. Native edits and batches are not transactions; inspect partial failures.

Install/update the free Codex marketplace plugin, then start a new local chat:

codex plugin marketplace add viames/pages-native
codex plugin add pages-native@viames-pages

Assets include the Codex marketplace ZIP, standalone plugin ZIP, MCPB, official registry metadata and SHA256SUMS. Author: Viames Marino. License: MIT. Independent of Apple and OpenAI.