Get started with Devpit on Windows

Devpit is a free terminal app for Windows 10 and 11. It runs on x64 and ARM64. This page takes you from nothing to your first scan.

Install Devpit

Pick one way. The first one is the easiest.

Option 1: the PowerShell one-liner

1. Open Windows Terminal or PowerShell.

2. Paste this line and press Enter.

   irm https://devpit.zubyr.dev/install | iex

3. Wait for the five steps to finish. The installer:

   1. finds the latest release on GitHub,
   2. downloads the zip for your PC (x64 or ARM64),
   3. checks its SHA256 checksum,
   4. puts devpit.exe in %LOCALAPPDATA%\Programs\devpit,
   5. installs the icon font.

4. The installer adds that folder to your user PATH. Open a new terminal window, or run the path it prints.

5. Type devpit and press Enter.

You do not need administrator rights. The installer never asks for them.

To skip the icon font, pass -NoFont. The iex command cannot take flags, so use a script block:

& ([scriptblock]::Create((irm https://devpit.zubyr.dev/install))) -NoFont

If Devpit is already installed, the installer asks what to do. Type U to update, R to remove, or C to cancel.

Option 2: Scoop

Scoop keeps Devpit up to date for you.

1. Add the bucket once:

   scoop bucket add zubyr https://github.com/zubairbinshaukat/scoop-bucket

2. Install:

   scoop install devpit

3. Type devpit.

Scoop does not install the icon font. Run devpit font install afterwards, or use Settings. See the icon font.

Option 3: the zip file

1. Open the latest release on GitHub.
2. Download the zip that matches your PC:
   • devpit_<version>_windows_amd64.zip for most PCs (x64)
   • devpit_<version>_windows_arm64.zip for ARM PCs
3. Unzip it. Inside is devpit.exe.
4. Put devpit.exe in a folder you like, for example C:\Tools.
5. To run it from anywhere, add that folder to your PATH.

You can also build it yourself. Devpit needs Go 1.26 or newer and no C compiler:

git clone https://github.com/zubairbinshaukat/devpit
cd devpit
go build -o devpit.exe .

Check your download (optional)

Each release has a checksums.txt file. To check a zip by hand:

Get-FileHash .\devpit_0.2.0_windows_amd64.zip -Algorithm SHA256

The hash must match the line for that file in checksums.txt. Releases also carry a build attestation. If you use the GitHub CLI you can check it:

gh attestation verify .\devpit_0.2.0_windows_amd64.zip --repo zubairbinshaukat/devpit

SmartScreen

Devpit is not code-signed yet. Windows SmartScreen may say the publisher is unknown the first time you run it. The checks above show that the file is the one GitHub built.

First launch

Type devpit in a terminal. Use a window at least 80 columns wide and 24 rows tall. Windows Terminal works best.

The first time, a short wizard asks four things. Press Enter to go forward and Esc to go back. Nothing is saved until the last step, so you can stop and start again.

1. Welcome. Shows what Devpit is and three promises: nothing is deleted without a preview and a confirmation, the default answer is always No, and nothing leaves your PC unless you turn usage stats on.
2. Icons. Shows a few icons and asks “Do these look like icons?”. Answer Yes only if you see icons and not boxes. If the installer put the font in, this starts on Yes. Terminals that can only show plain characters skip this step.
3. Theme. Pick a look. The screen repaints as you move, so you choose by looking. There are seven: auto, dark, light, aqua, blue, rose and mono.
4. Privacy. Usage stats. It starts on No. Read Safety and privacy to see exactly what would be sent.

Zoom

After the wizard you see the main menu.

Zoom

The menu has eight sections:

Key	Section	Guide
1	Free Up Disk Space	Free up disk space
2	Fix Stuck Ports & Apps	Fix stuck ports and apps
3	Install Developer Apps	Install developer apps
4	Update Everything	Update everything
5	Network Tools	Network tools
6	Git & SSH Setup	Git and SSH setup
7	Devpit Settings	Settings
8	Share Files	Share files

Move with ↑ and ↓, press Enter to open a section, and press Esc to go back. Press ? on any screen to see its keys. Press q on the main menu to quit. The mouse works too. See Keyboard and mouse for every key.

Your first clean-up

1. On the main menu press 1.
2. Choose Project Junk.
3. Pick the folder where your projects live.
4. Wait for the scan. Devpit lists what it found, with sizes.
5. Look at the list. Untick anything you want to keep.
6. Press d, read the question, and answer.

Nothing is deleted until you confirm. The default answer is No. The full steps are in Free up disk space.

The icon font

Devpit can draw small icons for folders, Git and Node. Windows Terminal does not ship a font with those icons, so Devpit uses a helper font. Without it, Devpit still works and shows plain shapes and letters.

What it is. The font is Symbols Nerd Font Mono, from the Nerd Fonts project. It contains only icons, no letters. Devpit downloads a fixed version from GitHub and checks its checksum before it installs anything.

What installing does.

1. Installs the font for your user only. It needs no admin rights.
2. Adds it to Windows Terminal as a fallback font. Your own font stays the main font.
3. Saves a copy of your Windows Terminal settings.json first, next to it, with the ending .devpit-bak.

After installing, close all Windows Terminal windows and open one again.

Install it. Any one of these:

• The installer does it for you, unless you used -NoFont.
• Run devpit font install.
• Open Devpit, go to Settings, and choose Icon font.

Check it.

devpit font status

Remove it.

devpit font remove

This removes the font and puts your old Windows Terminal settings back. The uninstall choice in the installer does this too.

If your icons still look like boxes, see Troubleshooting. You can always turn icons off in Settings and use the plain shapes.

Update Devpit

Devpit checks GitHub once a day for a newer version. When there is one, a small update label appears in the header. Nothing is downloaded or replaced for you.

To update:

• Installed with the one-liner: run the same line again and type U.
• Installed with Scoop: run scoop update devpit.

Settings, then About Devpit, shows the right command for your install. You can turn the check off in Settings. See What’s new for what each release changed.

Uninstall Devpit

• Installed with the one-liner: run the install line again and type R. It removes Devpit, the icon font and its PATH entry. Your settings are left alone.
• Installed with Scoop: run scoop uninstall devpit.
• Zip file: delete devpit.exe.

Settings stay in %APPDATA%\devpit. Delete that folder if you want them gone too.

Next steps

• Free up disk space: the feature most people come for.
• Safety and privacy: how deleting is protected.
• All features: one short guide for each section.