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.
A fence that fills itself.
A smart fence shows the live result of a saved search. Pick a template such as
Downloads of the last 7 days and click Create: new files that match show up by
themselves, and the files stay where they are.
Notes, a clock and your own scripts.
Add them in Settings → Tools: a note whose lines that start with [ ] become to-dos, a clock
with the date, and script fences that show what a script prints, such as the weather.
More in the manual: a set of fences for each virtual desktop (GIF),
desktop icons that stay where you put them (GIF) and
Ctrl+Z to take back the last step (GIF).
Animations from the user manual. GIFs loop automatically.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
