CLI Commands¶

Power CLI provides commands for creating and manipulating PowerPoint presentations, both locally and via cloud API.

Command Overview¶

Command	Description
`power create`	Create a new presentation with a title slide
`power generate`	Generate presentation from YAML/JSON specification
`power inspect`	Inspect template layouts and placeholders
`power new`	Interactive presentation builder
`power add`	Add a slide to an existing presentation
`power remove`	Remove a slide by index
`power replace`	Replace `{{PLACEHOLDER}}` text
`power cloud`	Generate presentations via cloud API

Global Options¶

All commands support these options:

Option	Description
`-h`, `--help`	Show help message and exit
`--version`	Show version (main command only)

Getting Help¶

Get help for any command:

# Main help
power --help
power -h

# Command-specific help
power create --help
power generate -h

Common Patterns¶

Using Templates¶

Most commands support the -t or --template option:

power create output.pptx -t Galaxy.pptx --title "My Deck"
power generate slides.yaml -o output.pptx -t Galaxy.pptx
power new -t Galaxy.pptx

Output Files¶

Commands that create or modify presentations use -o or --output:

power generate slides.yaml -o presentation.pptx
power add deck.pptx -o updated.pptx --title "New Slide"
power remove deck.pptx 0 -o trimmed.pptx
power replace template.pptx NAME=John -o filled.pptx

Chaining Commands¶

Combine commands for complex workflows:

# Create, then add slides
power create deck.pptx -t Galaxy.pptx --title "Report"
power add deck.pptx -o deck.pptx --title "Slide 2" --bullets "Point 1"
power add deck.pptx -o deck.pptx --title "Slide 3" --bullets "Point 2"

Exit Codes¶

Code	Meaning
0	Success
1	Error (file not found, invalid input, etc.)

Environment Variables¶

Variable	Description
`POWER_API_URL`	Override the default cloud API URL for `power cloud` commands

Example:

export POWER_API_URL=http://localhost:8080
power cloud health