Codex Slides

Community

The open-source AI slide studio that lives inside Codex

★ 881 Stars Category · Dev Tools Very popular

67FMRS · C

Codex Slides brings the entire slide-production chain into Codex: browser-first, fully visible, and durable on disk. It runs on your existing codex login with zero extra API keys, exposes 38 typed MCP tools plus an equivalent Node CLI, and ships 45 templates, 73 community styles, and 24 guided scenarios; Fast mode parallelizes rendering to land a 10+ slide deck in about 4–5 minutes. The main limitations are that exported PPTX slides are full-slide images rather than editable shapes, and live collaboration has not shipped yet. It suits Codex-heavy users who value visual fidelity and local data ownership.

Reliability

11/20

Security and permissions

12/20

Maintenance

14/20

Documentation

17/20

Setup experience

13/20

Read the FMRS scoring method →

Codex Slides is an open-source slide studio built for coding agents, running inside Codex with a browser-first workspace. It drives the whole chain live and steerable — research, outline, style, render, edit, present, and export to PDF/PPTX. Every slide is image-native: composed as a full visual canvas. Fast mode renders every page in parallel, so a 10+ slide deck lands in roughly 4–5 minutes. It ships 45 curated deck templates, 73 community styles, and 24 guided scenarios, runs on your existing codex login with zero extra API keys, and keeps every project on your own disk. The repository exposes two equivalent automation transports: a portable Node CLI at skills/codex-slides/scripts/codex-slides.mjs and a typed MCP server at mcp/server.mjs with 38 tools, including durable run start/status/wait/cancel.

Tools

open_codex_slides

Open the Codex Slides interface in the Codex Browser

start_project

Create a new durable project from a topic and page count

get_capabilities

List the available capabilities of the CLI/MCP surface

list_projects

List local projects

get_project

Get details of a specific project

start_project_run

Start a durable project run

get_project_run

Check the status of a project run

wait_project_run

Wait for a project run to finish

cancel_project_run

Cancel a project run

list_scenarios

List the 24 guided scenarios

upload_material

Upload source material into a project

list_design_files

List the project's Design Files

read_design_file

Read a Design File's contents

write_design_file

Write or modify a Design File

upload_design_file

Upload a Design File

list_templates

List built-in deck templates

list_project_templates

List reusable project templates

save_project_as_template

Save the current project as a reusable visual-system template

delete_project_template

Delete a project template

get_onboarding_questions

Get tailored clarification questions for the brief

deep_research

Run multi-round web research and produce an editable Markdown brief

create_outline

Create a presentation outline from the brief

revise_outline

Revise the outline based on feedback

rank_inspiration

Rank community styles against the topic and outline

get_brand_design_system

Read the project's Brand & Design System settings

update_brand_design_system

Update brand identity, palette, typography, imagery, and spacing rules

create_deck

Create a full deck in one call (unattended fast path)

render_deck

Render the deck's slides

edit_deck

Edit slides through conversational instructions

restyle_deck

Redraw the whole deck in a new visual direction

manage_slide

Add, duplicate, move, delete slides, or set transitions

regenerate_slide

Regenerate a specific slide

upload_slide_image

Upload a slide image

mark_edit_slide

Regenerate a slide from on-canvas marks, labels, and comments

export_deck

Export to PPTX or PDF with speaker notes preserved

get_speaker_notes

Get speaker notes

update_speaker_notes

Update speaker notes

generate_speaker_notes

Generate speaker notes automatically

Setup

Ensure you have Codex with plugin support, Node.js 20 or newer, and an account authenticated once with codex login.
Install from the GitHub marketplace:

codex plugin marketplace add nexu-io/codex-slides
codex plugin add codex-slides@codex-slides

Or install from a local checkout:

git clone https://github.com/nexu-io/codex-slides.git
cd codex-slides
codex plugin marketplace add "$PWD"
codex plugin add codex-slides@codex-slides

Restart Codex or the ChatGPT desktop app, then start a new task.
To update a Git-backed installation: codex plugin marketplace upgrade codex-slides, then remove and re-add the plugin, and restart Codex.
For local development run pnpm install then pnpm dev (Web + Desktop) or pnpm dev:web (Web only, default http://127.0.0.1:4311).

Fit and risk

Best for

Developers and teams already using Codex who want decks made inside their coding agent
Workflows that need image-native slides with high visual fidelity
Reports and launches that turn research, data, or documents into PPTX/PDF
Users who want project data on their own disk with no extra API keys

Not for

Users who need individually editable PowerPoint shapes and text boxes (export is currently full-slide images)
Users on clients other than Codex, such as Claude Desktop (installation is a Codex plugin)
Users needing live collaboration or shareable read-only present links (not shipped)
Users needing video or animated slide export (still exploring)

Required permissions

Read and write the local project data directory (default <repo>/data, or the OS app-data directory for desktop builds)
Access the local HTTP service (default http://127.0.0.1:4311)
Network access for deep web research and image generation
Reuse existing codex login credentials for text, research, and image generation

Risks and side effects

Exported PPTX text is not editable because each slide is a full-slide image
Slide quality depends on the underlying models and prompts, so regeneration may be needed
Project data, uploaded sources, and generated images stay on disk and can contain sensitive material — do not commit them
Community-style previews keep their upstream licenses and attribution; the project's MIT license does not relicense them, so check source terms before redistributing
Downloaded desktop builds are not notarized, so macOS and Windows may require manual approval on first launch

Troubleshooting

Codex does not see the plugin: run codex plugin list to confirm codex-slides is enabled, reinstall after version or Skill changes, restart Codex, and start a new task (existing tasks may keep the old Skill snapshot).
The local app does not start: verify node --version is 20+, run pnpm install, pnpm build, pnpm start, and inspect the log at CODEX_SLIDES_LOG or the OS temp directory.
A browser tab shows stale slides: project pages poll the canonical project and refresh on focus; if an older build is open, restart the local server and reload both tabs, and check the API with curl http://127.0.0.1:4311/api/projects/<project-id>.
A project is stuck rendering: Codex Slides only resumes after 90 seconds without a disk heartbeat, so reopen the project — rendered pages are preserved and only pending or failed pages retry.
MCP auto-start issues: set CODEX_SLIDES_NO_AUTO_START=1 to disable auto-start, or point CODEX_SLIDES_URL at an existing service.

Use cases

Describe a deck in one prompt and get 10+ high-quality slides in about 4–5 minutes

Turn PDFs, spreadsheets, Markdown, or repo files into a presentation

Review and revise the outline and visual direction before anything renders

Draw arrows and comments on a slide in Mark mode and regenerate just that page

Save a project as a reusable template with its brand rules, base style, and reference renders

Drive deck creation headlessly through the typed MCP tools from Codex

Supported clients

CodexFull support

Related MCP servers

Compare with other MCP servers