Skip to content

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.
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
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
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.

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

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.

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.

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 background
  • dark: Devpit aqua on a dark background
  • light: Devpit aqua on a light background
  • aqua: the house colour
  • blue: a calm blue accent
  • rose: a soft rose accent
  • mono: no colour at all, shapes and words only

Icon font installs or removes the icon font. It does what devpit font install and devpit font remove do.

  1. Open Icon font.
  2. Press Enter to install (or to remove, when it is installed).
  3. Close every Windows Terminal window and open a new one.
  4. Open Icon check and answer Yes if the icons show.

More about the font is in Getting started.

  • 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.
  1. Press a to add a path.
  2. Type the full path and press Enter.
  3. 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.

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 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
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.