OpenCode Slides Plugin

Openslide skill — a Slides side panel for the OpenCode desktop app (2.2+), built on its experimental gui-experimental plugin API. View and edit a PowerPoint deck next to your session, comment on individual elements, and send them to the model — and let the model take screenshots of slides itself.

What you get

• A real, editable deck in the panel. Slides render in the browser with pptx-react-viewer (Apache-2.0) — no LibreOffice round trip. The panel shows just the slide; Edit brings back the full PowerPoint-style editor: ribbon (Home, Insert, Draw, Design, Transitions, Animations, Slide Show, Review, View, Help), thumbnails, notes, find/replace, themes and more. Changes autosave to the .pptx about a second after you stop.
• Undo / redo arrows in the header, and a clickable Saved / Unsaved button (also Ctrl+S). Reload (↻) saves pending edits first, so nothing is lost.
• PowerPoint shortcuts: Ctrl+Z / Ctrl+Y, Ctrl+C / X / V, Ctrl+D, Ctrl+M (new slide), Ctrl+B / I / U, Ctrl+L / E / R / J, Ctrl+[ and Ctrl+] (font size), Delete, arrows, PageUp / PageDown, F5 (start show), Ctrl+P (print), Ctrl+Home / End. They work from the panel as well as from inside the slide.
• Ask AI to edit. Click an element (or nothing = the whole slide), type what to change, + Queue to collect several requests or Send to post one message to the current session with your comments (shape id, name, text) and PNGs of the commented slides (or all slides with All slides). Review asks the model to list problems on every slide. A small Ask AI to edit bubble appears next to a selected element and steps aside while you edit by hand. The bar is compact and resizable (drag the grip on its top edge).
• The model can look at slides itself. The plugin adds a slide_screenshot tool (deck: absolute path, optional when the deck is open in the panel; slides: 1-based list). An open panel answers in about a second; otherwise the file is rendered with LibreOffice.
• Live reload. When the model (or anything else) saves the deck, the panel reloads it; if you have unsaved edits it asks first.
• Distinct animation icons, full theme / variant previews, and a ribbon that is compact enough for a side panel.

Requirements

• OpenCode Desktop 2.2 or newer (the plugin GUI API is experimental and may change)
• A session model that accepts images (for the screenshots sent with your comments)
• Optional, for the slide_screenshot fallback when no panel is open: LibreOffice, and Python 3 with pip install python-pptx pymupdf

HOW TO INSTALL

The built files are committed, so there is no build step.

macOS / Linux

git clone https://github.com/aswanthwuhan/opencode-slides-plugin ~/.config/opencode/plugins/opencode-slides

Windows (PowerShell)

git clone https://github.com/aswanthwuhan/opencode-slides-plugin "$env:USERPROFILE\.config\opencode\plugins\opencode-slides"

You can also clone anywhere and link it into that folder (mklink /J on Windows, ln -s elsewhere), or put it in a project's .opencode/plugins/ folder to enable it for that project only.

Then fully quit and reopen OpenCode Desktop (closing the window is not enough — the editor script is only loaded when the panel is created).

To update later: git pull inside the plugin folder, then restart OpenCode.

Optional plugin options

In your OpenCode 2 config, use a plugins entry of the form { "package": "<path>", "options": { … } }:

Option	Meaning
python	Path to the Python executable used for the LibreOffice fallback
soffice	Path to the LibreOffice executable
pluginDir	Where the plugin lives, if it is not in a standard plugins folder

AGENT INSTALL PROMPT

Paste this into an OpenCode session (or any coding agent with shell access) and let it do the install:

Install the "OpenCode Slides Plugin" (Openslide skill) for OpenCode Desktop, including every dependency it needs.

1. Prerequisites. Check each with a command and report what is missing before changing anything:
   - git            (git --version)            - required to clone the plugin
   - OpenCode Desktop 2.2 or newer             - required; if it is missing or older, tell me to install or update it
                                                 from https://opencode.ai and stop
   - Node.js 18+    (node --version)           - only used to run the plugin's self-test in step 4
   - Python 3.9+    (python --version, or py -3 --version on Windows, or python3 --version)
   - LibreOffice    (soffice --version; on Windows look for "C:\Program Files\LibreOffice\program\soffice.exe")
   Python and LibreOffice are only needed for the slide_screenshot tool when the Slides panel is NOT open. The panel
   itself (view, edit, comment, Ask AI to edit) needs neither of them.
2. Install anything that is missing. Ask me for confirmation before installing system software, then use the
   platform's package manager:
   - Windows:  winget install --id Git.Git -e
               winget install --id OpenJS.NodeJS.LTS -e
               winget install --id Python.Python.3.12 -e
               winget install --id TheDocumentFoundation.LibreOffice -e
   - macOS:    brew install git node python
               brew install --cask libreoffice
   - Linux (Debian/Ubuntu): sudo apt update && sudo apt install -y git nodejs python3 python3-pip libreoffice-impress
     (use dnf or pacman equivalents on other distributions)
   Then install the Python packages: python -m pip install --upgrade python-pptx pymupdf
   (use `py -3 -m pip ...` on Windows or `python3 -m pip ...` on macOS/Linux).
   Do NOT run npm install and do NOT build anything - the built files (dist/viewer.js, gui-experimental.cjs) are
   already committed to the repository.
