Devpit settings, themes, icons and the never-touch list
Open Devpit Settings from the main menu with 6. Changes save as soon as you make them, and the row says ✓ saved for a moment.
The settings are in seven groups: This PC, Look, Cleaning, Tools, AI agents, Privacy and updates and About. Each row shows its name on the left and its current value on the right. The row you are on is explained in plain words: under the list, or in a pane on the right when the window is at least 100 columns wide.
There are three kinds of rows:
- Choices such as Theme, shown as
‹ auto ›. ← and → pick the one before or after, and Enter or Space picks the next. - On and off switches such as Emoji. Enter, Space, ← or → flip them.
- Rows that open a screen, marked
›. Enter or Space opens it.
The settings
Section titled “The settings”This PC
Section titled “This PC”| Setting | What it does | How it changes |
|---|---|---|
| PC specs | A read-only page about this PC: battery health, memory slots, drives, screen, Windows and more, with a Buyer’s check at the top. It changes nothing on the PC. | Opens a screen |
PC specs is the first row of Settings. See PC specs for what it shows, its keys and what it keeps private.
| Setting | What it does | How it changes |
|---|---|---|
| Theme | The colours Devpit uses. auto follows your terminal, light or dark; dark and light pick one. aqua, blue and rose change the accent colour, and mono uses no colour at all, only shapes and words. |
Choice |
| Icons | The symbols Devpit draws. unicode works in every modern terminal. nerd adds file and tool icons but needs the icon font. ascii uses plain letters for old consoles. auto picks for you. |
Choice |
| Emoji | An emoji now and then in titles and summaries. Never in lists or tables, so columns always line up. | On or off |
| Icon font | Installs the free Symbols Nerd Font for your Windows user (no admin needed) and adds it to Windows Terminal as a fallback, so nerd icons can draw. Your own font stays as it is. | Opens a screen |
| Icon check | Shows a few icons and asks whether they look right. Nerd icons are only used after you say yes. | Opens a screen |
Cleaning
Section titled “Cleaning”| Setting | What it does | How it changes |
|---|---|---|
| Projects folder | The folder Free Up Disk Space looks through first, usually where you keep your code. It also lists the folders you scanned lately, so you can remove one. | Opens a screen |
| Never-touch folders | Folders Devpit never scans and never deletes from, whatever is inside them. Devpit’s own files and login folders such as .ssh and .claude are protected anyway. |
Opens a screen |
| Recent projects | A project you changed in the last 7 days (the default) counts as in use. Its junk is still listed but never ticked for you. | Opens a screen (1 to 365 days) |
| Age filter | In the cleaning results, the age filter shows only folders nobody touched for more than this many days (default 30). | Opens a screen (1 to 365 days) |
| Forget last scan | Devpit remembers the last scan so results show up at once next time. This clears that memory, so the next scan reads the disk from scratch. Nothing on disk is deleted. | Asks first (default No) |
| Setting | What it does | How it changes |
|---|---|---|
| Package manager | Which installer Install & Update uses for new apps. auto uses Scoop if you have it, then winget, then Chocolatey. Pick one to always use it. |
Choice |
| Dev ports | The ports Busy dev ports looks at in Ports & Network. Add your own, or go back to the defaults. | Opens a screen |
AI agents
Section titled “AI agents”| Setting | What it does | How it changes |
|---|---|---|
| AI agent skill | Lets Claude Code use Devpit for you: check which account a folder uses and explain why. It never changes anything without your yes. | Opens a screen |
The value says installed, installed (shared link), update available, another skill is there or not installed. When Claude Code is not on this PC, the group shows one line instead: “Claude Code is not installed, so there is no skill to add.” See the AI agent skill screen below.
Privacy and updates
Section titled “Privacy and updates”| Setting | What it does | How it changes |
|---|---|---|
| Usage stats | When on, Devpit sends one small report after a cleanup: space freed and how many items. Never a file name, a path or anything about you. Off unless you turn it on. | On or off |
| Update check | When on, Devpit asks GitHub once a day whether a newer version is out, and says so at the top. It sends nothing about you and never installs anything by itself. | On or off |
| Setting | What it does | How it changes |
|---|---|---|
| About Devpit | The version you are running, who makes Devpit, links to the website and the source, and the one command that updates your install. | Opens a screen |
| What’s new | What changed in this version and where things moved: the same card Devpit shows once after an update. See After an update. | Opens a screen |
The AI agent skill
Section titled “The AI agent skill”AI agent skill opens a screen that says:
- What it lets Claude Code do: check which account each tool uses in a folder and explain why, by running Devpit’s read-only commands and reading its help pages. It can suggest a change and make it once you agree.
- What it never does: it never changes anything without your yes, and never reads account folders, login files or tokens.
- Where it goes: each Claude Code account and the state of the skill there.
Below that are the buttons that apply: Install, Update or Remove.
Move between them with ← → and press Enter, or press i to install or update and x to remove.
Each one asks first, with No as the default, and then shows what happened in each place.
A devpit skill that Devpit did not write is never touched.
The same can be done from a terminal with devpit agent install, devpit agent status and devpit agent remove.
Using Devpit with AI agents explains what the skill contains.
Forget last scan
Section titled “Forget last scan”Devpit keeps the results of the last disk scan so they show up at once the next time. Forget last scan asks “Forget the last scan?” and starts on No. Yes clears only that memory: the next scan reads the disk from scratch. Nothing on disk is deleted.
Themes and icons
Section titled “Themes and icons”Devpit has three icon sets and picks one for you.
| Icon set | What you see |
|---|---|
nerd |
Real icons for folders, Git, Node and more. Needs the icon font. |
unicode |
Plain shapes and check marks. Works in most terminals. |
ascii |
Only basic characters. For very simple terminals. |
You can also start Devpit with devpit --ascii to force the plain set for one run.
The seven themes:
auto: follows your terminal’s backgrounddark: Devpit aqua on a dark backgroundlight: Devpit aqua on a light backgroundaqua: the house colourblue: a calm blue accentrose: a soft rose accentmono: no colour at all, shapes and words only
The icon font
Section titled “The icon font”Icon font installs or removes the icon font.
It does what devpit font install and devpit font remove do.
- Open Icon font.
- Press Enter to install (or to remove, when it is installed).
- Close every Windows Terminal window and open a new one.
- Open Icon check and answer Yes if the icons show.
More about the font is in Getting started.
Folder settings
Section titled “Folder settings”Projects folder
Section titled “Projects folder”- The first row is the default folder. Press Enter to edit it. It must exist. Network paths are not allowed.
- Below it are your recent folders. Press x to remove one.
Never-touch folders
Section titled “Never-touch folders”- Press a to add a path.
- Type the full path and press Enter.
- Press x on a row to remove it.
Devpit skips these folders when scanning and refuses them when deleting.
It also protects itself: it refuses to delete anything that holds devpit.exe.
Dev ports
Section titled “Dev ports”The list is one line of numbers and ranges, for example 3000-3010, 5173, 8080.
Press Enter to save.
Press Ctrl+R to go back to the default list.
The default is 3000 to 3010, 4200, 5000, 5173, 5174, 8000, 8080, 8081, 8888, 9000 and 19000 to 19006.
Usage stats and updates
Section titled “Usage stats and updates”Usage stats are off until you turn them on. They send totals only, never file names or paths. Read exactly what is sent on Safety and privacy.
Update check looks at GitHub’s public releases once a day.
It shows an update label in the header when a newer version exists.
Nothing is downloaded for you.
These environment variables always win over the settings:
| Variable | Effect |
|---|---|
DEVPIT_NO_TELEMETRY=1 or DO_NOT_TRACK=1 |
Usage stats off |
DEVPIT_NO_UPDATE_CHECK=1 |
Update check off |
DEVPIT_CONFIG_DIR |
Use another folder for config.toml |
DEVPIT_CACHE_DIR |
Use another folder for caches and logs |
Where files are kept
Section titled “Where files are kept”| What | Where |
|---|---|
| Settings | %APPDATA%\devpit\config.toml |
| Caches and logs | %LOCALAPPDATA%\devpit\ |
If the settings file is damaged, Devpit renames it to config.toml.broken-<number>, starts with the defaults and shows a warning.
Your old file stays so you can look at it.
| Key | What it does |
|---|---|
| ↑ ↓ | Move (headings are skipped) |
| Home / End | First or last setting |
| PgUp / PgDn | Half a page up or down, when the list is taller than the window |
| Enter / Space | Change the row, or open its screen |
| ← → | The choice before or after; flip an on/off row |
| a | Add a path (never-touch folders) |
| x | Remove a path or folder; remove the skill (AI agent skill) |
| i | Install or update the skill (AI agent skill) |
| Ctrl+R | Reset dev ports to the default |
| Esc | Go back |
PC specs has its own keys: see PC specs.
With the mouse: pointing at a row selects it and shows its description, a click on a row’s value changes it (or opens its screen), and the wheel moves through the list.
See Keyboard and mouse for every key.
Common questions
Where are Devpit's settings stored?
In one file, %APPDATA%\devpit\config.toml. Set the DEVPIT_CONFIG_DIR environment variable to use another folder. Changes in the app are saved as soon as you make them.
How do I turn usage stats off?
Open Settings and switch Usage stats to off. Setting the environment variable DEVPIT_NO_TELEMETRY=1 or DO_NOT_TRACK=1 turns them off whatever the setting says. Stats are off by default.
How do I protect a folder from being cleaned?
Add it to the never-touch list in Settings. Devpit skips it when scanning and refuses it when deleting. Devpit also refuses to delete the folder that holds its own program file.
Icons show as boxes. What should I change?
Set Icons to unicode or ascii in Settings to use plain shapes. Or choose Icon font to install the icon font, restart Windows Terminal, then run Icon check.
What happens if my settings file is damaged?
Devpit renames it to config.toml.broken with a number, starts with defaults and shows a warning. Your old file is kept so you can look at it. A settings file written by a newer Devpit is refused, not half applied.
