NomaDamas/slides-grab

slides-grab is a command-line tool that helps you create, edit, and export presentation slides as HTML files. It's designed to work hand-in-hand with AI coding agents (like Claude or Codex) so you can describe changes in plain language and have the agent modify the slide HTML directly.

What it does:

• Generates slide decks from a simple outline, with each slide as a self-contained HTML file.
• Provides a visual editor (slides-grab edit) where you can click and drag to select elements and ask an AI to restyle or rewrite them.
• Exports slides to PDF, PNG images, or PowerPoint (PPTX) — the PPTX export is experimental.
• Includes a library of 95 design styles and templates, and can import your own existing decks as style references.
• Can generate images for slides using AI (default uses your Codex login, no extra API key needed) or via OpenAI/Google providers.
• Supports special workflows like square 1:1 "card news" slides for Instagram, and can render tldraw diagrams into SVG assets.

How it works:

• You run commands like slides-grab edit or slides-grab pdf with a --slides-dir pointing to your deck folder.
• The tool reads/writes HTML slide files and uses Playwright (a browser automation library) to render and export them.
• For AI image generation, it calls an internal service (codex-imagen) that reuses your existing Codex login — no separate API key needed.
• The project ships as an npm package and also includes "agent skills" that let Claude or Codex understand the workflow directly.

Why it's useful:

• It bridges the gap between AI agents and visual design: you can iterate on slides by pointing at a specific element and asking the agent to change it.
• Everything is plain HTML/CSS, so it's easy to version-control and edit by hand if needed.
• The tool handles the tedious parts (rendering, exporting, image generation) so you can focus on content.

Note: The PPTX and Figma export paths are marked as experimental/unstable — expect layout shifts and manual cleanup. The project is MIT-licensed and built on top of an earlier tool called ppt_team_agent.

For full details, see the README.