CLI essentials

Pentool makes small, explicit operations easy for people, scripts, and agents.

Files and rendering

pentool new logo.pen --width 1200 --height 800
pentool info logo.pen
pentool export logo.pen logo.png --scale 2
pentool export logo.pen logo.svg

Find before you edit

pentool tree artwork.pen
pentool search artwork.pen composer
pentool search artwork.pen "Open desktop app" --kind text

Targeted edits

pentool object artwork.pen set composer --layer ui --fill "#1c1c1c"
pentool object artwork.pen rename composer --layer ui --new-id prompt-box
pentool object artwork.pen duplicate prompt-box --layer ui --new-id prompt-copy

Mutations preserve unspecified properties and create numbered recovery snapshots. Use --dry-run and revisions for all-or-nothing automation.