Leclaude shows a robot badge in Windows Explorer on each folder that has Claude Code session history. When you look through your disk, you can immediately see the folders where you did work with Claude Code.
Leclaude is a shell extension for Windows 10 and Windows 11, on x64 and ARM64.
Claude Code records each opened folder in %USERPROFILE%\.claude\projects\
. Leclaude registers an icon-overlay handler with Explorer. For each visible folder, the handler does one fast search in a set in memory. When the folder has session history, Explorer draws the robot badge on the folder icon. A watcher thread follows the Claude Code data and refreshes the badges.
The design documents give the full details:
The releases page gives a setup program and a zip file for each processor: x64
or arm64
.
The setup program is the recommended installation:
- Download
LeclaudeSetup-<version>-<processor>.exe
. - Start it and give permission. The installer registers the handler and restarts Explorer.
To remove Leclaude, use "Installed apps" in the Windows settings.
The zip file is the manual alternative:
- Download and unpack
Leclaude-<tag>-<processor>.zip
. - Do a double click on
install.cmd
and give permission.
To remove this installation, do a double click on uninstall.cmd
.
The MSI package (Leclaude-<version>-<processor>.msi
) gives the same installation for winget and for managed deployment.
Windows SmartScreen can show a warning, because the files have no signature. If Windows shows the warning, select "More info", then "Run anyway". The attestation check below is the correct test that a file is authentic.
The release workflow attests each zip file with GitHub artifact attestation. Sigstore signs the attestation. To do a check on a setup program or a zip file, enter:
gh attestation verify <file> --owner robinduckett
The command shows the workflow and the commit that made the file.
The build uses CMake with the Ninja generator. Visual Studio contains both tools.
-
Open a Developer PowerShell for Visual Studio.
-
Enter:
cmake --preset x64-release -
Enter:
cmake --build --preset x64-release -
To do the tests, enter:
ctest --test-dir build/x64-release --output-on-failure -
The installation needs administrator rights. Windows accepts overlay registrations in HKLM only.
-
Windows shows a maximum of 15 overlay types for the full system. Cloud-storage tools use many of them. When too many tools compete, Windows can ignore the Leclaude badge. The ShellExViewtool shows the competition on your system. - In a cloud sync folder (for example, a OneDrive folder), Windows 11 can hide third-party badges.
The badge shows an old icon after an update, but only at some sizes: Explorer keeps the icons in cache files on the disk, with one file for each size. An Explorer restart does not delete these files. To delete them, enter these commands in PowerShell:
Stop-Process -Name explorer -Force
Remove-Item "$env:LOCALAPPDATA\Microsoft\Windows\Explorer\iconcache_*.db" -Force -ErrorAction SilentlyContinue
if (-not (Get-Process explorer -ErrorAction SilentlyContinue)) { Start-Process explorer.exe }
A restart of the computer also corrects this.
The badge does not show at all:
Windows shows a maximum of 15 overlay types. Use the ShellExView tool to see the loaded handlers.
Make sure that the name " Leclaude" is in the first 15 names under the registry key ShellIconOverlayIdentifiers
.
MIT. See LICENSE.