NomaDamas/slides-grab

Best harness + editor + linter for generating slides in Claude Code / Codex - Claude Design Open Source Alternative

slides‑grab – AI‑augmented HTML slide editor

What it is – slides‑grab is a Node‑based CLI and browser editor that lets large‑language‑model agents (Claude, Codex, etc.) create, edit, and export presentation decks as self‑contained HTML + CSS files. Users can drag a bounding box over any part of a slide, ask an AI agent to rewrite the text, change styling, or replace an image, and the changes are applied directly in the HTML source. The tool then bundles the deck into PDF, experimental PPTX, or Figma‑compatible files.

Why it matters – Most AI slide generators output static HTML or images. slides‑grab bridges the gap between generation and iterative editing by exposing a visual selection interface that agents can act on, keeping the deck fully editable, searchable, and easy to re‑export.

Core features (as described in the README)

AI‑driven workflow – agents can plan an outline, design each slide as HTML, edit via bbox selection, and export.
Browser‑based visual editor – pure JavaScript editor with drag‑to‑select, inline text editing, and a button to invoke an agent rewrite.
Rich export options
- slides‑grab pdf – raster‑capture PDF (default) or searchable text PDF (--mode print).
- slides‑grab convert – experimental PPTX export (raster or text engine).
- slides‑grab figma – experimental PPTX formatted for import into Figma Slides.
- slides‑grab png – per‑slide PNGs, with a special card‑news 1:1 mode for Instagram‑style graphics.
Design style catalog – 95 bundled styles (30 from pptx-design‑styles, 5 native, 60 from design‑diversity). Users can list, preview, or ask an agent to pick a style.
Template & image‑native pipelines – import existing PPTX/HTML templates, or generate image‑first slides using the built‑in codex‑imagen provider (fallback to OpenAI or Gemini). Assets are stored locally under <slides‑dir>/assets/.
CLI utilities – edit, edit-image, validate (Playwright‑based), tldraw (convert tldraw diagrams to SVG), fetch-video (yt‑dlp download), plus helpers for installing shared Vercel agent skills.
Extensible – the editor is a single JavaScript file; new agents, designs, or commands can be added without rebuilding the whole project.

Quick start (from the README)

# Clone and install dependencies
git clone https://github.com/NomaDamas/slides-grab.git && cd slides-grab
npm ci && npx playwright install chromium   # required for validation

# Or install the npm package directly
npm install slides-grab
npx playwright install chromium
npx slides-grab install-skills --target all --scope user

The CLI then works on a folder of HTML slides (default slides/). Example workflow:

slides-grab edit               # open visual editor
slides-grab validate           # check HTML with Playwright
slides-grab pdf --output deck.pdf
slides-grab convert --output deck.pptx

Typical use cases

Rapid AI‑generated decks – ask Claude or Codex to produce a slide outline and HTML files, then tweak specific sections visually.
Design exploration – browse the 95 style gallery, pick a style on the fly, or let an agent suggest a custom look.
Image‑first storytelling – generate full‑slide images via slides‑grab image (default uses Codex’s private image backend) and edit them with edit-image.
Export to corporate formats – convert the HTML deck to PPTX for PowerPoint or to a Figma‑compatible PPTX for design hand‑off.
Social‑media cards – use the card‑news mode to produce square PNGs ready for Instagram or LinkedIn.

Installation notes

Requires Node ≥ 20.
Playwright is needed for the validate command (chromium binary installed via npx playwright install chromium).
Image generation defaults to the bundled codex‑imagen provider, which reuses a local Codex ChatGPT login (~/.codex/auth.json). Alternative providers (openai, nano‑banana/Gemini) can be selected with --provider and the appropriate API‑key environment variables.
The npm package includes the CLI and shared Vercel agent skills; cloning the repo is only necessary for development or custom extensions.

License & acknowledgments

Licensed under the MIT License.
Built on top of the ppt_team_agent project by Builder Josh (see acknowledgment in the README).

Bottom line – slides‑grab is a genuine open‑source tool that combines AI agents with an editable HTML slide format, giving users a loop of generation → visual selection → in‑place AI rewrite → multi‑format export.