Getting started

Install

Install the desktop app, the CLI, or both. The desktop app is a menu bar app on macOS, and a tray app on Windows and Linux. The CLI is one binary, everyport, with a terminal UI, for servers, VMs and containers.

To install both with one command:


curl -fsSL https://everyport.dev/install.sh | sh          # macOS and Linux
irm https://everyport.dev/install.ps1 | iex               # Windows (PowerShell)

Or install each one separately:

	Desktop app	CLI
macOS	`brew install --cask greenfield-inc/tap/everyport`	`brew install greenfield-inc/tap/everyport`
Windows	`.msi` or `-setup.exe` from Releases	`irm https://github.com/greenfield-inc/everyport/releases/latest/download/install.ps1 \| iex`
Linux	`.deb`, `.rpm` or `.AppImage` from Releases	`curl -fsSL https://github.com/greenfield-inc/everyport/releases/latest/download/install.sh \| sh`

See CLI only for npm.

The desktop app

Open Everyport. On macOS, its menu bar icon shows how many servers are running.
Click the icon, or press ⌥ ⌘ P (Ctrl Alt P on Windows and Linux) from any app. A small window, the popover, opens under the icon.
The popover lists every dev server on this computer. The top shows the memory your servers use. Hover it to see other apps and what’s free.
Click a server for its details: memory and CPU charts for the last 10 minutes, its process tree, project, branch, and the coding agent session that started it.
Click Clean up to see the servers you probably don’t need, and stop them.

On many Linux desktops a left click opens the tray menu. Pick Open Everyport at the top.

Keyboard

Keys	Action
`↑` `↓`	Select a server
`Enter`	Open its details
`Esc` or `←`	Go back
`⌘` `O`	Open it in your browser
`⌘` `R`	Restart it
`⌘` `⌫`	Stop it

On Windows and Linux, use Ctrl instead of ⌘. In Clean up, Enter or Space selects a server.

Protected servers

Databases such as postgres and redis-server are protected. Clean up and auto-kill skip them, and Stop and Restart ask you to confirm first. Edit the list in Settings → Clean up.

The terminal

Run everyport for the terminal UI. It shows the same list, with the same details and actions.

Keys	Action
`↑` `↓` or `j` `k`	Select a server
`Enter`	Open its details
`o`	Open it in your browser
`v`	Open its Vercel preview, when previews are on
`s`	Stop it
`r`	Restart it
`c`	Clean up
`Tab` or `m`	Switch machines
`?`	All keys
`q`	Quit

For scripts, use the commands:


everyport list                  # the servers, once
everyport list --json           # the same, as JSON
everyport watch --jsonl         # a JSON snapshot on every change
everyport stop 5173             # stop the server on port 5173
everyport clean --yes           # stop what Clean up suggests, without asking

See the CLI reference for every command.

Watch other machines over SSH, Docker, Kubernetes or WSL.
Set alerts, clean up and auto-kill.
Fix a problem.