3. Clone https://github.com/aswanthwuhan/opencode-slides-plugin into OpenCode's global plugins folder:
   - macOS/Linux: ~/.config/opencode/plugins/opencode-slides
   - Windows: %USERPROFILE%\.config\opencode\plugins\opencode-slides
   If that folder already exists, run `git pull` inside it instead of cloning again.
4. Verify the install. The folder must contain index.js, gui-experimental.cjs and dist/viewer.js. Inside the plugin
   folder run `node dev/main.test.mjs` and report whether it prints "ALL OK". If LibreOffice and Python were
   installed, also run `python -I render/deck.py dev/sample.pptx <some empty temp folder>` and report whether it prints
   {"ok": true, ...}. If the plugin cannot find Python or LibreOffice later, they can be set in the plugin options
   (python, soffice) - tell me the full paths you found.
5. Finish by telling me to fully quit and reopen OpenCode Desktop, then open the panel with:
   side panel "+" > Slides > Open. Do not edit any other OpenCode configuration.

HOW TO ACTIVATE IN OPENCODE

1. Fully quit and reopen OpenCode Desktop after installing.
2. Open a session (any project).
3. In the right side panel, click + (new tab) and choose Slides.
4. Click Open and pick a .pptx file. The deck appears in the panel.
5. Click Edit for the full editor, or just click an element and type in the Ask AI to edit bar to send a change request to the model.

If Slides is missing from the + menu, check that the plugin folder is ~/.config/opencode/plugins/opencode-slides (it must contain index.js and gui-experimental.cjs), then restart OpenCode again, or use Extensions › Plugins › Reload. If the panel looks out of date after an update, quit and reopen OpenCode so the new editor script is loaded.

Develop

npm install --legacy-peer-deps   # viewer build deps (html2canvas-pro pinned via overrides)
npm run build:viewer             # viewer/app.jsx -> dist/viewer.js (~12 MB, loaded only when the panel opens)
bun run build                    # src/*.js + render/deck.py -> gui-experimental.cjs
node dev/main.test.mjs           # main process: render, watch, read/write, self-write suppression
node dev/bundle.test.cjs "$(pwd)/dev/sample.pptx"   # loads gui-experimental.cjs like the desktop host does (absolute path)
node dev/tool.test.mjs dev/sample.pptx              # slide_screenshot tool (LibreOffice fallback)

Browser test pages (serve this folder over http, for example python -m http.server 8765): dev/full.html (real viewer in the real panel shell; add ?w=1250 for the panel width), dev/viewer.html (viewer API), dev/harness.html (panel shell with a mock viewer).

File	Role
index.js	Server half: the slide_screenshot tool
src/gui.js	Panel registration, prompts to the model, screenshot routing
src/view.js	Panel shell (header, viewer iframe, Ask AI bar, autosave, shortcuts)
viewer/app.jsx → dist/viewer.js	Viewer/editor running inside the iframe, plus the compact-ribbon CSS
viewer/anim-icons.js	Per-animation icons for the Animations gallery
src/main.js, src/files.js, src/render.js	Desktop main process: read/write/watch decks, LibreOffice render
src/prompt.js, src/ipc.js, src/rpc.js	Message builder and window/main/server contracts
render/deck.py	.pptx → PNGs + shape boxes (LibreOffice + python-pptx + PyMuPDF)

Thanks

This plugin stands on the work of many people. Thank you to:

• The OpenCode team — for OpenCode, its desktop app and its plugin API.
• The pptx-react-viewer and ooxml-ui / ooxml-core authors and contributors — for the PowerPoint viewer and editor that runs inside the panel (pptx-react-viewer, Apache-2.0).
• The open-source libraries bundled in dist/viewer.js — React, Lit, Lucide, react-icons, i18next / react-i18next, jsPDF, html2canvas, JSZip, fflate, pako, fast-xml-parser, xmldom, DOMPurify, canvg, opentype.js, Yjs and lib0, ProseMirror, Framer Motion, three.js, core-js, Babel runtime and the many small utilities they depend on. Every one of them and its license is listed in THIRD_PARTY_NOTICES.md.
• The tools behind the screenshot fallback and the build — LibreOffice, python-pptx, PyMuPDF, Bun and Node.js.
• Anthropic's Claude — which helped design, write and test this plugin.
• Dr. Harshad Ramineni — for providing access to Claude, which made building this plugin possible.

License

MIT — see LICENSE. dist/viewer.js bundles third-party packages under their own licenses; see THIRD_PARTY_NOTICES.md.