pages-cli

pages-cli

Claude Code plugin for full programmatic control over Apple Pages. Create, edit, format, and export Pages documents using slash commands, CLI, or natural language.

Covers 100% of the Pages AppleScript API — every command, class, property, and enum from the Pages scripting definition (sdef).

Features

• Documents — create (100+ templates incl. custom), open, close, save, password protect
• Text — add, replace, style per paragraph/word/character (font, size, color, bold, italic)
• Tables — create, fill, formulas, cell formatting, range styling (alignment, colors, wrap), merge/unmerge/sort/clear, row height, column width, header/footer rows & columns
• Media — images (with alt text), shapes (with text), text boxes, audio clips, movies, lines, groups — rotation, opacity, reflection, lock, position, size
• Export — PDF, Word, EPUB, plain text, RTF, Pages 09 — with password, image quality, comments, annotations, full EPUB metadata
• Templates — list all (incl. custom), create from template, placeholder filling
• Sections & Pages — multi-section/page body text access
• Session — state tracking, history, REPL with prompt_toolkit
• JSON output — --json flag on all commands for agent integration

Requirements

• macOS with Apple Pages (pre-installed or App Store)
• Python 3.10+
• Claude Code CLI (for plugin usage)

Installation

Via Claude Code

claude plugins marketplace add marcelrgberger/pages-cli
claude plugins install pages-cli

The CLI backend installs automatically on first /pages use.

Manual

git clone https://github.com/marcelrgberger/pages-cli.git
cd pages-cli/agent-harness
python3 -m venv .venv && source .venv/bin/activate
pip install -e .

Quick Start

/pages new Professional Report     Create from template
/pages open ~/doc.pages            Open existing document
/pages export pdf ~/Desktop/out.pdf Export as PDF
/pages templates                   Browse 100+ templates

After opening a document, use natural language:

User: Write a title "Q1 Report" in 24pt bold, then add 3 paragraphs about revenue
User: Add a 5x3 table with headers Name, Amount, Date
User: Set the header row background to blue
User: Export as PDF and Word to the Desktop

Command Reference

Document

Command	Description
document new [--template T] [--name N]	Create document
document open <path>	Open .pages file
document close [--no-save]	Close document
document save [--path P]	Save document
document info	Name, pages, words, characters
document list	List open documents
document set-password <pw> [--hint H]	Password protect
document remove-password <pw>	Remove password
document placeholders	List template placeholders
document set-placeholder <idx> <tag>	Set placeholder tag
document get-placeholder <idx>	Get placeholder tag
document sections	Section count
document section-text <idx>	Get section body text
document page-text <idx>	Get page body text
document delete <type> <idx>	Delete object on page

Text

Command	Description
text add <text>	Append text
text add-paragraph <text> [styling opts]	Add styled paragraph
text set <text>	Replace all body text
text get	Get body text
text set-font [--name F] [--size S] [--paragraph/--word/--char N]	Set font
text get-font [--paragraph/--word/--char N]	Get font name
text get-font-size [--paragraph/--word/--char N]	Get font size
text set-color --r R --g G --b B [--paragraph/--word/--char N]	Set color (0-65535)
text get-color [--paragraph/--word/--char N]	Get color
text bold [--paragraph/--word N]	Set bold
text italic [--paragraph/--word N]	Set italic
text bold-italic [--paragraph/--word N]	Set bold+italic
text style-paragraph <idx> [all styling opts]	Style paragraph
text style-word <idx> [all styling opts]	Style word
text style-character <idx> [all styling opts]	Style character
text word-count	Words, characters, paragraphs