https://github.com/user-attachments/assets/c827f059-cfd7-4f6a-bed3-8b00411a7220
Your desktop. Configured by your AI
Built-in CLI. Ready for your AI agent.
Tell your AI agent how you want your desktop to work. The bundled pecofence-cli lets Claude Code, Codex and Cursor read your current setup and apply changes directly in PecoFence.
- Configure it in your own words. Change themes, transparency, icon sizes and global settings, or adjust every fence at once.
- Organize once. Keep it organized. Create project fences, arrange icons and add rules that sort new files automatically.
- Save a setup you like. Use snapshots for fence layouts and configuration export/import for settings, rules and layouts.
Try it with your AI agent
Open PecoFence, then paste this request into your AI coding agent:
Use pecofence-cli to configure my desktop. First read pecofence-cli skill and pecofence-cli describe, then inspect my current settings and fences. Back up my configuration before changes. Switch to dark mode and make all fences more transparent.
The CLI is included. The Microsoft Store edition adds pecofence-cli to PATH. With the portable ZIP, give your agent the path to pecofence-cli.exe.
Put my desktop PDFs in a Docs fence, keep new PDFs there, switch to dark mode and make the fences more transparent.
pecofence-cli config export "$env:USERPROFILE\pecofence-before-ai.json"
pecofence-cli snapshot save before-cleanup
pecofence-cli fence create --title Docs
pecofence-cli rule add --name PDFs --ext pdf --to Docs --index 0
pecofence-cli rule apply
pecofence-cli settings set theme dark
pecofence-cli fence set --all opacity clear
Built for agents and scripts: describe exposes the command catalog and JSON Schemas; skill prints the agent guide. JSON results report what changed, and structured application errors help the agent choose its next step.
Get started with the CLI →
Give everything a place
See it in action
Find it as you type.
Press Ctrl + Alt + Space and type. Matching files and folders in your
fences show up at once, and Enter opens one. Chinese names can be found by pinyin too.
Everything is a free file search tool: turn on Everything search in Settings, and the whole
computer is searched as well. The clip uses Press Ctrl twice, which you can choose as the
shortcut in Settings.
The right folder in Open and Save dialogs.
In an Open or Save dialog, switch to File Explorer and back, and the dialog jumps to the folder
open there. Ctrl+G jumps there too, and a click on a folder fence goes to that fence's folder.
It is off by default, and PecoFence offers it the first time it can help. Even with it off,
Enter on a Peek search result works with the dialog: an Open dialog opens the file, a Save
dialog goes to its folder.
One fence. Multiple workspaces.
Keep related fences together as tabs. Switch from Project to Ideas in a click,
then drag a tab out when you want the extra room.
Your desktop, one shortcut away.
Press Ctrl + Alt + Space to bring your fences above the current application.
Grab what you need, then press Esc to return.
Animations from the user manual. GIFs loop automatically.
Small details that add up
| Feature | What you get |
|---|
| AI + CLI | pecofence-cli: Configure it in your own words. Change themes, transparency, icon sizes and global settings, or adjust every fence at once. |
| Less sorting | Rules for file types, extensions, names, wildcards, shortcut targets, time and size. New files find their fence automatically. |
| Glass that fits your desktop | Fluent and Liquid Glass themes, light/dark modes, per-fence colors, opacity and icon tinting. |
| Familiar file handling | File Explorer context menus, drag and drop, copy/paste, multi-select, thumbnails and icon/list/details views. |
| Keep folders close | Put a live folder on your desktop. Browse subfolders and see changes as they happen. The mouse's back button goes up a folder and forward goes back in. |
| Space when you need it | Roll a fence up to its title. Hover to expand. Lock a layout you like. Double-click the desktop to hide your fences. Double-click again to bring them back. |
| Small tools in fences | Notes with to-dos, a clock with the date, and script fences that show what your own script prints, such as the weather; their rows can open a link or tick a to-do when you click them. You can add them right away in Settings → Tools or from the tray menu. |
| A way back | Layout snapshots, daily backups, configuration import/export and swapping fences between displays. |
| Find a setting | Type in the box at the top of Settings (Ctrl+F) to find any setting by its words, by pinyin in a Chinese interface, or by a common other name such as startup, hotkey or dark mode. |
| A small footprint | A native Rust application that uses only about 2 to 5 MB of memory at rest in Task Manager. The WebView2 settings panel loads on demand. |
Automatic sorting rules keep files in their original locations. File moves you
initiate work like they do in File Explorer.
Explore the complete feature list →
Get PecoFence
The Microsoft Store edition is signed by Microsoft, updates automatically and never shows a SmartScreen prompt. The same app also comes as:
- Portable ZIP: download
pecofence-v<version>-x64-portable.zip from this repository's Releases page, extract the whole ZIP into a folder and run pecofence.exe.
- Installer:
pecofence-v<version>-x64-setup.exe on the same page installs PecoFence for your Windows user, with a Start menu entry and an uninstaller.
- winget:
winget install DayuanJiang.PecoFence installs the portable build and skips the SmartScreen prompt.
- Windows 10 22H2, or Windows 11 22H2 or later. Settings needs the Microsoft Edge WebView2 Runtime. Windows 11 includes it; on Windows 10 install it from Microsoft if Settings does not open.
- The first launch creates four fences in your selected language: Programs, Folders, Files and documents, and Desktop. Windows desktop icons are restored when you exit.
- Configuration lives in
%APPDATA%\PecoFence\config.json. Launch with --portable to keep it in a config folder beside the executable.
- The ZIP and the installer are unsigned. If Windows SmartScreen appears on first launch, choose More info → Run anyway.
Portable edition guide · Language guide · Windows installer guide
Build it. Make it yours.
PecoFence is Apache 2.0 licensed, and contributions are welcome, from a sharper translation
to a better desktop interaction.
Contribute · Improve a translation · Development guide
Code signing policy
Free code signing provided by SignPath.io, certificate by SignPath Foundation.
Only the files that GitHub Actions builds from a version tag of this repository are signed, and every signing request is approved by hand.
Privacy: This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it. Check for updates contacts the GitHub API. A message you send from Feedback goes to the PecoFence feedback service. The Settings window runs on Microsoft Edge WebView2, which follows the Microsoft Privacy Statement.
Made for a desktop you enjoy coming back to.
Apache License 2.0 · Third-party notices
Thanks to the LINUX DO community.
