Install¶
Requirements¶
- Windows 11 with classic Outlook (not the new Outlook), signed in.
- An Exchange or Microsoft 365 mailbox. IMAP/POP-only profiles are not supported.
- No administrator rights are needed.
Install or update¶
Paste this into PowerShell:
The script downloads the latest release, checks ClippysRevenge.exe against the
release's SHA256SUMS.txt, installs it and starts it. Run the same line again to
update.
Clippy also updates itself once a week by default, so you only need the line above to install, to update at once, or to repair a broken install. To change how Clippy updates, see Settings, General, Updates.
It installs to %LOCALAPPDATA%\Programs\ClippysRevenge\, adds a Start menu
shortcut called "Clippy's Revenge", and starts the app. A paperclip appears in
the system tray. The app is set to start with Windows (you can turn that off in
the tray menu or in Settings).
The first start reads your mail from Outlook in the background: Sent Items first, then the Inbox, newest mail first within each folder. You can search the newest mail while it runs. See Indexing.
SmartScreen
The exe is not code-signed yet, so Windows SmartScreen warns the first time it runs. Choose More info, then Run anyway. The installer verifies the SHA-256 checksum of the download before it installs anything.
Preview first with -WhatIf¶
-WhatIf downloads and verifies the release but changes nothing on your PC:
& ([scriptblock]::Create((irm https://github.com/dirkpetersen/clippys-revenge/releases/latest/download/install.ps1))) -WhatIf
Install from a file¶
Download install.ps1 from the
latest release
and run it:
.\install.ps1 # same as the one-liner
.\install.ps1 -Source .\ClippysRevenge.exe # install a local build instead
.\install.ps1 -NoStart # install but don't launch
You can also download ClippysRevenge.exe from the release and run it directly.
| Option | Meaning |
|---|---|
-Source <path> |
Install a local ClippysRevenge.exe instead of downloading |
-NoStart |
Don't start the app after installing |
-WhatIf |
Show what would happen; on the download path, download and verify only |
-Uninstall |
Remove the app (see below) |
-Purge |
With -Uninstall: also delete settings, token, index and logs, without asking |
Uninstall¶
& ([scriptblock]::Create((irm https://github.com/dirkpetersen/clippys-revenge/releases/latest/download/install.ps1))) -Uninstall
This stops the app and removes the exe, the Start menu shortcut and the "Start
with Windows" entry. It then asks whether to delete your settings, token, index
and logs. Add -Purge to delete them without asking. If you answer no, they stay
on disk.
What gets stored where¶
| What | Where |
|---|---|
| Program | %LOCALAPPDATA%\Programs\ClippysRevenge\ClippysRevenge.exe |
| Settings, token and API key (encrypted) | %APPDATA%\ClippysRevenge\ |
| Index, logs and update state | %LOCALAPPDATA%\ClippysRevenge\ |
Short-lived files: an attachment waiting for its download link (links\, deleted after the download or when the link expires) and an attachment being read for an AI draft (ai-files\, deleted right after reading) |
%LOCALAPPDATA%\ClippysRevenge\ |
| Saved attachments | %USERPROFILE%\Downloads\Clippy's Revenge |
Your writing-style skill for AI drafts is stored
under %USERPROFILE%\.claude\skills\my-email-style, and your
facts file under
%USERPROFILE%\.claude\skills\my-email-context. The uninstaller removes neither.