Devpit keyboard shortcuts and mouse controls

Devpit is made for the keyboard, and the mouse works too. Press ? on any screen to see the keys for that screen.

The footer at the bottom of the window always shows the keys that work right now.

Keys that work everywhere

Key	What it does
`?`	Show or hide the shortcuts for this screen
`Esc`	Go back one screen. While a scan, delete, install or update is running, it stops the work instead
`Tab`	Go to the next section on the tab bar
`Shift`+`Tab`	Go to the previous section
`Ctrl`+`C`	Quit from anywhere. If work is running, Devpit asks it to stop first
`q`	Quit, from the main menu only

On a screen with a form, such as Git identity, Tab moves between fields and does not change section. While work is running, Tab does nothing.

Key	What it does
`1`	Free Up Disk Space
`2`	Fix Stuck Ports & Apps
`3`	Install Developer Apps
`4`	Update Everything
`5`	Network Tools
`6`	Git & SSH Setup
`7`	Devpit Settings
`8`	Share Files

The digits work on the main menu only, so a number you type in a form stays a number.

Menus and lists

These keys work in every menu and pick list.

Key	What it does
`↑` or `k`	Move up
`↓` or `j`	Move down
`Enter`	Choose the highlighted row
`Space`	Tick or untick a row, in lists that have tick boxes

Questions (the confirm box)

Every question starts on No.

Key	What it does
`y`	Yes
`n` or `Esc`	No
`←` `→` or `h` `l`	Move between No and Yes
`Enter`	Choose what is highlighted (No, unless you moved)

For Careful items, and for replacing an SSH key, you must type a word first: DELETE or OVERWRITE. Type it exactly, in capital letters, then press Enter. y alone does not work there. Esc cancels.

Free Up Disk Space

Key	What it does
`↑` `↓`	Move
`PgUp` `PgDn`	Move a page
`Space`	Tick or untick the row, or all rows under a project heading
`a`	Tick all, or untick all
`←` `→` or `h` `l`	Fold or unfold a group
`s`	Sort by size, name or age
`/`	Filter the list by text
`o`	Show only items older than the “older than” days (30 by default)
`Enter`	Continue, on screens that say so
`d`	Delete the ticked items (asks first)
`r`	Scan again
`R`	On the summary: retry items that something else had open
`Esc`	Stop a scan or delete, or go back

Fix Stuck Ports & Apps

Key	What it does
`0`–`9`	Type the port number
`Backspace`	Delete a digit
`Enter`	Check the port, or choose a tool
`Space`	Mark or unmark a row in a list
`k`	Kill the marked rows (asks first)
`t`	Turn “kill process tree” on or off, when it is offered
`r`	Refresh the list

Install Developer Apps and Update Everything

Key	What it does
`↑` `↓`	Move
`Space`	Tick or untick an app
`a` / `n`	Tick all / untick all (Update only)
`Enter`	Install or update the ticked apps, or finish on the summary
`l`	Show or hide the full log
`s` (twice)	While a run is going: skip the app that is installing or updating now. Press it a second time within 5 seconds to confirm
`Esc`	Stop the run

More in Install developer apps and Update everything.

Key	What it does
`↑` `↓` `Enter`	Choose Share a folder, Copy from a shared folder, Resume, or Clean up
`c`	On the sharing card: copy the `net use` line
`r`	On the sharing card: copy the `robocopy` line. After a copy that had failed files: try them again
`p`	On the sharing card: copy the password
`s` or `Esc`	On the sharing card: stop sharing (asks first)
`Tab`	In the sign-in form: switch between user name and password
`Enter`	Start the copy when Devpit says there is room, or resume a saved copy
`d`	On the resume question: throw the saved copy away. On a “signed in as someone else” error: close old connections to that PC
`Esc`	While copying: stop, and resume later

Network Tools

Key	What it does
`Enter`	Open a tool, start the ping, or go back when it is done
`y` / `n`	Answer the flush DNS question

Git & SSH Setup

Key	What it does
`Tab`	Switch between the name and email fields
`Enter`	Review your change, or go back when it is done
`c`	Copy the new public key

Settings

Key	What it does
`Enter` or `Space`	Change the highlighted setting
`Enter`	Save, in an edit screen
`a`	Add a path to the never-touch list
`x`	Remove a path or a recent folder
`Ctrl`+`R`	Reset the dev ports to the default list
`Esc`	Go back

First-run wizard

Key	What it does
`Enter`	Next step
`Esc` or `Backspace`	Previous step
`↑` `↓` `←` `→`	Choose an option
`y` / `n`	Yes or no, where the step asks a question

The mouse

The mouse is an extra. The keyboard does everything.

Action	What it does
Click a tab in the header	Jump to that section
Click a menu row	Open it, like pressing `Enter`
Hover a row on the main menu	Highlights it and shows its description
Click a tick box	Ticks or unticks that row, or everything under a project heading
Click a fold arrow	Folds or unfolds a group
Click a row	Moves the cursor there
Scroll wheel	Scrolls menus and lists

Your terminal must pass mouse events to Devpit. Windows Terminal does.

Window size

Devpit needs a window at least 80 columns by 24 rows. If it is smaller, Devpit tells you and waits. Resize the window and it redraws by itself.

Common questions

How do I see the shortcuts inside Devpit?

Press the question mark key on any screen. Devpit shows the keys for that screen and the keys that work everywhere. Press the question mark or Esc to close it.

How do I quit Devpit?

Press q on the main menu, or press Ctrl+C anywhere. If a delete or install is running, Ctrl+C asks it to stop first and Devpit leaves when the item in flight is finished. A second Ctrl+C leaves at once.

Does Devpit work with a mouse?

Yes. Click a tab or a menu row, click a tick box, scroll a list with the wheel, and hover a row on the main menu to read its description. The keyboard still does everything.

Why does Devpit say it needs a bigger window?

Devpit draws its screens in at least 80 columns by 24 rows. Make the terminal window bigger and it redraws by itself.