What Shoji does on your PC
Last updated 18 November 2026
Every day
- It starts with Windows. Shoji opens when you sign in to Windows and waits in the tray. To stop that, turn off Start with Windows in Settings, or turn Shoji off in Task Manager under Startup.
- It keeps your day in one file. Everything lives in
%APPDATA%\Shoji: your data file, plus aBackupsfolder with a copy once a week (the newest eight are kept). It stays there unless you pick a shared folder for it in Settings. - It checks for updates. A minute after it starts, then every six hours, Shoji asks downloads.getshoji.app for a new version. It downloads and checks one in the background, but installs it only when you click Restart.
- It listens for three shortcuts. Ctrl+Alt+H shows Shoji, Ctrl+Alt+I jots an idea and Ctrl+Alt+A adds a slot, from any app. If another app already uses one, Shoji leaves it alone. Change or turn off each one in Settings.
During a focus round
Focus mode is part of Shoji Pro. These changes happen only while a round is on, and only for the apps and sites on your lists.
- Blocking sites. Shoji points Windows' proxy setting (the one under Settings → Network → Proxy) at a small list on your own PC, so browsers turn your blocked sites away. When the round ends, the setting is put back how it was, including Automatically detect settings.
- A small local helper. While Shoji runs, it answers on your own PC only (127.0.0.1, port 47832). That's where the blocked page and the optional browser extension get their list. Web pages can't use it.
- The hosts file, only if needed. If the proxy setting can't be used, Shoji falls back to the Windows hosts file. Windows asks for your permission first, and again to clear it when the round ends. Say no and the sites simply aren't blocked that time.
- Closing apps. Every few seconds in a round, Shoji checks for the apps on your block list. It asks each one to close normally, and only makes it close if it's still open a few seconds later. Apps aren't closed in breaks.
- If something crashes. A small watcher starts with each round. If Shoji stops without tidying up, the watcher puts the proxy setting back. Next time Shoji starts, it also clears anything a round left behind. Nothing stays blocked by mistake.
To stop all of this, turn off focus mode in Settings. Your timer still works, it just doesn't block anything.
If you connect an AI
All of this is off until you switch it on, under Settings → Connections → AI assistants.
- A local connector. Shoji answers your AI app on your own PC only (127.0.0.1), and only with a secret key that Windows keeps encrypted for you. Web pages are turned away.
- An entry in your AI app's settings. To connect Claude desktop, Shoji adds one entry called “shoji” to Claude's settings file and copies a small helper next to Shoji's data. For Cursor, it adds the same entry to
.cursor\mcp.jsonin your user folder. For Claude Code, it runs Claude Code's ownclaude mcp add. It never touches your other entries. - Connecting through the web. ChatGPT and Claude on the web sign in to your Shoji account instead, so nothing extra goes on your PC.
To undo it, press Disconnect next to the app in Shoji. That takes the “shoji” entry back out. You can also switch the AI connector off altogether.
Uninstalling
Uninstall Shoji from Windows Settings → Apps, like any app. It takes the app, its start-up entry and its shortcuts with it. Your data in %APPDATA%\Shoji is kept, in case you come back. Delete that folder yourself if you'd like it gone, but take a backup first if there's anything in it you want.
Spotted something Shoji does that isn't on this page? Tell us at [email protected] and we'll add it.