Add shapes and text boxes to a slide with text, fill, position, and styling.

Path: /slide[N] (parent)

Note: When a shape has fill=none, setting shadow, glow, reflection, or softedge applies the effect to text runs instead of shape-level properties.

Note: On morph slides, custom-named shapes automatically get the !! prefix.

Note: The first animation on a morph slide defaults to afterPrevious instead of onClick.

Format: EFFECT[-DIRECTION][-DURATION][-TRIGGER][-delay=N][-easein=N][-easeout=N] or none

Segments after the effect name are identified by content (not position):

• Direction: left, right, up, down
• Duration: milliseconds (default 400)
• Trigger: click (default for 1st), after (default for subsequent), with
• delay=N: Delay in ms
• easein=N: Ease-in percentage
• easeout=N: Ease-out percentage

Example: animation=flyIn-left-300-after-delay=200-easein=50

See Shape for the full categorized gallery (70+ presets). Common presets:

Basic: rect, roundRect, ellipse, diamond, triangle, rtTriangle, parallelogram, trapezoid, pentagon, hexagon, octagon, decagon, dodecagon

Stars: star4, star5, star6, star8, star10, star12, star16, star24, star32

Arrows: rightArrow, leftArrow, upArrow, downArrow, leftRightArrow, chevron, homePlate, notchedRightArrow, uturnArrow, circularArrow

Callouts: callout1, callout2, callout3, wedgeRoundRectCallout, wedgeEllipseCallout, cloudCallout

Flowchart: process, decision, terminator, document, io, data, predefinedprocess, preparation, manualinput, manualoperation, flowconnector, offpageconnector, multidocument, sort, merge, extract, delay, display, alternateprocess

Symbols: plus, heart, cloud, lightning, sun, moon, arc, donut, cube, can, line, ribbon, smiley, frame, gear6, gear9

# Simple text box
officecli add slides.pptx /slide[1] --type shape --prop text="Hello World" --prop x=2cm --prop y=3cm --prop width=10cm --prop height=5cm
# Styled shape with fill
officecli add slides.pptx /slide[1] --type shape --prop text="Important" --prop x=5cm --prop y=5cm --prop width=15cm --prop height=3cm --prop fill=4472C4 --prop color=FFFFFF --prop size=24 --prop bold=true --prop align=center
# Shape with gradient
officecli add slides.pptx /slide[1] --type shape --prop text="Gradient" --prop x=2cm --prop y=10cm --prop width=10cm --prop height=5cm --prop gradient=4472C4-1A1A2E
# Shape with custom gradient stops
officecli add slides.pptx /slide[1] --type shape --prop fill=none --prop "gradient=FF0000@0-00FF00@50-0000FF@100" --prop x=2cm --prop y=2cm --prop width=10cm --prop height=5cm
# Shape with animation (new format)
officecli add slides.pptx /slide[1] --type shape --prop text="Animated" --prop x=5cm --prop y=5cm --prop width=10cm --prop height=5cm --prop animation=flyIn-left-300-after-delay=200-easein=50
# Ellipse shape
officecli add slides.pptx /slide[1] --type shape --prop preset=ellipse --prop fill=FF6600 --prop x=15cm --prop y=5cm --prop width=5cm --prop height=5cm
# Bulleted list
officecli add slides.pptx /slide[1] --type shape --prop "text=Item 1\nItem 2\nItem 3" --prop list=bullet --prop x=2cm --prop y=5cm --prop width=20cm --prop height=8cm

PPT Add and Set for spatial elements return coordinate info and overlap warnings:

Added shape at /slide[1]/shape[3]
 x: 2cm y: 5cm width: 20cm height: 8cm

If a new or repositioned element has the same (x, y) as an existing sibling:

Added shape at /slide[1]/shape[3]
 x: 5cm y: 5cm width: 10cm height: 5cm
 WARNING: Same position as Title 1

This helps AI agents detect layout collisions and use distinct positions.

Typed add / set / remove also work on slide-master and slide-layout shape paths:

officecli add deck.pptx '/slideMaster[1]/shape' --type shape --prop geometry=rect --prop fill=4472C4
officecli set deck.pptx '/slideLayout[1]/shape[2]' --prop fill=none
officecli remove deck.pptx '/slideMaster[1]/shape[3]'

• arrow accepts as alias for rightArrow preset.
• Line corner attributes and arrowheads are emitted on Get even when PowerPoint's default-suppression would silently drop them, so dump → batch round-trips outline details.
• effective.X + effective.X.src keys surface for cascaded run/paragraph props (font, size, color, ...), making it explicit whether a value came from the run, paragraph, layout, or master.

Based on OfficeCLI v1.0.97