{"slug": "codex-slides-turning-repos-into-decks-from-scratch", "title": "Codex Slides: Turning Repos into Decks from Scratch", "summary": "Codex Slides, an open-source tool from nexu-io, converts GitHub repositories into presentation slides by scanning file structures and identifying key logic flows, cutting preparation time from hours to minutes. The tool requires users to provide their own LLM API keys and supports customization via prompt engineering, with recommended models including Claude 3.5 Sonnet and GPT-4o for optimal code synthesis.", "body_md": "# Codex Slides: Turning Repos into Decks from Scratch\n\nThe core value here isn't just \"AI-generated slides\"—it's the ability to feed it a technical repository and have it synthesize the architecture and logic into a visual format. If you're trying to onboard a new teammate to a codebase or present a project's progress, this cuts the preparation time from hours to minutes.\n\n## Getting it Running\n\nSince this is an open-source tool, you can deploy it locally. The setup is straightforward, but you'll need your own LLM API keys to power the generation engine.\n\n1. Clone the repository and install dependencies:\n\n```\ngit clone https://github.com/nexu-io/codex-slides.git\ncd codex-slides\nnpm install\n```\n\n2. Configure your environment variables. Create a `.env`\n\nfile in the root directory to link your AI provider:\n\n```\nOPENAI_API_KEY=your_api_key_here\n# If using a different provider via OpenAI-compatible API\nOPENAI_API_BASE=https://api.your-provider.com/v1\n```\n\n3. Fire up the development server:\n\n```\nnpm run dev\n```\n\n## Practical Workflow: Repo to Presentation\n\nThe real power comes when you use the \"Repo to Deck\" feature. Instead of writing a manual prompt, you provide a link to a public repository. The agent scans the file structure, reads the README, and identifies key logic flows to build the slides.\n\nTo optimize the output, I've found that prompt engineering the \"Style\" or \"Context\" field helps avoid generic AI fluff. For example, instead of saying \"Make a presentation about this repo,\" use a specific technical instruction:\n\n```\nAnalyze the /src/core directory and create a 5-slide technical deep dive. \nFocus on the data pipeline logic and the specific implementation of the \ncaching layer. Use a professional engineering tone and include \npseudo-code examples from the source.\n```\n\n## Technical Breakdown and Performance\n\nFrom a developer's perspective, the tool's architecture is interesting because it doesn't just output a static PDF. It generates a structured representation of the slides that can be edited.\n\n**Input Processing:** It handles both raw text prompts and repository crawling.**Rendering Engine:** Uses a web-based renderer that ensures the layout remains consistent regardless of the amount of text generated.**Customization:** You can tweak the theme and layout without needing to touch a GUI, fitting perfectly into an AI workflow for those of us who prefer Markdown over drag-and-drop.\n\n## Is it worth the setup?\n\nIf you are a student or a developer who frequently has to present technical architecture, yes. The \"from scratch\" setup takes about 5 minutes, and the time saved on slide formatting is immediate.\n\nThe only real friction point is the reliance on external LLMs. If you're using a smaller model, the summaries can sometimes be too brief. I recommend using [Claude](/en/tags/claude/) 3.5 Sonnet or GPT-4o for the best synthesis of complex codebases. For those looking for a complete guide on how to integrate this into a CI/CD pipeline (e.g., auto-generating documentation slides on every major release), there is significant potential here for further automation.\n\nFor those interested in the source code, you can find the project here:\n\n```\nhttps://github.com/nexu-io/codex-slides\n```\n\n[Next Critical Thinking with LLMs: A Practical Workflow →](/en/threads/2882/)", "url": "https://wpnews.pro/news/codex-slides-turning-repos-into-decks-from-scratch", "canonical_source": "https://promptcube3.com/en/threads/2890/", "published_at": "2026-07-24 20:04:55+00:00", "updated_at": "2026-07-24 20:07:35.163153+00:00", "lang": "en", "topics": ["developer-tools", "generative-ai", "large-language-models"], "entities": ["nexu-io", "Codex Slides", "Claude 3.5 Sonnet", "GPT-4o", "OpenAI"], "alternates": {"html": "https://wpnews.pro/news/codex-slides-turning-repos-into-decks-from-scratch", "markdown": "https://wpnews.pro/news/codex-slides-turning-repos-into-decks-from-scratch.md", "text": "https://wpnews.pro/news/codex-slides-turning-repos-into-decks-from-scratch.txt", "jsonld": "https://wpnews.pro/news/codex-slides-turning-repos-into-decks-from-scratch.jsonld"}}