YOUR DESKTOP, A LITTLE QUIETER
Ready when
your agent needs you.
Free for Claude Code and Codex on Windows 10 or 11. No Python install needed, and it keeps itself up to date.
Download and extract.
Save the Windows ZIP. Right-click it and select Extract All.
Install Vigil.
Run Install Vigil.bat. It installs the widget and connects it to your agents.
Restart your agent.
Open a fresh Claude Code or Codex session so it loads the hooks. Look for Vigil’s status dot above the taskbar.
That’s the last install.
New versions arrive inside the app. When one is ready, Vigil offers it once — you choose when to restart.
A few things to know.
Why do I need an account?
So we can tell you when something important changes. Your name and email are stored with our database provider and never sold or shared. Email about new versions is opt-in. Details are in the privacy policy.
How do updates work?
About once a day Vigil asks vigilit.app whether a newer version exists, sending only its own version number. If one does, the widget offers it; nothing installs until you click. Every update is signed, and Vigil refuses to install anything whose signature doesn’t verify.
Does it work with Codex or ChatGPT?
Yes for Codex — the Windows build includes the Codex adapter. After installing, run /hooks in Codex once and trust the Vigil entries; Codex requires that review and Vigil never skips it. Ordinary ChatGPT web chats are not supported. Codex guide.
Can I use it on a Mac?
There is an experimental macOS source port, but no tested Mac app yet. Mac build notes.
What does it cost my machine?
Measured on a Windows 11 laptop: the widget sits at about 55 MB of memory and 0.01% of one core while it waits. Vigil’s hook runs at turn boundaries — when an agent asks, finishes, or needs approval — never on every tool call, and each run takes around a quarter of a second, nearly all of it Windows starting the program. How that was measured.
Does Vigil actually save me time?
It keeps score so you can judge. Right-click the dot and choose What Vigil did… to see how long your agents spent waiting on you, how many approvals you answered without opening the terminal, how fast you answered, and how many pop-ups it chose not to show you. Those numbers are measured on your computer and stay there.
What data does Vigil keep?
Session state stays on your computer, in ~/.vigil. It can include project paths and tool details, and none of it is uploaded — nor are the timings behind “What Vigil did…”. The only thing the app sends is the daily update check.
I installed it but don’t see anything.
Restart your agent first. Look near the taskbar for the small status dot — quiet background work never triggers a pop-up. Project guide.