Skip to content
Back to search

codex-slides

SkillWorks with CodexGitHub

๐ŸŽจ Open-source AI slide studio inside Codex: image-native decks, every slide a full visual canvas. โšก 10+ high-quality slides in ~4โ€“5 minutes โ€” Fast mode renders every page in parallel. ๐Ÿ” Watch the whole chain live: research โ†’ outline โ†’ style โ†’ render โ†’ edit โ†’ present โ†’ export PDF/PPTX. ๐Ÿ–ฅ๏ธ Browser-first ยท zero API keys ยท durable projects.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nexu-io--codex-slides/badge.svg)](/listings/nexu-io--codex-slides)

HTML

<a href="/listings/nexu-io--codex-slides"><img src="/api/listings/nexu-io--codex-slides/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requirements

- [Codex](https://developers.openai.com/codex/) with plugin support - Node.js 20 or newer - A ChatGPT account authenticated once with `codex login` - Git

No separate OpenAI API key or `.env` file is required for the default Codex workflow.

Install from the GitHub marketplace

This repository includes a Codex marketplace manifest, so the repository itself can be added as a plugin source:

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

Restart Codex or the ChatGPT desktop app after installation, then start a new task. You can also open `/plugins` in Codex to inspect installed plugins.

To update a Git-backed installation:

codex plugin marketplace upgrade codex-slides
codex plugin remove codex-slides@codex-slides
codex plugin add codex-slides@codex-slides

Restart Codex after the update so the new Skill, MCP server, and interface metadata are loaded. See OpenAI's [local plugin installation documentation](https://learn.chatgpt.com/docs/build-plugins#install-a-local-plugin-manually) for the marketplace layout and reload behavior.

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

After changing plugin files locally, reinstall the plugin and start a new Codex task so cached Skills are refreshed.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md ยท README ยท 1,069 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="docs/assets/readme/hero.png" alt="Codex Slides โ€” the open-source AI slide studio inside your coding agent, operated in the Codex in-app Browser" width="960" />
  3. </p>
  4. <h1 align="center">Codex Slides</h1>
  5. <p align="center">
  6. <strong>The open-source AI slide studio that lives inside Codex.</strong><br />
  7. Turn a prompt, a repo, or a pile of files into a beautiful, presentation-ready deck โ€” without leaving your coding agent.
  8. </p>
  9. <p align="center">
  10. <strong>โšก 10+ high-quality slides in ~4โ€“5 minutes</strong> โ€” Fast mode renders every page in parallel, not one by one<br />
  11. 45 deck templates ยท 73 community styles ยท 24 guided scenarios โ†’ production-ready <strong>PPTX / PDF</strong> ยท Browser-first ยท zero separate API keys ยท web &amp; desktop
  12. </p>
  13. <p align="center">
  14. <a href="LICENSE"><img alt="MIT License" src="https://img.shields.io/badge/license-MIT-111827.svg" /></a>
  15. <img alt="Codex plugin" src="https://img.shields.io/badge/Codex-plugin-6D5EF8.svg" />
  16. <img alt="Next.js 14" src="https://img.shields.io/badge/Next.js-14-000000.svg" />
  17. <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-5-3178C6.svg" />
  18. <img alt="MCP" src="https://img.shields.io/badge/MCP-38_tools-6D5EF8.svg" />
  19. <img alt="Browser first" src="https://img.shields.io/badge/workflow-Browser--first-2563EB.svg" />
  20. </p>
  21. ---
  22. **Codex Slides is an open-source slide studio built for coding agents.** Describe a deck, point
  23. it at a repo or a folder of files, and watch your local Codex research, outline, style, render,
  24. and export a presentation โ€” every slide a full visual canvas, all of it visible and steerable,
  25. none of it a hidden background task.
  26. Think of it as the **open-source, agent-native alternative to Gamma and Tome** โ€” except it
  27. lives inside the coding agent you already use, runs on your existing `codex login` with zero
  28. extra API keys, and keeps every project on your own disk.
  29. **What you get, out of the box:**
  30. - **118 ready-made visual systems** โ€” **45 curated deck templates** across 15 professional
  31. categories, plus **73 community styles** across 12 groups (reports, infographics, diagrams,
  32. data & maps, dashboards, posters, product, brand, architecture, photography, editorial,
  33. illustration).
  34. - **24 guided scenarios** in 6 groups โ€” zero-to-one decks, source-to-slides, data stories,
  35. deep research, redesign, localization, training, keynotes, and more.
  36. - **โšก Fast mode** โ€” renders every page **in parallel** (not one-by-one), so a **10+ slide deck
  37. lands in ~4โ€“5 minutes** while the outline and visual direction stay locked.
  38. - **Production export** โ€” real, presentation-ready **PPTX** and print-ready **PDF** with
  39. speaker notes preserved; 1K/2K/4K render quality and five aspect ratios (16:9, 4:3, 1:1,
  40. 9:16, 3:4).
  41. - **Zero extra keys** โ€” runs on your existing `codex login`; every project stays on your disk.
  42. ```text
  43. Open Codex Slides in the Codex Browser and keep it visible.
  44. Create a 12-slide market deck about 2026 humanoid robotics.
  45. Let me confirm the questions, outline, and visual direction before rendering.
  46. ```
  47. ### Try it in 60 seconds
  48. ```bash
  49. codex plugin marketplace add nexu-io/codex-slides
  50. codex plugin add codex-slides@codex-slides
  51. ```
  52. Then start a new Codex task: *โ€œOpen Codex Slides and build me a 6-slide deck about โ€ฆโ€* โ€” and
  53. watch it happen live.
  54. > Like what you see? **[Give it a โญ](#star-codex-slides)** โ€” one click is the fastest way to
  55. > help the next developer find Codex Slides.
  56. > **Writing about Codex Slides?** Everything a creator or reporter needs โ€” boilerplate, stats,
  57. > comparisons, an FAQ, ready-to-post copy in English / ไธญๆ–‡ / ๆ—ฅๆœฌ่ชž, a video script, and an asset
  58. > manifest โ€” is in the **[Media & creator kit](docs/MEDIA_KIT.md)**. Paste it into your agent and
  59. > it can write the video or article for you.
  60. ## Contents
  61. - [Why Codex Slides](#why-codex-slides)
  62. - [How it works](#how-it-works)
  63. - [See it inside Codex](#see-it-inside-codex)
  64. - [Examples](#examples)
  65. - [Install in Codex](#install-in-codex)
  66. - [Create your first deck](#create-your-first-deck)
  67. - [Generate from files](#generate-from-files)
  68. - [Modify an existing deck](#modify-an-existing-deck)
  69. - [Features](#features)
  70. - [CLI and MCP](#cli-and-mcp)
  71. - [Local development](#local-development)
  72. - [Desktop development and releases](#desktop-development-and-releases)
  73. - [Roadmap](#roadmap)
  74. - [Community style library and licenses](#community-style-library-and-licenses)
  75. - [Architecture and data](#architecture-and-data)
  76. - [Verification](#verification)
  77. - [Troubleshooting](#troubleshooting)
  78. - [Media & creator kit](#media--creator-kit)
  79. - [Star Codex Slides](#star-codex-slides)
  80. - [Contributing](#contributing)
  81. - [License](#license)
  82. ## Why Codex Slides
  83. Most AI slide generators hide the process behind one request and return a file. Codex Slides
  84. treats the presentation as a persistent, inspectable project you own end to end.
  85. | Typical one-shot generator | Codex Slides in Codex |
  86. |---|---|
  87. | Wait for a hidden end-to-end task | Open the live product before work begins |
  88. | Discover problems after export | Confirm requirements, outline, and style first |
  89. | Restart when the result is wrong | Continue editing the same saved project |
  90. | Re-upload context every time | Keep Design Files and brand rules with the project |
  91. | Rebuild a successful visual direction | Save a project as a reusable visual-system template |
  92. | Describe visual bugs in prose | Mark directly on the slide |
  93. | Separate app and agent histories | Codex and the Browser operate one shared project |
  94. | Bring your own API keys and billing | Runs on your existing `codex login`, zero extra keys |
  95. Codex Slides is **image-native**: each slide is composed as a full visual canvas. That makes
  96. it strong for visual fidelity and rapid iteration. Exported PPTX files contain full-slide
  97. images rather than individually editable PowerPoint shapes.
  98. ## How it works
  99. Codex Slides keeps the entire chain live and steerable โ€” from a rough idea to a finished,
  100. exportable deck.
  101. <p align="center">
  102. <img src="docs/assets/readme/pipeline.png" alt="Research, Outline, Style, Render, Edit, Present, Export" width="880" />
  103. </p>
  104. ```text
  105. Codex conversation
  106. โ”‚
  107. โ–ผ
  108. Open the Codex Slides home in the Codex Browser
  109. โ”‚
  110. โ–ผ
  111. Create a durable project
  112. โ”‚
  113. โ”œโ”€โ”€ Clarify the brief
  114. โ”œโ”€โ”€ Optional source-backed research
  115. โ”œโ”€โ”€ Review and revise the outline
  116. โ”œโ”€โ”€ Choose a visual direction
  117. โ”œโ”€โ”€ Watch slides render progressively
  118. โ””โ”€โ”€ Review the finished canvas
  119. โ”‚
  120. โ”œโ”€โ”€ Chat edits and queued follow-ups
  121. โ”œโ”€โ”€ Add / duplicate / move / delete / transition
  122. โ”œโ”€โ”€ Mark-based slide edits
  123. โ”œโ”€โ”€ Design Files and @ references
  124. โ”œโ”€โ”€ Save as a reusable project template
  125. โ”œโ”€โ”€ Brand &amp; Design System
  126. โ”œโ”€โ”€ Play mode
  127. โ””โ”€โ”€ PDF / PPTX export
  128. ```
  129. Projects are written to disk throughout the workflow. Opening the same project from Codex and
  130. another browser stays synchronized; rendering pages refresh from the canonical project state,
  131. and interrupted generation can resume safely.
  132. ## See it inside Codex
  133. Everything happens in a live, Browser-first workspace โ€” not a black box. Start from a prompt,
  134. a proven visual direction, or a purpose-built workflow, then stay in the same durable project
  135. through questions, research, outline, generation, editing, presenting, and export.
  136. <p align="center">
  137. <img src="docs/assets/readme/01-home-community.png" alt="Codex Slides home with the prompt composer, scenario shortcuts, and Community Styles" width="920" />
  138. </p>
  139. <p align="center"><strong>1 ยท Start at Home</strong> โ€” describe what you want to make, attach source files, choose the engine and output settings, or jump into a guided workflow.</p>
  140. <table>
  141. <tr>
  142. <td width="50%"><img src="docs/assets/readme/02-community-styles.png" alt="Community Styles gallery with 73 visual directions" /></td>
  143. <td width="50%"><img src="docs/assets/readme/03-scenarios.png" alt="Scenario library with 24 presentation workflows" /></td>
  144. </tr>
  145. <tr>
  146. <td><strong>2 ยท Explore Community Styles</strong> โ€” browse 73 visual directions across reports, infographics, diagrams, data, UI, posters, products, brand systems, architecture, photography, editorial, and illustration.</td>
  147. <td><strong>3 ยท Pick a scenario</strong> โ€” choose from 24 configured workflows for zero-to-one decks, source-to-slides, data stories, research, redesign, localization, training, keynotes, and more.</td>
  148. </tr>
  149. <tr>
  150. <td colspan="2"><img src="docs/assets/readme/04-project-questions.png" alt="English clarification form inside a Codex Slides project" /></td>
  151. </tr>
  152. <tr>
  153. <td colspan="2"><strong>4 ยท Enter a durable project and clarify the brief</strong> โ€” confirm audience, page count, aspect ratio, language, resolution, and visual intent before the outline begins.</td>
  154. </tr>
  155. <tr>
  156. <td width="50%"><img src="docs/assets/readme/05-research-brief.png" alt="Source-backed English research brief in Design Files" /></td>
  157. <td width="50%"><img src="docs/assets/readme/05-research-outline.png" alt="Editable English presentation outline" /></td>
  158. </tr>
  159. <tr>
  160. <td><strong>5 ยท Research</strong> โ€” run optional multi-round web research, then keep the Markdown brief and sources inspectable inside Design Files.</td>
  161. <td><strong>6 ยท Shape the outline</strong> โ€” edit every title and talking point, add or remove slides, change the order, or ask the agent to revise the story.</td>
  162. </tr>
  163. <tr>
  164. <td width="50%"><img src="docs/assets/readme/06-visual-style.png" alt="Ranked visual direction picker inside a Codex Slides project" /></td>
  165. <td width="50%"><img src="docs/assets/readme/07-parallel-generation.png" alt="English slide generation with completed and pending pages visible" /></td>
  166. </tr>
  167. <tr>
  168. <td><strong>7 ยท Lock the visual direction</strong> โ€” Codex Slides ranks Community Styles against the topic and outline; choose one, search the full library, or keep the default.</td>
  169. <td><strong>8 ยท Generate progressively or in parallel</strong> โ€” watch completed slides land in the canvas while remaining pages stay visible and resumable. Fast mode fans pages out in parallel and queues overflow.</td>
  170. </tr>
  171. <tr>
  172. <td width="50%"><img src="docs/assets/readme/08-editor.png" alt="English slide editor with the complete 16:9 canvas contained in view, editing toolbar, speaker notes, and thumbnails" /></td>
  173. <td width="50%"><img src="docs/assets/readme/09-presenter-mode.png" alt="Audience playback and Presenter Mode menu with the complete slide visible behind it" /></td>
  174. </tr>
  175. <tr>
  176. <td><strong>9 ยท Edit in place</strong> โ€” keep the complete slide in frame while you ask AI, mark a region, rewrite or redraw a page, add and reorder slides, set transitions, replace images, and prepare speaker notes.</td>
  177. <td><strong>10 ยท Present</strong> โ€” start audience playback from any slide, or use Presenter Mode with a synchronized audience window, notes, navigation, and timer.</td>
  178. </tr>
  179. <tr>
  180. <td colspan="2"><img src="docs/assets/readme/10-export.png" alt="English PDF and PowerPoint export menu above a fully contained 16:9 slide" /></td>
  181. </tr>
  182. <tr>
  183. <td colspan="2"><strong>11 ยท Export</strong> โ€” download a production-ready PowerPoint file or a print-ready PDF, with the project's speaker notes preserved.</td>
  184. </tr>
  185. </table>
  186. ## Examples
  187. Every card below is a real **visual system that ships with Codex Slides**, paired with the exact
  188. prompt that turns it into a finished deck. Each prompt opens a **durable project**, stops for
  189. outline and visual-direction approval, then renders in the Browser where you watch it happen โ€”
  190. swap in your own topic, audience, or files and go.
  191. <table>
  192. <tr>
  193. <td width="50%">
  194. <img src="docs/assets/readme/case-market-report.png" alt="Business and market report deck" width="100%" /><br />
  195. <strong>Business &amp; market report</strong> โ€” charts, KPI callouts, and a tidy consulting-grade grid.
  196. <details><summary>๐Ÿ“‹ Copy the prompt</summary>
  197. <pre>Open Codex Slides in the Codex Browser and build a 12-slide market
  198. report on the 2026 humanoid-robotics market โ€” size, CAGR, average
  199. selling price, and key takeaways โ€” in a consulting-grade chart-and-KPI
  200. grid. Research first, then stop at the outline before rendering.</pre>
  201. </details>
  202. </td>
  203. <td width="50%">
  204. <img src="docs/assets/readme/case-data.png" alt="Data visualization dashboard deck" width="100%" /><br />
  205. <strong>Data &amp; dashboards</strong> โ€” maps, donut and trend charts, and metric tiles.
  206. <details><summary>๐Ÿ“‹ Copy the prompt</summary>
  207. <pre>Open Codex Slides and turn the attached dataset into a data dashboard
  208. on global EV-charging infrastructure โ€” a world map of charging points,
  209. a regional donut, a growth trend line, and metric tiles. Analytical and
  210. dense. Confirm the outline first.</pre>
  211. </details>
  212. </td>
  213. </tr>
  214. <tr>
  215. <td width="50%">
  216. <img src="docs/assets/readme/case-keynote.png" alt="Product keynote deck" width="100%" /><br />
  217. <strong>Product keynote</strong> โ€” cinematic, high-contrast title moments for launches.
  218. <details><summary>๐Ÿ“‹ Copy the prompt</summary>
  219. <pre>Open Codex Slides and create a cinematic product keynote โ€” big
  220. high-contrast title moments, near-black slides with one glowing product
  221. hero and a single bold line per page. 16:9 at 4K. Show me the visual
  222. direction before generating.</pre>
  223. </details>
  224. </td>
  225. <td width="50%">
  226. <img src="docs/assets/readme/case-editorial.png" alt="Editorial magazine-style deck" width="100%" /><br />
  227. <strong>Editorial</strong> โ€” refined typography and a print-quality grid.
  228. <details><summary>๐Ÿ“‹ Copy the prompt</summary>
  229. <pre>Open Codex Slides and design an editorial, magazine-style deck โ€” a
  230. refined serif masthead, a strict multi-column print grid, warm
  231. photography, and generous white space. Use my essay as the source.
  232. Approve the outline, then export PDF.</pre>
  233. </details>
  234. </td>
  235. </tr>
  236. <tr>
  237. <td width="50%">
  238. <img src="public/community/foryou-pitch-midnight-traction.jpg" alt="Midnight investor pitch title slide" width="100%" /><br />
  239. <strong>Seed pitch โ€” midnight &amp; traction</strong> โ€” a confident dark title system, one electric-blue accent.
  240. <details><summary>๐Ÿ“‹ Copy the prompt</summary>
  241. <pre>Open Codex Slides in the Codex Browser and build a 10-slide seed pitch
  242. for a developer-tools startup โ€” problem, insight, product, demo,
  243. traction, market, model, moat, team, ask. Use a confident dark
  244. "midnight" title system with one electric-blue accent. Stop at the
  245. outline, then render in Fast mode.</pre>
  246. </details>
  247. </td>
  248. <td width="50%">
  249. <img src="public/community/foryou-pitch-clean-daylight.jpg" alt="Clean daylight product keynote with 3D diagram nodes" width="100%" /><br />
  250. <strong>Product keynote โ€” clean daylight</strong> โ€” a bright, airy layout with soft 3D diagram nodes.
  251. <details><summary>๐Ÿ“‹ Copy the prompt</summary>
  252. <pre>Open Codex Slides and create a 14-slide product keynote for an
  253. agent-native platform. Bright, airy "daylight" layout with soft 3D
  254. diagram nodes and one indigo accent, one idea per slide. Show me the
  255. visual-direction options, then generate at 4K.</pre>
  256. </details>
  257. </td>
  258. </tr>
  259. <tr>
  260. <td width="50%">
  261. <img src="public/community/foryou-data-answer-first.jpg" alt="Answer-first data slide with a national map and KPI callouts" width="100%" /><br />
  262. <strong>Answer-first data story</strong> โ€” leads with the headline, then a map and trends.
  263. <details><summary>๐Ÿ“‹ Copy the prompt</summary>
  264. <pre>Open Codex Slides in the Browser and turn the attached dataset into a
  265. 9-slide data story that leads with the answer: a headline metric, a
  266. national map of where it's happening, trend and regional breakdowns, and
  267. a recommendation. Analytical and uncluttered. Confirm the outline first.</pre>
  268. </details>
  269. </td>
  270. <td width="50%">
  271. <img src="public/community/foryou-craft-editorial-ink.jpg" alt="Editorial ink-and-paper report title slide" width="100%" /><br />
  272. <strong>Editorial report</strong> โ€” refined serif headlines and a strict print grid.
  273. <details><summary>๐Ÿ“‹ Copy the prompt</summary>
  274. <pre>Open Codex Slides. Use the attached PDF as the content source and
  275. rebuild it as a 12-slide editorial report โ€” refined serif headlines, an
  276. ink-and-paper craft palette, and a strict print grid. Keep every fact,
  277. add nothing. Stop for outline approval, then export PPTX and PDF.</pre>
  278. </details>
  279. </td>
  280. </tr>
  281. <tr>
  282. <td width="50%">
  283. <img src="public/community/nb-liquid-glass-bento.jpg" alt="Liquid glass bento grid dashboard" width="100%" /><br />
  284. <strong>Liquid Glass bento dashboard</strong> โ€” transparent glass cards over a soft blurred ground.
  285. <details><summary>๐Ÿ“‹ Copy the prompt</summary>
  286. <pre>Open Codex Slides and build a 6-slide product overview in the Liquid
  287. Glass Bento style โ€” an asymmetric bento grid of transparent glass cards
  288. over a soft blurred ground, one hero cell plus titled metric tiles. Use
  289. my attached specs as the facts. Approve the outline before rendering.</pre>
  290. </details>
  291. </td>
  292. <td width="50%">
  293. <img src="public/community/nb-summary-infographic.jpg" alt="Dense one-page summary infographic" width="100%" /><br />
  294. <strong>One-page summary infographic</strong> โ€” a whole story in one dense, sectioned page.
  295. <details><summary>๐Ÿ“‹ Copy the prompt</summary>
  296. <pre>Open Codex Slides and use the attached transcript as the source.
  297. Distill the whole meeting into a single dense "summary infographic"
  298. slide plus 4 supporting pages โ€” decisions, owners, next steps, and
  299. risks, with icons and tidy sections. Show me the outline first.</pre>
  300. </details>
  301. </td>
  302. </tr>
  303. <tr>
  304. <td width="50%">
  305. <img src="public/community/nb-technical-cutaway.jpg" alt="Labeled technical cutaway diagram" width="100%" /><br />
  306. <strong>Technical cutaway</strong> โ€” a labeled cross-section that formalizes a rough sketch.
  307. <details><summary>๐Ÿ“‹ Copy the prompt</summary>
  308. <pre>Open Codex Slides. Use the attached whiteboard photo as a visual source
  309. and reconstruct the system as a 5-slide "technical cutaway" โ€” a labeled
  310. cross-section hero, data flow, components, tradeoffs, and rollout. Keep
  311. my labels, formalize the sketch. Pause at the outline.</pre>
  312. </details>
  313. </td>
  314. <td width="50%">
  315. <img src="public/community/nb-bold-product-ad.jpg" alt="Bold high-contrast product ad slide" width="100%" /><br />
  316. <strong>Bold product ad</strong> โ€” a hero shot, one giant claim per page, a closing CTA.
  317. <details><summary>๐Ÿ“‹ Copy the prompt</summary>
  318. <pre>Open Codex Slides and turn our launch one-pager into a 5-slide "bold
  319. product ad" sequence โ€” a hero shot, one giant claim per page,
  320. high-contrast type, and a closing CTA. Punchy and confident. Confirm the
  321. visual direction, then render at 4K.</pre>
  322. </details>
  323. </td>
  324. </tr>
  325. <tr>
  326. <td width="50%">
  327. <img src="public/community/nb-golden-serif-quote.jpg" alt="Warm golden serif quote slide" width="100%" /><br />
  328. <strong>Golden serif quote moment</strong> โ€” a warm canvas with one oversized light-gold line.
  329. <details><summary>๐Ÿ“‹ Copy the prompt</summary>
  330. <pre>Open my finished deck and add three "golden serif quote" interstitials
  331. โ€” a warm brown canvas with one oversized light-gold serif line and a
  332. soft portrait fade โ€” between the major sections. Keep the rest of the
  333. visual system intact. Show me the result in Play mode.</pre>
  334. </details>
  335. </td>
  336. <td width="50%">
  337. <img src="public/community/nb-watercolor-map.jpg" alt="Watercolor annotated regional map" width="100%" /><br />
  338. <strong>Watercolor annotated map</strong> โ€” a hand-painted map anchoring a market story.
  339. <details><summary>๐Ÿ“‹ Copy the prompt</summary>
  340. <pre>Open Codex Slides and create an 8-slide market-entry brief centered on
  341. a watercolor annotated map of our target regions, with a ranked
  342. opportunity table and a phased plan. Run quick research first and keep
  343. the sources in Design Files. Approve the outline before rendering.</pre>
  344. </details>
  345. </td>
  346. </tr>
  347. <tr>
  348. <td width="50%">
  349. <img src="public/community/nb-retro-industrial-concept.jpg" alt="Retro industrial product concept render" width="100%" /><br />
  350. <strong>Retro industrial concept</strong> โ€” moody studio renders with utilitarian type.
  351. <details><summary>๐Ÿ“‹ Copy the prompt</summary>
  352. <pre>Open Codex Slides and create a 6-slide product concept deck in a
  353. retro-industrial style โ€” moody studio renders, utilitarian type, and
  354. spec callouts โ€” for a piece of hardware described in the attached brief.
  355. Show the visual direction, then generate.</pre>
  356. </details>
  357. </td>
  358. <td width="50%">
  359. <img src="public/community/nb-vintage-patent.jpg" alt="Vintage patent filing style technical page" width="100%" /><br />
  360. <strong>Vintage patent filing</strong> โ€” aged paper, fine linework, numbered figure callouts.
  361. <details><summary>๐Ÿ“‹ Copy the prompt</summary>
  362. <pre>Open Codex Slides and present our hardware concept as a 7-slide
  363. "vintage patent filing" โ€” aged paper, fine technical linework, numbered
  364. callouts, and a formal figure caption on every page. Use the attached
  365. CAD notes as the source. Outline first.</pre>
  366. </details>
  367. </td>
  368. </tr>
  369. <tr>
  370. <td width="50%">
  371. <img src="public/community/nb-engineering-blueprint-grid.jpg" alt="Engineering blueprint grid with annotated diagrams" width="100%" /><br />
  372. <strong>Engineering blueprint teardown</strong> โ€” annotated diagrams on a precise technical grid.
  373. <details><summary>๐Ÿ“‹ Copy the prompt</summary>
  374. <pre>Open Codex Slides and build a 9-slide competitive teardown of us vs.
  375. three named rivals in an engineering blueprint grid โ€” annotated
  376. diagrams, a feature matrix, pricing, and where we win. Fair and
  377. specific, no strawmen. Show the outline before rendering.</pre>
  378. </details>
  379. </td>
  380. <td width="50%">
  381. <img src="public/community/nb-chalkboard-lesson.jpg" alt="Warm chalkboard lesson layout with hand-drawn diagrams" width="100%" /><br />
  382. <strong>Chalkboard lesson</strong> โ€” hand-drawn diagrams and boxed definitions for teaching.
  383. <details><summary>๐Ÿ“‹ Copy the prompt</summary>
  384. <pre>Open Codex Slides and build a 12-slide training module on "Reading a
  385. Flame Graph" in a warm chalkboard-lesson style โ€” hand-drawn diagrams,
  386. boxed definitions, a worked example, and a short quiz. Write full
  387. speaker notes on every slide. Approve the outline before rendering.</pre>
  388. </details>
  389. </td>
  390. </tr>
  391. <tr>
  392. <td width="50%">
  393. <img src="public/community/nb-visual-info-guide.jpg" alt="Clean visual information guide layout" width="100%" /><br />
  394. <strong>Visual info guide</strong> โ€” a tidy, icon-led explainer for a research readout.
  395. <details><summary>๐Ÿ“‹ Copy the prompt</summary>
  396. <pre>Open Codex Slides and turn the attached survey export into a 10-slide
  397. research readout as a clean visual info guide: method, three headline
  398. findings with supporting charts, verbatim quotes, and recommendations.
  399. Neutral, evidence-first. Outline first.</pre>
  400. </details>
  401. </td>
  402. <td width="50%">
  403. <img src="public/community/nb-exploded-layers.jpg" alt="Exploded layer stack diagram" width="100%" /><br />
  404. <strong>Exploded layer stack</strong> โ€” a hero exploded diagram plus one slide per layer.
  405. <details><summary>๐Ÿ“‹ Copy the prompt</summary>
  406. <pre>Open Codex Slides and explain our architecture as a 5-slide "exploded
  407. layer stack" โ€” a hero exploded diagram plus one slide per layer with its
  408. role and interfaces. Use the attached design doc as the source. Pause at
  409. the outline.</pre>
  410. </details>
  411. </td>
  412. </tr>
  413. </table>
  414. > The preview images above are visual systems that ship with Codex Slides โ€” a few are real
  415. > Codex Slides renders, the rest are community-contributed style references the model matches on
  416. > **art direction**, not literal content. Every contributor and source is credited under
  417. > [Community style library and licenses](#community-style-library-and-licenses).
  418. ## Scenarios and visual systems
  419. Codex Slides is not a single "generate" button. It ships **118 ready-made visual systems** โ€”
  420. **45 curated deck templates** (15 professional categories ร— 3) plus **73 community styles**
  421. (12 groups) โ€” driven by **24 guided scenarios** in 6 groups. Start from a finished direction,
  422. pick a scenario, or just describe your own.
  423. ### 24 guided scenarios (6 groups)
  424. | Group | Scenarios |
  425. |---|---|
  426. | **Create** | Create from scratch ยท Business report ยท Pitch deck ยท Project proposal |
  427. | **Transform sources** | Beautify a deck (PPTX/HTML/PDF) ยท Document to deck ยท Notes / transcript to deck ยท Visuals / whiteboard to deck |
  428. | **Data & insights** | Data visualization & insights ยท Recurring performance report ยท Financial results ยท Survey & user research |
  429. | **Research & decisions** | Deep research presentation ยท Market & industry research ยท Competitive analysis ยท Literature review |
  430. | **Optimize a deck** | Apply a brand system ยท Reference recreation / style transfer ยท Translate & localize ยท Restructure (compress / expand) |
  431. | **Specialized outputs** | Training & courseware ยท Keynote & launch story ยท Portfolio & case study ยท Template-driven batch |
  432. ### 45 curated deck templates (15 categories ร— 3)
  433. Fundraising Pitch ยท Corporate Strategy ยท B2B Sales ยท Product Management ยท Design Craft ยท
  434. Academic Research ยท Professional Training ยท Data & Finance ยท Marketing & GTM ยท Consulting ยท
  435. Government & Policy ยท AI Literacy ยท Student Coursework ยท Career ยท Life & Story โ€” each with an
  436. expert role, target audience, and its own visual grammar.
  437. ### 73 community styles (12 groups)
  438. Curated from open prompt galleries and adapted into presentation-ready `<page_style>` systems,
  439. across **Business & Report ยท Infographic ยท Diagram ยท Data & Map ยท UI & Dashboard ยท Poster & Ad ยท
  440. Product ยท Brand & Identity ยท Architecture & Space ยท Photo & Cinematic ยท Editorial ยท
  441. Illustration**. A taste of the catalog:
  442. > Liquid Glass Bento ยท Summary Infographic ยท Engineering Blueprint Grid ยท Technical Cutaway ยท
  443. > Watercolor Annotated Map ยท Visual Info Guide ยท UI Screenshot System ยท Retro CRT Interface ยท
  444. > Bold Product Ad ยท Hyperreal Product Poster ยท Lifestyle Product Shot ยท Brand Identity Package ยท
  445. > Cyberpunk Miniature City ยท 35mm Surreal Landscape ยท Golden Serif Quote ยท Neo-Parametric
  446. > Editorial ยท Fashion Magazine Cover ยท Hand-Drawn Infographic ยท Paper Pop-Up Story ยท Voxel Icon
  447. > System โ€ฆ and 53 more.
  448. Codex Slides ranks these against your topic and outline at the inspiration step, so you can
  449. lock a direction in one click, search the full library, or keep the default.
  450. ### Fast mode โ†’ production-ready export
  451. - **Fast mode** renders **every page in parallel** (up to 4 in flight, overflow queued) instead
  452. of one-by-one, while the outline and visual direction stay locked โ€” a **10+ slide deck lands
  453. in ~4โ€“5 minutes**.
  454. - **Production export**: download a real **PPTX** and a print-ready **PDF**, with speaker notes
  455. preserved, straight from the project.
  456. - **Render quality** 1K / 2K / 4K and **five aspect ratios** โ€” 16:9, 4:3, 1:1, 9:16, 3:4.
  457. ## Install in Codex
  458. ### Requirements
  459. - [Codex](https://developers.openai.com/codex/) with plugin support
  460. - Node.js 20 or newer
  461. - A ChatGPT account authenticated once with `codex login`
  462. - Git
  463. No separate OpenAI API key or `.env` file is required for the default Codex workflow.
  464. ### Install from the GitHub marketplace
  465. This repository includes a Codex marketplace manifest, so the repository itself can be added
  466. as a plugin source:
  467. ```bash
  468. codex plugin marketplace add nexu-io/codex-slides
  469. codex plugin add codex-slides@codex-slides
  470. ```
  471. Restart Codex or the ChatGPT desktop app after installation, then start a new task. You can
  472. also open `/plugins` in Codex to inspect installed plugins.
  473. To update a Git-backed installation:
  474. ```bash
  475. codex plugin marketplace upgrade codex-slides
  476. codex plugin remove codex-slides@codex-slides
  477. codex plugin add codex-slides@codex-slides
  478. ```
  479. Restart Codex after the update so the new Skill, MCP server, and interface metadata are
  480. loaded. See OpenAI's
  481. [local plugin installation documentation](https://learn.chatgpt.com/docs/build-plugins#install-a-local-plugin-manually)
  482. for the marketplace layout and reload behavior.
  483. ### Install from a local checkout
  484. ```bash
  485. git clone https://github.com/nexu-io/codex-slides.git
  486. cd codex-slides
  487. codex plugin marketplace add "$PWD"
  488. codex plugin add codex-slides@codex-slides
  489. ```
  490. After changing plugin files locally, reinstall the plugin and start a new Codex task so cached
  491. Skills are refreshed.
  492. ## Create your first deck
  493. Open a new Codex task and send:
  494. ```text
  495. Open Codex Slides in the Codex Browser and keep the product visible.
  496. From the home page, create a project for a six-slide product launch deck.
  497. Guide me through the clarification questions, outline review, visual direction,
  498. and rendering. Do not generate the complete deck in a hidden background call.
  499. ```
  500. Codex should:
  501. 1. Open the Codex Slides home screen.
  502. 2. Submit the brief through the visible composer.
  503. 3. Enter the newly created project.
  504. 4. Help answer the requirements form.
  505. 5. Show the editable outline.
  506. 6. Show visual-direction choices.
  507. 7. Render inside the project canvas.
  508. 8. Inspect the completed slides before export.
  509. For an explicitly unattended or headless job, say so. Only then should Codex use the one-call
  510. `create_deck` / `create` fast path.
  511. A localized visual tutorial with copy-ready prompts in English, Simplified Chinese, and
  512. Japanese is linked from the home page beneath the composer, and is also reachable directly
  513. once the local app is running:
  514. ```text
  515. http://127.0.0.1:4311/?tutorial=codex
  516. ```
  517. ## Generate from files
  518. Attach files to Codex or upload them from the Codex Slides composer. Give each source a clear
  519. semantic role:
  520. ```text
  521. Open Codex Slides in the Codex Browser.
  522. Use the attached PDF as the content source, the spreadsheet as the dataset,
  523. and the logo plus product screenshots as brand references.
  524. Create the project through the visible UI and stop for outline approval before
  525. rendering.
  526. ```
  527. Supported project context includes images, PDFs, office documents, spreadsheets, Markdown,
  528. text, data files, HTML/CSS, JavaScript, and TypeScript. Scenario workflows can require or
  529. recommend specific source slots.
  530. ## Modify an existing deck
  531. ### Rewrite one slide
  532. ```text
  533. Open my latest Codex Slides project. Rewrite slide 3 for an executive audience,
  534. reduce the copy by 50%, preserve the conclusion, regenerate only that slide,
  535. and show the result in the Browser.
  536. ```
  537. ### Change the structure
  538. ```text
  539. Add an executive summary after slide 1, duplicate slide 5 as an international
  540. market variant, and delete the final appendix. Preserve the visual system and
  541. transitions.
  542. ```
  543. ### Restyle the complete deck
  544. ```text
  545. Restyle this deck as a restrained Swiss editorial report with a strict grid,
  546. high-contrast typography, warm photography, and one blue accent. Keep the
  547. Browser visible and show the result before export.
  548. ```
  549. ### Edit from annotations
  550. ```text
  551. Open slide 4 in Mark mode. Follow my arrows, labels, and comment exactly,
  552. regenerate only that slide, and keep the marked source in project history.
  553. ```
  554. ### Apply a project-wide brand system
  555. ```text
  556. Open Brand & Design System. Save the logo, color roles, typography, spacing,
  557. imagery, and voice as always-on project context. Redraw the deck, review it in
  558. Play mode, then export PPTX and PDF.
  559. ```
  560. ## Features
  561. - **Browser-first Codex workflow** โ€” open, operate, and verify the live product instead of
  562. waiting on an invisible task.
  563. - **Durable projects** โ€” every deck, checkpoint, conversation, queue, material, outline, and
  564. rendered image is persisted locally.
  565. - **Cross-surface synchronization** โ€” a project opened in another Browser tab follows
  566. externally generated or edited slide state.
  567. - **Gen-UI clarification** โ€” tailored questions for audience, purpose, length, language,
  568. format, and emphasis.
  569. - **Deep research** โ€” source-backed, editable Markdown briefs used as outline evidence.
  570. - **24 workflow scenarios in six groups** โ€” creation, transformation, data, research,
  571. optimization, and specialized delivery.
  572. - **45 curated deck templates plus 73 community visual directions** across business reports,
  573. data, diagrams, UI, posters, products, brand systems, architecture, photography, editorial,
  574. and illustration.
  575. - **Reusable project templates** โ€” save any project as a visual-system snapshot, then reuse
  576. its brand rules, base style, format, brand assets, and up to six rendered-slide references
  577. from the home composer without copying its content.
  578. - **Design Files** โ€” inspect generated artifacts and uploads, edit text sources, reference
  579. project files in agent turns with `@`, copy an absolute file path, or download any file.
  580. - **Brand & Design System** โ€” persist identity, voice, palette, typography, imagery, effects,
  581. spacing, radii, and brand assets.
  582. - **Conversational editing** โ€” rewrite, add, remove, duplicate, reorder, transition,
  583. regenerate, or restyle through the Deck Agent.
  584. - **Automatic version history** โ€” every rendered-deck AI command and manual edit creates an
  585. immutable checkpoint with its prompt; inspect, play, restore, or export that exact PDF/PPTX.
  586. - **Queued follow-ups** โ€” keep prompting while generation or edits are in progress; requests
  587. run in order.
  588. - **Mark editing** โ€” draw arrows, shapes, labels, and comments directly on a slide, then
  589. regenerate from the annotated source.
  590. - **Play mode** โ€” full-screen, dual-window presentation with keyboard navigation and speaker
  591. notes.
  592. - **PDF and PPTX export** โ€” export after visual review.
  593. - **English, Simplified Chinese, and Japanese UI** with strict key parity.
  594. - **Portable Skill and typed MCP server** โ€” the complete workflow remains available when one
  595. transport is unavailable.
  596. ## CLI and MCP
  597. Codex Slides exposes two equivalent automation transports:
  598. - `skills/codex-slides/scripts/codex-slides.mjs` โ€” portable Node CLI using only built-in web
  599. APIs and the local HTTP service;
  600. - `mcp/server.mjs` โ€” 38 typed MCP tools for Codex, including durable run start/status/wait/cancel.
  601. Discover the CLI surface:
  602. ```bash
  603. node skills/codex-slides/scripts/codex-slides.mjs capabilities
  604. ```
  605. Browser-first interactive entry points:
  606. ```bash
  607. node skills/codex-slides/scripts/codex-slides.mjs open
  608. node skills/codex-slides/scripts/codex-slides.mjs start-project \
  609. --json '{"topic":"2026 humanoid robotics market","pages":6,"language":"en"}'
  610. ```
  611. Explicit unattended path:
  612. ```bash
  613. node skills/codex-slides/scripts/codex-slides.mjs create \
  614. --json '{"topic":"2026 humanoid robotics market","pages":6,"research":true}'
  615. ```
  616. Important tool groups:
  617. | Area | MCP tools |
  618. |---|---|
  619. | Open and discover | `open_codex_slides`, `start_project`, `get_capabilities`, `list_projects`, `get_project` |
  620. | Durable project runs | `start_project_run`, `get_project_run`, `wait_project_run`, `cancel_project_run` |
  621. | Scenarios and sources | `list_scenarios`, `upload_material`, `list_design_files`, `read_design_file`, `write_design_file`, `upload_design_file` |
  622. | Reusable templates | `list_templates`, `list_project_templates`, `save_project_as_template`, `delete_project_template` |
  623. | Research and planning | `get_onboarding_questions`, `deep_research`, `create_outline`, `revise_outline`, `rank_inspiration` |
  624. | Brand system | `get_brand_design_system`, `update_brand_design_system` |
  625. | Create and edit | `create_deck`, `render_deck`, `edit_deck`, `restyle_deck`, `manage_slide`, `regenerate_slide` |
  626. | Visual input and output | `upload_slide_image`, `mark_edit_slide`, `export_deck` |
  627. | Presenter notes | `get_speaker_notes`, `update_speaker_notes`, `generate_speaker_notes` |
  628. The full Browser/CLI/MCP parity contract lives in
  629. [CAPABILITY_MATRIX.md](skills/codex-slides/references/CAPABILITY_MATRIX.md).
  630. ## Local development
  631. ```bash
  632. git clone https://github.com/nexu-io/codex-slides.git
  633. cd codex-slides
  634. corepack enable
  635. pnpm install
  636. codex login
  637. pnpm dev
  638. ```
  639. `pnpm dev` launches the Web service and Electron desktop together. Choose a narrower mode when
  640. you only need one surface:
  641. | Command | Starts | Service behavior |
  642. |---|---|---|
  643. | `pnpm dev` | Web + Desktop | Starts one shared Web service, opens Electron, and stops owned child processes on exit |
  644. | `pnpm dev:web` | Web only | Serves <http://127.0.0.1:4311> |
  645. | `pnpm dev:desktop` | Desktop | Reuses a healthy Web service or starts and waits for one automatically |
  646. ### Background lifecycle (start / restart / stop)
  647. `pnpm dev` runs in the foreground and streams logs (Ctrl+C stops it). To run the same Web +
  648. Desktop stack **in the background** and manage it from any shell, use the lifecycle commands.
  649. Each accepts an optional target โ€” `all` (default), `web`, or `desktop`:
  650. | Command | Purpose |
  651. |---|---|
  652. | `pnpm dev:start [all\|web\|desktop]` | Start in the background (daemon); waits for the Web service to become healthy, then returns |
  653. | `pnpm dev:stop [all\|web\|desktop]` | Stop background services (`all` stops Desktop, then Web) |
  654. | `pnpm dev:restart [all\|web\|desktop]` | Restart background services (stop then start) |
  655. | `pnpm dev:status [all\|web\|desktop]` | Show what is running: PID, URL, uptime, and Web health (`--json` for machine-readable output) |
  656. | `pnpm dev:logs [all\|web\|desktop]` | Tail the last 200 log lines; add `-f` / `--follow` to stream new output |
  657. Background output and process state live under `.tmp/dev-runtime/` (`web.log`, `desktop.log`,
  658. and `<target>.json`). `pnpm dev:start desktop` starts its Web dependency automatically, and
  659. `dev:start` reuses an already-healthy Web service instead of starting a second one. Override the
  660. Web port with `--web-port <port>` on `dev:start` / `dev:restart`.
  661. Production build:
  662. ```bash
  663. pnpm build
  664. pnpm start
  665. ```
  666. Environment variables:
  667. | Variable | Default | Purpose |
  668. |---|---|---|
  669. | `CODEX_SLIDES_URL` | `http://127.0.0.1:4311` | Browser and local API base URL |
  670. | `CODEX_SLIDES_HOME` | auto-detected | Source checkout used by the portable Skill |
  671. | `CODEX_SLIDES_APP_DIR` | plugin root | Source checkout used by the MCP server |
  672. | `CODEX_SLIDES_LOG` | OS temp directory | Auto-start server log |
  673. | `CODEX_SLIDES_NO_AUTO_START` | unset | Set to `1` to disable MCP auto-start |
  674. | `CODEX_SLIDES_DATA_DIR` | `<repo>/data` | Project/template data root; desktop builds set this to the OS user-data directory |
  675. Project data is stored under:
  676. ```text
  677. data/projects/<project-id>/
  678. โ”œโ”€โ”€ project.json
  679. โ”œโ”€โ”€ 01.png
  680. โ”œโ”€โ”€ 02.png
  681. โ”œโ”€โ”€ ...
  682. โ””โ”€โ”€ files/
  683. โ”œโ”€โ”€ generated/
  684. โ””โ”€โ”€ uploaded/
  685. data/templates/<template-id>/
  686. โ”œโ”€โ”€ template.json
  687. โ”œโ”€โ”€ references/
  688. โ””โ”€โ”€ brand-assets/
  689. ```
  690. Do not commit personal project data or uploaded source material.
  691. ## Desktop development and releases
  692. The same Next.js application can run in Electron on macOS, Windows, and Linux. In packaged
  693. builds, Electron starts the bundled standalone server on an available loopback port and stores
  694. durable data in the operating system's app data directory.
  695. | Command | Purpose |
  696. |---|---|
  697. | `pnpm electron:check` | Validate desktop metadata, icons, service startup, and runtime contracts |
  698. | `pnpm electron:dev` | Alias of `pnpm dev:desktop` |
  699. | `pnpm electron:pack` | Build an unpacked app for the current platform |
  700. | `pnpm electron:dist` | Build installers for the current platform |
  701. | `pnpm smoke:standalone` | Boot the built standalone server and require 200s from core routes |
  702. | `pnpm smoke:packaged` | Boot the server from every unpacked app in `dist/` and probe it |
  703. | `pnpm release <version>` | Bump versions, run gates, tag, and push โ€” the tag ships the release |
  704. The Desktop entry resolves its service dependency first: it attaches to a healthy
  705. `CODEX_SLIDES_URL` when one already exists, otherwise it starts `dev:web`, waits for
  706. `/api/agents`, then opens the Electron window. Closing or interrupting the combined command
  707. stops only the Web process that command owns, so a separately launched Web session is kept.
  708. Desktop builds use an isolated `.next-desktop` output so a concurrent web/dev build cannot
  709. overwrite the runtime being packaged.
  710. Releases are one action: run **Actions โ†’ Release desktop apps โ†’ Run workflow** with a version
  711. number (the workflow bumps versions, commits, and tags by itself), or locally run
  712. `pnpm release 0.2.0`, which bumps versions, runs the local gates, and pushes a `v0.2.0` tag.
  713. Either path runs
  714. [`release-desktop.yml`](.github/workflows/release-desktop.yml), which creates a draft GitHub
  715. Release, builds on native macOS, Windows, and Linux runners, **boots the packaged server on
  716. every platform and requires HTTP 200 from core routes**, uploads the `.dmg`, `.zip`, `.exe`,
  717. `.AppImage`, and `.deb` files plus `SHA256SUMS.txt`, and only then publishes the release. The
  718. full maintainer guide, including recovery steps, lives in
  719. [`docs/RELEASING.md`](docs/RELEASING.md).
  720. Downloaded builds are not yet notarized: on macOS, right-click the app and choose **Open** on
  721. first launch (or approve it under System Settings โ†’ Privacy & Security), and on Windows use
  722. SmartScreen's **More info โ†’ Run anyway**. Desktop logs live in the OS app-data directory
  723. (`codex-slides-desktop.log` for the shell, `codex-slides-server.log` for the bundled server).
  724. ## Roadmap
  725. Codex Slides is early and moving fast. The goal is simple: be the best way to make slides with
  726. a coding agent. Priorities are grouped by horizon and may shift with community feedback.
  727. | Status | Item |
  728. |---|---|
  729. | โœ… Shipped | Browser-first guided workflow: research โ†’ outline โ†’ style โ†’ render โ†’ edit โ†’ present โ†’ export |
  730. | โœ… Shipped | Durable projects, reusable project templates, and Design Files |
  731. | โœ… Shipped | Brand & Design System, mark-based editing, and dual-window Play mode |
  732. | โœ… Shipped | Immutable automatic version history with prompt inspection, playback, restore, and exact-version PDF/PPTX export |
  733. | โœ… Shipped | Portable Agent Skills, 38 typed MCP tools, durable runs, exact Browser handoffs, and Electron desktop apps |
  734. | โœ… Shipped | Unified Codex Slides naming and icon assets across Web, desktop, and the Codex plugin |
  735. | ๐Ÿšง In progress | Sharper template gallery and one-click community-style previews |
  736. | ๐Ÿ”œ Next | Editable-shape PPTX export (native text and vector objects, not just full-slide images) |
  737. | ๐Ÿ”œ Next | Live collaboration and shareable read-only present links |
  738. | ๐Ÿ”œ Next | Bring-your-own-agent support beyond Codex, and additional image backends |
  739. | ๐Ÿ”ญ Exploring | Charts and tables from live data sources and spreadsheets |
  740. | ๐Ÿ”ญ Exploring | Theme marketplace and per-organization brand kits |
  741. | ๐Ÿ”ญ Exploring | Video/animated slide export and speaker-rehearsal mode |
  742. Have a request? Open a [GitHub Issue](https://github.com/nexu-io/codex-slides/issues) or start
  743. a discussion โ€” roadmap items are prioritized in the open.
  744. ## Community style library and licenses
  745. The Community styles Browser is a presentation-focused index distilled from the open prompt
  746. galleries below. Codex Slides keeps one catalog for the home Browser, the project inspiration
  747. checkpoint, Brand & Design System, prompt generation, the portable CLI, and MCP. Selecting a
  748. community style injects its adapted `<page_style>` rules and, when available, sends its
  749. preview as the first visual reference image. The model is told to match art direction and
  750. layout grammar, not to copy the preview's literal text, logos, subject, or composition.
  751. | Reference | License noted by the source | How Codex Slides uses it |
  752. |---|---|---|
  753. | [YouMind Awesome GPT Image 2](https://github.com/YouMind-OpenLab/awesome-gpt-image-2) and [web gallery](https://youmind.com/gpt-image-2-prompts) | [CC BY 4.0](https://github.com/YouMind-OpenLab/awesome-gpt-image-2/blob/main/LICENSE) | Category research, prompt-language references, and source discovery |
  754. | [freestylefly Awesome GPT Image 2](https://github.com/freestylefly/awesome-gpt-image-2) | [MIT](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/LICENSE) | Adapted industrial template taxonomy and attributed remote previews |
  755. | [JimmyLv Awesome Nano Banana](https://github.com/JimmyLv/awesome-nano-banana) | [CC BY 4.0](https://github.com/JimmyLv/awesome-nano-banana/blob/main/LICENSE), subject to per-case attribution overrides | Case discovery, prompt authorship, and presentation-suitable visual directions |
  756. | [YouMind Awesome Nano Banana Pro Prompts](https://github.com/YouMind-OpenLab/awesome-nano-banana-pro-prompts) | [CC BY 4.0](https://github.com/YouMind-OpenLab/awesome-nano-banana-pro-prompts/blob/main/LICENSE) | Curated local previews and adapted presentation style blocks |
  757. | [muset-ai Awesome Nano Banana Pro](https://github.com/muset-ai/awesome-nano-banana-pro) | [CC BY 4.0](https://github.com/muset-ai/awesome-nano-banana-pro/blob/main/LICENSE), subject to per-case attribution overrides | Cross-checking Nano Banana Pro cases and visual coverage |
  758. | [jamez-bondos Awesome GPT-4o Images](https://github.com/jamez-bondos/awesome-gpt4o-images) | [CC BY 4.0](https://github.com/jamez-bondos/awesome-gpt4o-images/blob/main/LICENSE), except separately noted OpenAI files and per-case overrides | Attributed preview images and reusable case-derived art directions |
  759. Each catalog item keeps its source collection, original author when known, and source URL in
  760. [`src/lib/community.ts`](src/lib/community.ts). The files under
  761. [`public/community`](public/community) and remote community previews retain their upstream
  762. terms and attribution requirements; Codex Slides' MIT license does not relicense those assets.
  763. Before redistributing a specific preview, follow its source link and check any case-level
  764. `ATTRIBUTION.yml` or notice.
  765. ## Architecture and data
  766. ```text
  767. Codex Skill / MCP server / Browser UI / Electron
  768. โ”‚
  769. โ–ผ
  770. Next.js local HTTP API
  771. โ”‚
  772. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  773. โ–ผ โ–ผ โ–ผ
  774. Codex text web search image generation
  775. โ”‚ โ”‚
  776. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  777. โ–ผ
  778. on-disk project store
  779. โ”‚
  780. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  781. โ–ผ โ–ผ
  782. Browser PDF / PPTX
  783. ```
  784. Key directories:
  785. ```text
  786. .codex-plugin/ installable Codex plugin manifest
  787. .agents/ Git marketplace metadata
  788. .mcp.json MCP registration
  789. mcp/ typed MCP server
  790. skills/ canonical and compatibility Skills
  791. src/app/ Next.js UI and API routes
  792. src/components/ launcher, tutorial, project workspace, editing surfaces
  793. src/lib/ agents, research, pipeline, project store, export
  794. scripts/ contract, i18n, Skill, and MCP probes
  795. data/projects/ local project state and generated assets
  796. data/templates/ reusable project visual systems and reference assets
  797. ```
  798. The local app uses the existing `codex login` authentication. Text generation, web research,
  799. and image generation are invoked through the same authenticated Codex environment; no separate
  800. application API key is stored by Codex Slides.
  801. ## Verification
  802. Run the complete static contract:
  803. ```bash
  804. pnpm typecheck
  805. pnpm test
  806. pnpm check:i18n
  807. pnpm check:project-sync
  808. pnpm check:skill
  809. pnpm check:mcp
  810. pnpm electron:check
  811. pnpm build
  812. ```
  813. With the local app running:
  814. ```bash
  815. pnpm check:skill:live
  816. pnpm check:mcp:live
  817. pnpm check:project-sync:live
  818. ```
  819. UI changes should also be checked at desktop, tablet, and phone widths. For project workflow
  820. changes, verify both the Codex Browser and a second browser tab using the same project URL.
  821. ## Troubleshooting
  822. ### Codex does not see the plugin
  823. 1. Run `codex plugin list` and confirm `codex-slides` is enabled.
  824. 2. Reinstall the plugin after changing its version or Skill files.
  825. 3. Restart Codex or the ChatGPT desktop app.
  826. 4. Start a new task; existing tasks may retain the old Skill snapshot.
  827. ### The local app does not start
  828. ```bash
  829. node --version # must be 20+
  830. pnpm install
  831. pnpm build
  832. pnpm start
  833. ```
  834. Inspect the log at `CODEX_SLIDES_LOG` or the operating system temp directory.
  835. ### One browser tab shows stale slides
  836. Every open project page polls the canonical project, including while it already looks complete,
  837. and also refreshes on focus or visibility changes. This lets a visible browser discover a new
  838. Codex, MCP, CLI, or second-tab mutation. If an older build is still open, restart the local
  839. server and reload both tabs. Confirm the API state:
  840. ```bash
  841. curl http://127.0.0.1:4311/api/projects/<project-id>
  842. ```
  843. ### A project is stuck in rendering
  844. Codex Slides waits for the active renderer and only resumes after the project has no disk
  845. heartbeat for 90 seconds. Reopen the project; already rendered pages are preserved and only
  846. pending or failed pages are retried.
  847. ### Exported PPTX text is not editable
  848. This is expected today. Codex Slides currently exports each completed slide as a full-slide
  849. image for visual fidelity. Editable-shape export is on the [roadmap](#roadmap).
  850. ## GitHub repository metadata
  851. Recommended repository title, description, categories, topics, social-preview copy, and
  852. release naming are documented in [docs/GITHUB_METADATA.md](docs/GITHUB_METADATA.md).
  853. ## Media & creator kit
  854. Covering Codex Slides โ€” a video, a thread, a newsletter, a review? You don't have to learn the
  855. product first. [**docs/MEDIA_KIT.md**](docs/MEDIA_KIT.md) is a press kit written to be handed to
  856. an AI agent: paste it in and ask for the piece you want.
  857. It includes:
  858. - Boilerplate, one-liners, and elevator pitches at multiple lengths โ€” in **English, ็ฎ€ไฝ“ไธญๆ–‡, and ๆ—ฅๆœฌ่ชž**.
  859. - A **by-the-numbers** table, **story angles**, and **audience personas** to build a piece around.
  860. - A category **comparison**, an **FAQ**, and **ready-to-post** tweets, threads, and LinkedIn copy.
  861. - **30- and 60-second video scripts** with a shot list, plus an **asset manifest** mapping every screenshot.
  862. - Two guardrail sections โ€” **โœ… Safe to claim** and **โš ๏ธ Do not claim** โ€” so generated promo stays
  863. accurate and never invents features, benchmarks, or an OpenAI affiliation.
  864. ## Star Codex Slides
  865. <p align="center">
  866. <img src="docs/assets/readme/star-us.png" alt="If this saved you an afternoon, give it a star" width="880" />
  867. </p>
  868. If Codex Slides saved you an afternoon, give it a โญ. Stars don't pay rent โ€” but they tell the
  869. next developer, agent, and contributor that this project is worth their attention. One click,
  870. three seconds, a real signal.
  871. ## Contributing
  872. Contributions are welcome. Start with [CONTRIBUTING.md](CONTRIBUTING.md), which covers setup,
  873. architecture boundaries, i18n, Skill/MCP parity, visual QA, tests, and pull-request
  874. expectations.
  875. - Use [GitHub Issues](https://github.com/nexu-io/codex-slides/issues) for bugs and feature
  876. proposals.
  877. - Use GitHub private vulnerability reporting for security issues; see [SECURITY.md](SECURITY.md).
  878. - Be respectful and constructive; see [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).
  879. ## License
  880. Codex Slides source code is available under the [MIT License](LICENSE). Community previews and
  881. adapted prompt references retain the upstream terms and attribution documented in
  882. [Community style library and licenses](#community-style-library-and-licenses).
  883. ## Acknowledgements
  884. Codex Slides builds on ideas and implementation patterns from:
  885. - [`Anionex/banana-slides`](https://github.com/Anionex/banana-slides) for the original
  886. image-generation presentation mechanism;
  887. - [`nexu-io/html-anything`](https://github.com/nexu-io/html-anything) for local agent
  888. detection and invocation patterns;
  889. - [`nexu-io/html-video`](https://github.com/nexu-io/html-video) and
  890. [`zhongerxin/cowart`](https://github.com/zhongerxin/cowart) for per-unit and mark-edit
  891. interaction ideas;
  892. - [Open Design](https://github.com/nexu-io/open-design) for the agent-native design workflow
  893. and product direction.
  894. ---
  895. <p align="center">
  896. <strong>Open Codex Slides in Codex. Keep it visible. Make every slide steerable.</strong>
  897. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If itโ€™s helped, pass it on.