Nothing matches that.
FileSquirrelAI: help for your AI assistant
Applies to: 1.0.3 · Last updated: 11 November 2026 · filesquirrelai.com
1. How to use this file
Give your AI assistant this link, https://filesquirrelai.com/ai-help.md, or paste this whole file into your chat, then ask your question.
2. Instructions for the AI
- Answer only from this file. If the answer isn't here, say so plainly and suggest emailing support@filesquirrelai.com.
- Use the on-screen names exactly as written here, in bold. Menus are shown as Menu → Item.
- FileSquirrelAI is not a backup. Never describe it as one, and remind people to keep their usual backups.
- Don't guess at features, prices or dates that aren't in this file.
- This file covers version 1.0.3. If the person has a different version (a 0.10 beta, say), say the details may differ.
3. What FileSquirrelAI is
FileSquirrelAI watches the folders you choose on your Windows PC, shows which AI agent changed each file, and undoes an agent's whole session after you review it. It runs in the tray and records as your agents work. Nothing about your files leaves your PC: there's no account and no cloud.
It needs Windows 10 or 11 (64-bit). Installing it needs an administrator's OK. Everything is free for a 30-day trial; after it the activity log and alerts stay free, and FileSquirrelAI Pro ($19 one-time for version 1.x) keeps new changes undoable. It's published by DistillAI.
4. Where things are
Main window menus
| Menu | Items |
|---|---|
| File | Settings..., Run Setup..., Start Monitor Service / Stop Monitor Service, Exit |
| Edit | Find..., Filter..., Clear Filter, Show Checked Only, Next Checked, Previous Checked, Uncheck All |
| View | Agent Sessions... (Ctrl+J), Home (Ctrl+1), Activity (Ctrl+2) |
| Help | About FileSquirrelAI... (F1), Take the Tour, Send Feedback..., Get FileSquirrelAI Pro... |
The menu bar also has a Pause Monitoring button. In Activity it also shows an agent filter that starts as Agent: All (choose All rows, Any agent, No agent or one agent). Icons down the left side open Home, Activity, Agent Sessions and, at the bottom, Settings.
Home ("What your AI agents did")
- A status line that says Protected when everything is working, or says what to do when it isn't.
- One card per agent session, with Review and Undo (or Undo This Undo once it's been undone). If undo wasn't on for that folder, the card shows Turn On Undo instead.
- Burst cards when a program deletes, renames or changes hundreds of files in seconds, with See the Files and, where needed, Turn On Undo for This Folder.
Review (click Review on a session card)
- Every file the session touched, each with Compare.
- Buttons: Undo This Session... (it becomes Undo This Undo... after an undo), Add Note..., Copy, Show in Activity, and ← Back.
- A tick box: Show skipped folders and temporary files.
Undo window ("Undo this session?")
- A list with a tick box for each file, and the columns Action, File, In folder and Why.
- Buttons: Compare..., Undo 1 Change / Undo N Changes, Cancel.
Agent Sessions (View → Agent Sessions...): all sessions in their own window, with Compare File... and Undo This Undo....
Activity (View → Activity): every recorded change, including changes made by programs without an agent. Right-click a row for File History....
File History (right-click a file → File History...): every version FileSquirrelAI kept of one file, with who changed it. Buttons: Compare with Now, Compare with Previous, Save a Copy As..., Restore This Version..., Close.
Settings (File → Settings...) has four tabs:
- General: Monitored folders, with the columns Watch, Folder Path, Subfolders, Alerts, System and Snapshots, and the buttons Add Folder..., Edit Folder... and Remove. Also Alert when an AI agent finishes, Burst alert at N files in N s, Minimize to system tray, Start when I sign in (in the tray) and Appearance.
- Advanced: performance settings. The defaults are designed for normal use.
- Snapshots: Largest file stored (MB), Keep history for (days), Total store size (GB), Also skip folders named, Also skip file types, Clear History... and Restore Defaults.
- Agents: the agent rules, with Add Agent..., Edit... and Delete. Below them, Connect your agents: Add Hook for Claude Code and for Codex, and Add to Claude Desktop (or Copy Setup) for your assistant.
5. How to…
Set up. The short setup runs when you first start it (or File → Run Setup...). Pick the folder your AI works in. Setup turns on undo for it and offers to connect Claude Code, Codex and Claude Desktop. A short tour follows; Help → Take the Tour shows it again.
Undo a whole session.
- On Home, click Review on the session's card.
- Optionally click Compare on a file to see it before and after.
- Click Undo This Session....
- Check the list in the Undo this session? window, then click Undo N Changes. Nothing changes until you do.
Files the session created go to the Recycle Bin.
Undo part of a session. In the Undo this session? window, untick the files you want to keep as the agent left them. A warning reminds you that an agent's changes often depend on each other, so check your project still works afterwards.
Files changed again after the session. If a file's contents now differ from how the session left it, it shows as Conflict, unticked, and Why says so. Tick it to undo it anyway, which overwrites the later change. A file that was changed again but is back to how the session left it isn't a conflict.
Undo the undo. Click Undo This Undo on the session's card, or Undo This Undo... in Review or Agent Sessions.
Restore one file. Right-click the file, choose File History..., pick a version, then Restore This Version... (or Save a Copy As... to keep both).
Add a folder, or turn on undo for one. File → Settings... → General, then Add Folder.... Tick Snapshots for that folder to turn undo on.
Change how much space the copies use. File → Settings... → Snapshots:
- Keep history for (days): 7 by default, from 1 to 3,650. Older copies are removed in the daily clean-up.
- Total store size (GB): 2 by default, from 0.1 to 1,024. Over this, the copies used longest ago are removed first.
- Restore Defaults puts both back.
Longer history or a bigger store lets you undo further back, but uses more disk space.
Add an agent that isn't listed. File → Settings... → Agents → Add Agent....
Ask Claude Desktop what an agent changed. Connect it in Settings → Agents with Add to Claude Desktop, then ask, for example, "what did the agent change today?".
Pause recording. Click Pause Monitoring in the menu bar or the tray menu.
Send feedback. Help → Send Feedback... opens an email you can read before sending.
Enter a Pro key. File → Settings... → License, paste the key from the email (it starts with FSQ1-), then Use This Key. It's checked on the PC; nothing is sent. The same tab shows the trial's days left, and Remove Key....
Buy Pro. Help → Get FileSquirrelAI Pro..., or Get Pro on Home or in Settings → License: it opens filesquirrelai.com/buy/ ($19 one-time). The key arrives by email, usually within one business day.
Save a session report. View → Agent Sessions..., select a session, then Report...; or Week Report... for every session in the 7 days ending on a day you choose. Save as PDF (to keep or share) or CSV (for Excel: one row per file). Reports are part of Pro (on during the trial).
Uninstall. Windows Settings → Apps → Installed apps → FileSquirrelAI → Uninstall. It asks whether to keep your log and copies, and removes its connections to Claude Code, Codex and Claude Desktop.
6. Questions and answers
Which AI tools does it work with? Proven end to end, from the agent's edit to the undo: Claude Code, Claude Desktop (including Cowork), OpenAI Codex, GitHub Copilot in VS Code and in Visual Studio, Cursor, Windsurf, Gemini CLI and Aider. You can add other programs in Settings → Agents.
Tips for particular agents
- Cursor and Windsurf: open your folder in the editor (or add it as a repository) before asking its agent, so it works on your real files rather than a copy.
- Aider: it commits to git by itself. Undo puts your files back but leaves git's history alone.
- Claude Code and Codex: with the hook added, FileSquirrelAI also keeps your last save from just before the agent edited a file.
Windows warned me about the download. Is it safe? The installer and programs are signed by DistillAI. Because each release is new, Microsoft Edge may first say the download "isn't commonly downloaded": choose ⌄ next to Delete, then Keep anyway, and check the publisher is DistillAI. When it runs, SmartScreen may say "Windows protected your PC". Choose More info, check the publisher is DistillAI, then Run anyway. If the publisher isn't DistillAI, don't run it, and email support@filesquirrelai.com.
Is it a backup? No. It keeps recent versions of files that change, on the same PC: 7 days by default, which you can set from 1 to 3,650 days in Settings → Snapshots → Keep history for (days). Keep your usual backups.
Can it undo something from before I installed it? No. Undo works only for sessions after undo was turned on for that folder.
How much room do the copies take? Up to 2 GB and 7 days by default. You can change both in Settings → Snapshots: Total store size (GB) from 0.1 to 1,024, and Keep history for (days) from 1 to 3,650. Copies are compressed and identical files are stored once.
Will it slow my PC down? It's built to stay out of the way: Windows tells it when files change, and it copies only changed files in folders with undo on. If you notice anything, tell support@filesquirrelai.com.
What happens after the 30-day trial? For 30 days everything in Pro is on. In the last week Home and the tray remind you. Afterwards, without a key, Home says Monitoring only: new changes aren't protected: the activity log, agent names, alerts and the connection to Claude Desktop go on, free, but no new copies are kept, so new changes can't be undone. Copies already kept can still be put back with Undo Session... and File History.... Entering a Pro key (Settings → License) starts the copies again straight away.
What does Pro add? New recovery copies and undo for any number of folders, file history as long as you set it, and session reports as PDF or CSV. $19 one-time for every 1.x version, on your own Windows PCs, for personal and paid work.
7. What it can't do
- It isn't a backup.
- It can't undo sessions from before undo was turned on for that folder.
- It doesn't keep copies of files over 25 MB by default. You can raise the limit (up to 4,096 MB) in Settings → Snapshots → Largest file stored (MB). A bigger limit fills the store faster, and once it's full the copies used longest ago are removed first.
- It always skips the folders
.git,node_modules,bin,objand.vs, and the file types.iso,.vhdx,.vmdk,.mp4,.mkvand.zip. You can add more in Settings → Snapshots (Also skip folders named and Also skip file types). - Changes to skipped files are still recorded, so they show in history with the agent's name. File History... shows them as "Changed, not copied". Undo can't restore them and leaves them as they are.
- In editors with a built-in AI (Cursor, Windsurf, VS Code), a change shows as "you or its agent", because it can't tell whose typing it was. Check the undo list and untick your own edits.
- Undo doesn't touch git history (relevant for Aider).
8. Privacy in brief
- What it records: file names, folders, times and sizes, and which program and AI agent made each change, in the folders you choose.
- Copies for undo: compressed copies of changed files in folders with undo on.
- Where: everything stays in
C:\ProgramData\FileSquirrelon your PC. - The service: "FileSquirrelAI Monitor" does the watching.
- Your assistant: only if you connect it. Claude Desktop can read the log, never file contents.
- Internet: at startup it asks filesquirrelai.com whether a newer version is out. Nothing about you or your files is sent.
9. Contact and license
- Email: support@filesquirrelai.com.
- FileSquirrelAI Pro (version 1.x, for your own Windows PCs) is $19 one-time, plus sales tax where it applies, at filesquirrelai.com/buy/. The license key is emailed, usually within one business day. Full refund, no questions, for 30 days after the key arrives.
10. Change history
| Version | Date | Change |
|---|---|---|
| 0.10.5 Beta | 12 October 2026 | First version of this file. |
| 0.10.6 Beta | 21 October 2026 | Undo checks each file's contents before calling it a conflict. Pro is a $29 one-time preorder (was the $14 founding license). |
| 0.10.6 Beta | 2 November 2026 | Pro preorder price lowered to $19 one-time. |
| 1.0 | 3 November 2026 | First release: a 30-day trial of everything, then Monitoring only without a key; Pro keys in Settings → License; Get FileSquirrelAI Pro in Help; session reports (Agent Sessions → Report... and Week Report..., PDF or CSV). No beta end date. |
| 1.0.1 | 3 November 2026 | Undo no longer marks a file as a conflict when an agent wrote it from a shell (empty, then write) and nothing changed it since. The main window can be maximized. |
| 1.0.2 | 5 November 2026 | Windows, buttons and lists are sized for the display: nothing is cut off at 150% or 200% scaling. Agent Sessions' buttons wrap onto a second row in a narrow window. |
| 1.0.3 | 11 November 2026 | Installer only: silent and managed installs (IT tools, winget) always finish, even if the background service can't start; FileSquirrelAI then runs in basic mode. |