pages

​

Usage

bunx @open-pencil/cli pages <file>

​

Arguments

​

Options

​

Examples

​

List pages

bunx @open-pencil/cli pages design.fig

3 pages

[PAGE] "Home" (0:1)
Nodes: 156

[PAGE] "Components" (0:2)
Nodes: 42

[PAGE] "Documentation" (0:3)
Nodes: 89

​

Get pages as JSON

bunx @open-pencil/cli pages design.fig --json

[
  {
    "id": "0:1",
    "name": "Home",
    "nodes": 156
  },
  {
    "id": "0:2",
    "name": "Components",
    "nodes": 42
  },
  {
    "id": "0:3",
    "name": "Documentation",
    "nodes": 89
  }
]

​

Output format

• Page type and name: [PAGE] "Page Name"
• Page ID: (0:1)
• Node count: Total number of nodes in the page (including nested children)

​

Node counting

• All direct children of the page
• All nested descendants (frames, groups, shapes, text, etc.)
• Does not include the page node itself

Nodes: 12

​

Use cases

• Project overview: Get a quick summary of page structure
• Size analysis: Identify pages with many nodes that might need optimization
• Navigation: Find page IDs for use with other commands
• Automation: Use --json output in scripts to process pages programmatically

​

Combining with other commands

# First, get page IDs
bunx @open-pencil/cli pages design.fig

# Then view a specific page tree (when --page flag is available)
bunx @open-pencil/cli tree design.fig --page "0:2"

​

See also

• tree - View node hierarchy
• info - Document-level information
• find - Search for specific nodes