Theodore plugin
Theodore builds, edits and translates PowerPoint decks inside the AI assistant you already use (Claude Code,
Codex and others), with a consultant's design method. This repository is the small public part: two small
loaders, a launcher, an installer and the client that keeps Theodore's runtime and engine current on your
computer. It holds no engine code and no design instructions; those are delivered to signed-in accounts.
Theodore is in beta. Accounts: https://theodoreand.ai
Install
The simplest way is the sentence on your Theodore home page at theodoreand.ai (after you log in), sent to your assistant.
On Windows, Claude Code needs Git for Windows (it provides Git Bash) to load Theodore: install it from
git-scm.com first. Without it Claude Code runs commands in PowerShell, and Theodore cannot load.
By hand:
| Assistant | Command |
|---|
| Any, macOS or Linux | ( d=$(mktemp -d) && curl -q --proto '=https' -fsS -o "$d/install.sh" https://theodoreand.ai/install.sh && sh "$d/install.sh"; rc=$?; rm -rf "$d"; exit $rc ) |
| Any, Windows (PowerShell) | $d = Join-Path $env:TEMP ("theodore-" + [guid]::NewGuid()); $null = New-Item -ItemType Directory -Path $d -ErrorAction Stop; curl.exe -q --proto =https -fsS -o "$d\install.cmd" https://theodoreand.ai/install.cmd; if ($LASTEXITCODE -eq 0) { & "$d\install.cmd" }; Remove-Item -Recurse -Force $d -ErrorAction SilentlyContinue |
| Any, Windows (cmd) | cmd /d /v:on /c "set D=%TEMP%\theodore-!RANDOM!!RANDOM!!RANDOM!&& mkdir "!D!" && curl.exe -q --proto =https -fsS -o "!D!\install.cmd" https://theodoreand.ai/install.cmd && call "!D!\install.cmd" & rmdir /s /q "!D!" 2>nul" |
| Claude Code only | claude plugin install theodore --marketplace https://theodoreand.ai/marketplace.json |
| Codex only | codex plugin marketplace add Theodore-and/theodore-plugin then codex plugin add theodore@theodore (the installer above registers Codex from its own copy, the same as codex plugin marketplace add ~/.theodore/plugin) |
No admin rights, no Homebrew, winget, pip or npm. Supported: macOS 13.5 or later (Apple silicon and Intel),
Windows 10 version 1803 or later (x64), Linux x64 and arm64 with glibc 2.28 or later.
What gets installed, and where
Everything Theodore owns is in one folder per user: ~/.theodore on macOS and Linux,
%LOCALAPPDATA%\Theodore on Windows (THEODORE_HOME overrides it). All assistants on the computer share it.
Theodore creates and manages only the subfolders listed here. If the folder already exists and holds anything
else, Theodore never reads, changes or deletes it. The folder belongs to the Theodore service it was set up for
(state/environment names it): a build for another service refuses it and says so; give that build its own folder
with THEODORE_HOME, or uninstall the other first.
| Path | What it is | Size |
|---|
bin/theodore, bin/theodore.cmd, bin/launcher.json | The launcher, at one stable path | under 100 KB |
client/<version>/ | The client (Python source) | under 1 MB |
runtime/<id>/ | Python 3.12, the engine's Python packages, Node 24 and its modules | about 358 to 466 MB (84 to 111 MB to download; table below) |
engines/<version>/ | The PowerPoint engine (compiled for your platform when available); up to four versions are kept | 43 to 58 MB each (15 to 21 MB to download) |
packs/ | Icon, flag, map and background libraries | about 145 MB (about 95 MB to download) |
tools/libreoffice/ | LibreOffice, only on a Mac or Windows PC that has none (it renders slide previews) | about 800 MB (about 300 MB to download) |
plugin/ | A copy of this repository's plugin, which Codex adds as a local marketplace | under 100 KB |
state/ | Sign-in state (see below), update state, locks | a few KB |
logs/, staging/ | Client log; downloads in progress | small |
In all, about 100 to 130 MB is downloaded before the first deck (the runtime, 84 to 111 MB, and the engine, 15 to
21 MB) and about 95 MB of asset packs follow in the background; a full install takes about 560 to 670 MB on disk
(runtime, packs, one engine), plus LibreOffice where it is fetched. Engine sizes are those of the compiled
1.0.0-rc.2 builds (download, then unpacked): macOS Apple silicon 14.6 / 42.7 MB, macOS Intel 16.5 / 45.9 MB,
Windows x64 17.9 / 54.6 MB, Linux x64 21.2 / 58.5 MB, Linux arm64 18.5 / 48.9 MB. The runtime by platform (runtime b77f7d4ca2d43955, built by ci/run.sh):
| Platform | Download | On disk |
|---|
| macOS, Apple silicon | 88.3 MB (84.2 MiB) | 402.3 MB (383.6 MiB) |
| macOS, Intel | 93.2 MB (88.9 MiB) | 407.0 MB (388.2 MiB) |
| Windows x64 | 83.8 MB (79.9 MiB) | 358.1 MB (341.5 MiB) |
| Linux x64 | 111.2 MB (106.0 MiB) | 465.5 MB (444.0 MiB) |
| Linux arm64 | 100.7 MB (96.0 MiB) | 445.0 MB (424.4 MiB) |
Outside that folder:
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
