PowerPoint CLI

For installation and requirements, see README.md.

Batch Mode (recommended)

The server is stateful — create a presentation, then build it up, then save. Use the batch runner to execute multiple commands in a single session:

echo '<json>' | bun ~/.pi/agent/skills/powerpoint/powerpoint-batch.ts
bun ~/.pi/agent/skills/powerpoint/powerpoint-batch.ts recipe.json
bun ~/.pi/agent/skills/powerpoint/powerpoint-batch.ts --recipe '<json>'

Input format — a JSON object with a

commands

array:

{
  "commands": [
    { "tool": "create_presentation" },
    { "tool": "add_slide", "args": { "title": "Hello World" } },
    { "tool": "manage_text", "args": { "slide_index": 0, "operation": "add", "left": 1, "top": 2, "width": 8, "height": 1, "text": "Body text", "font_size": 18 } },
    { "tool": "save_presentation", "args": { "file_path": "./output.pptx" } }
  ]
}

Output: JSON array of

{ tool, result }

objects (or

{ tool, error }

on failure).

The batch runner auto-injects

presentation_id

into all commands after

create_presentation

/

open_presentation

, so you don't need to track it yourself.

Single-Command Mode

For one-off read operations, use the single-command CLI:

bun ~/.pi/agent/skills/powerpoint/powerpoint-cli.js <command> [flags]
bun ~/.pi/agent/skills/powerpoint/powerpoint-cli.js --help

Useful for inspection commands that don't need state:

bun <cli> list-slide-templates
bun <cli> get-template-info --template-id title_slide
bun <cli> get-server-info

Available Tools

Lifecycle

• create_presentation

  — create empty presentation

• create_presentation_from_template

  — create from .pptx template:

  { "template_path": "./template.pptx" }

• open_presentation

  — open existing file:

  { "file_path": "./deck.pptx" }

• save_presentation

  — save to file:

  { "file_path": "./output.pptx" }

• get_presentation_info

  — slide count, dimensions, properties

• set_core_properties

  — set title, author, keywords, etc.

Slides

• add_slide

  — add a slide:

  { "layout_index": 1, "title": "Slide Title" }

  • layout_index: 0=Title, 1=Title+Content, 2=Section, 5=Blank, etc.
  • Optional:

    background_type

    ("solid"/"gradient"),

    background_colors

    ,

    color_scheme

• get_slide_info

  — shapes, layout info:

  { "slide_index": 0 }

• extract_slide_text

  — all text from a slide:

  { "slide_index": 0 }

• extract_presentation_text

  — all text from all slides

Text Content

• populate_placeholder

  — fill a layout placeholder:

  { "slide_index": 0, "placeholder_idx": 1, "text": "Hello" }

• add_bullet_points

  — bullets in a placeholder:

  { "slide_index": 0, "placeholder_idx": 1, "bullet_points": ["A", "B", "C"] }

• manage_text

  — add/format text boxes:

  { "slide_index": 0, "operation": "add", "left": 1, "top": 2, "width": 8, "height": 1, "text": "Hello", "font_size": 24, "bold": true, "color": [0, 0, 0] }
  

  Operations:

  add

  ,

  format

  ,

  validate

  ,

  format_runs

Images

• manage_image

  — add/enhance images:

  { "slide_index": 0, "operation": "add", "image_source": "./photo.png", "left": 1, "top": 2, "width": 4, "height": 3 }
  

  source_type

  : "file" (default), "url", "base64"

Tables

• add_table

  — add a data table:

  { "slide_index": 0, "rows": 3, "cols": 4, "left": 1, "top": 2, "width": 8, "height": 3, "data": [["H1","H2","H3","H4"],["a","b","c","d"],["e","f","g","h"]] }
  

• format_table_cell

  — style a cell:

  { "slide_index": 0, "shape_index": 0, "row": 0, "col": 0, "bold": true, "bg_color": [68, 114, 196] }

Charts

• add_chart

  :

  { "slide_index": 0, "chart_type": "bar", "left": 1, "top": 2, "width": 8, "height": 4, "categories": ["Q1","Q2","Q3"], "series_names": ["Revenue"], "series_values": [[100, 200, 300]] }
  

  Note:

  series_values

  is an array of arrays (one inner array per series). Chart types:

  bar

  ,

  column

  ,

  line

  ,

  pie

  ,

  scatter

  ,

  area

  ,

  doughnut

• update_chart_data

  — replace data on existing chart

Shapes & Connectors

• add_shape

  :

  { "slide_index": 0, "shape_type": "rectangle", "left": 1, "top": 1, "width": 3, "height": 2, "fill_color": "4472C4", "text": "Box" }
  

  Types:

  rectangle

  ,

  rounded_rectangle

  ,

  oval

  ,

  triangle

  ,

  diamond

  ,

  arrow_right

  , etc.

• add_connector

  — lines/arrows between points:

  { "slide_index": 0, "connector_type": "straight", "start_x": 2, "start_y": 3, "end_x": 6, "end_y": 3 }
  

Design & Styling

• apply_professional_design

  — apply themes:

  { "operation": "apply_theme", "color_scheme": "modern_blue" }

  • Operations:

    apply_theme

    ,

    design_slide

    ,

    enhance_slide

• apply_picture_effects

  — shadow, reflection, etc.

• optimize_slide_text

  — auto-resize fonts:

  { "slide_index": 0 }

• manage_fonts

  — analyze/optimize:

  { "operation": "analyze", "font_path": "./deck.pptx" }

Templates

• list_slide_templates

  — list available layout templates

• get_template_info

  — details about a template:

  { "template_id": "title_slide" }

• apply_slide_template

  — apply template to existing slide

• create_slide_from_template

  — new slide from template

• create_presentation_from_templates

  — full deck from template sequence

• auto_generate_presentation

  — auto-generate from topic:

  { "topic": "Q4 Results", "slide_count": 8, "presentation_type": "business", "color_scheme": "modern_blue" }
  

Other

• manage_hyperlinks

  — add/remove/list links

• manage_slide_transitions

  — set/remove transitions

• manage_slide_masters

  — inspect master layouts

Reference

• Positions (

  left

  ,

  top

  ) and sizes (

  width

  ,

  height

  ) are in inches. Standard slide is 10×7.5.
• Slide indices are 0-based.
• Colors: hex RGB without

  #

  for shape fills (e.g.,

  "4472C4"

  ), RGB arrays

  [r, g, b]

  for text/cell colors.
• Color schemes:

  modern_blue

  ,

  corporate_gray

  ,

  elegant_green

  ,

  warm_red

  .
• Tool names accept both

  snake_case

  and

  kebab-case

  .