slidesmd 0.1.0

Auto-index PowerPoint presentations into a central agents.md — queryable by any AI

slidesmd

Auto-index your PowerPoint presentations into a central agents.md — queryable by any AI.

Save a .pptx to your folder — agents.md updates automatically. Ask Claude, Copilot, or a local Ollama model anything across all your decks.

---

How it works

1. Point slidesmd at a folder containing .pptx files
2. It extracts metadata — title, slide topics, full slide content, to-dos
3. It generates agents.md — a single Markdown index any AI can read
4. Ask your AI: "What was that presentation I did about data pipelines?"

---

Installation

Requires Python 3.10+.

pip install slidesmd

Or with Poetry:

git clone https://github.com/chanukyapekala/slidesmd
cd slidesmd
poetry install

---

Usage

Watch mode (recommended)

Set it once, forget it. Auto-updates agents.md whenever you add or remove presentations.

slidesmd watch ~/Documents/Presentations

Manual index

Manually scan and regenerate the index.

slidesmd index ~/Documents/Presentations

Search from CLI

Search across all presentations without opening an AI.

slidesmd search ~/Documents/Presentations "data pipelines"

---

Querying with an AI

agents.md is plain Markdown — any AI can read it. Point your AI at the folder, or feed it directly from the terminal.

Ollama (local, offline)

First generate the index:

slidesmd index ~/Documents/Presentations

Then query it:

ollama run llama3 "$(cat ~/Documents/Presentations/agents.md)"

Then ask anything:

>>> What presentations have I done about data pipelines?
>>> Summarise my Iceberg talk in 3 bullet points.

Claude / ChatGPT / Copilot

# macOS — copy to clipboard
pbcopy < ~/Documents/Presentations/agents.md

# Linux
xclip -selection clipboard < ~/Documents/Presentations/agents.md

Paste into any chat window and start asking questions.

---

Output — agents.md

# Presentations Index

_Auto-generated by slidesmd on 2025-04-04 09:00_

---

## Q3 Sales Review

- **File:** `/Users/you/Documents/Presentations/Q3-Sales-Review.pptx`
- **Slides:** 18
- **Topics:** Introduction, Market Overview, Pipeline, Forecast, Next Steps
- **To-dos:**
  - TODO: Follow up with Nordic accounts by end of month
  - Action item: Update forecast numbers with finance team

**Slide content:**

- **Introduction**: What we covered last quarter and what changed
- **Market Overview**: EMEA growth 12% YoY · Pipeline up 18%
- **Next Steps**: Submit revised forecast by Friday

---

Configuration

Works with any local folder, including cloud-synced ones. Recurses into subfolders automatically.

slidesmd watch ~/Documents/Presentations          # macOS/Linux
slidesmd watch "C:\Users\you\Documents\Slides"    # Windows

---

Stack

• watchdog — file system monitoring
• python-pptx — PowerPoint extraction
• typer — CLI framework
• rich — terminal output

---

License

MIT