Install
Install Theodore
Paste one sentence into your assistant. It sets itself up in your user folder, with no admin rights.
Set up Theodore for me: https://theodoreand.ai/install.mdAfter you sign in, your Get started page shows the same sentence with a one-time code in it, so this computer is signed in as it installs. Without a code, the installer opens a browser sign-in instead.
From one sentence to a working install
Paste the sentence into your assistant.
Open Claude Code or Codex and paste the sentence. The assistant reads the install page, which tells it the exact commands to run and nothing else.
curl -fsSLo /tmp/theodore-install.sh https://theodoreand.ai/install.sh && sh /tmp/theodore-install.shIt sets itself up in your user folder.
The installer registers Theodore in the assistants it finds, downloads its own runtime and the engine, and fetches the asset packs in the background. No admin rights, and no Python or Node to install first.
curl -fsSLo /tmp/theodore-install.sh https://theodoreand.ai/install.sh && sh /tmp/theodore-install.sh- Theodore registered in Claude Code
- Asset packs in the background
- Checked with theodore doctor
Your account shows the computer as connected.
The Get started page in your account ticks Connected by itself. Start a new session and ask for a deck.
curl -fsSLo /tmp/theodore-install.sh https://theodoreand.ai/install.sh && sh /tmp/theodore-install.sh- Theodore registered in Claude Code
- Asset packs in the background
- Checked with theodore doctor
Your assistant
Pick your assistant
Status per assistant and per system. Supported means it has passed our install and deck checks; in testing means those checks are still under way.
Claude Code
- macOSSupported
- WindowsIn testing
- LinuxIn testing
Open Claude Code in the folder you work in and paste this sentence. It reads the install page and runs the installer for you.
Set up Theodore for me: https://theodoreand.ai/install.mdOr, in a terminal, register the plugin for Claude Code only:
claude plugin install theodore --marketplace https://theodoreand.ai/marketplace.jsonInstalled with the Claude Code or Codex command alone, Theodore downloads the same files on first use and asks for one browser sign-in.
Other ways to install
If you prefer a terminal, these do the same as the sentence. Each installs into your user folder and needs no admin rights.
- Any assistant, macOS or LinuxmacOS: supportedLinux: in testing
curl -fsSLo /tmp/theodore-install.sh https://theodoreand.ai/install.sh && sh /tmp/theodore-install.sh - Any assistant, WindowsWindows: in testing
curl.exe -fsSLo "%TEMP%\theodore-install.cmd" https://theodoreand.ai/install.cmd && "%TEMP%\theodore-install.cmd" - Claude Code only
claude plugin install theodore --marketplace https://theodoreand.ai/marketplace.json - Codex only
codex plugin marketplace add Theodore-and/theodore-plugin && codex plugin add theodore@theodore
Installed with the Claude Code or Codex command alone, Theodore downloads the same files on first use and asks for one browser sign-in.
Installer SHA-256
Published with the first release (to be confirmed).
What you need
- macOS 13.5 or later, Apple silicon or IntelSupported
- Windows 10 version 1803 or later, x64In testing
- Linux x64 or arm64 with glibc 2.28 or laterIn testing
- Your own subscription to the assistant you use. Theodore does not include model usage.
- On a Mac with Apple silicon: about 90 MB to download before your first deck, then 94 MB of asset packs in the background; about 550 MB on disk in your user folder. The runtime for each system is in the table below.
What is installed, and where
Everything Theodore owns is in one folder in your user account: ~/.theodore on macOS and Linux, %LOCALAPPDATA%\Theodore on Windows. All your assistants share it. If the folder already holds anything else, Theodore never reads, changes or deletes it.
| Folder | What it holds | Size |
|---|---|---|
bin/ | The launcher, at one stable path | under 100 KB |
runtime/ | Python, the engine's packages, Node and its modules | 357 to 466 MB by system (84 to 111 MB to download) |
engines/ | The PowerPoint engine; up to four versions are kept | about 9 MB each (about 2.3 MB to download) |
packs/ | Icon, flag, map and background libraries | 144 MB (94 MB to download) |
tools/libreoffice/ | LibreOffice for slide previews, only on a Mac or Windows computer that has none | about 800 MB (about 300 MB to download) |
client/, plugin/, state/, logs/ | The client, a copy of the plugin, sign-in and update state, logs | a few MB |
The runtime on each system
| System | To download | On disk |
|---|---|---|
| macOS, Apple silicon | 88 MB | 402 MB |
| macOS, Intel | 93 MB | 407 MB |
| Windows, x64 | 84 MB | 357 MB |
| Linux, x64 | 111 MB | 466 MB |
| Linux, arm64 | 101 MB | 445 MB |
Plus the engine (about 2.3 MB to download) and the asset packs (94 MB to download, 144 MB on disk).
Outside that folder
- Your assistants keep their own copy of the plugin (text files) where they keep every plugin.
- The sign-in credential: in the macOS Keychain, or a protected file in your user folder when the Keychain is not available (for example over SSH); on Windows, a file protected with DPAPI for your user; on Linux, a file only you can read.
- The engine's render cache in your user cache folder.
- One small file, .pptx-state/theodore-engine.json, in each deck folder, naming the engine version that started it.
- Only if you say yes when the installer asks: two entries in Claude Code's settings, for automatic plugin updates and to run Theodore without a prompt.
Slide previews use LibreOffice when your computer already has it, and an installed PowerPoint on Windows. Otherwise, on macOS and Windows, Theodore fetches LibreOffice into its own folder, unmodified from The Document Foundation and checked against a pinned SHA-256.
On Linux, Theodore does not fetch LibreOffice: install it with your system's package manager to get slide previews.
Nothing is installed system-wide and nothing runs in the background once setup has finished. Theodore runs only when your assistant calls it.
How to remove it
One command removes the plugin from Claude Code and Codex, the optional settings entries, the keychain item, the render cache and every folder Theodore created.
- macOS and Linux
~/.theodore/bin/theodore uninstall - Windows
"%LOCALAPPDATA%\Theodore\bin\theodore.cmd" uninstall
Left afterwards: anything in the folder Theodore did not put there, the small file in your deck folders, Claude Code's cached copy of the plugin (it deletes it itself after 14 days), the installer you downloaded (/tmp/theodore-install.sh, or %TEMP%\theodore-install.cmd on Windows; delete it if you like) and your account. Remove the computer, or the whole account, in your account settings.
On a corporate laptop
- Theodore installs into your user folder without admin rights, without a package manager and without Python or Node installed first. It brings its own runtime.
- Slide previews use LibreOffice when your computer already has it, and an installed PowerPoint on Windows. Otherwise, on macOS and Windows, Theodore fetches LibreOffice into its own folder, unmodified from The Document Foundation and checked against a pinned SHA-256. On Linux, Theodore does not fetch LibreOffice: install it with your system's package manager to get slide previews.
- A company proxy that inspects traffic works when its root certificate is installed on the computer. When it is not, Theodore stops and says so rather than connecting insecurely.
- If your laptop only runs programs IT has approved, Theodore cannot run there yet.
- The security page lists what is sent, what never leaves the computer and where credentials live, so you can send it to IT.