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
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor 3072; 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 | [Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor 3072; 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 askingSee the CLI reference for every command.
Updating
The desktop app checks GitHub for a newer release when it starts and every 12 hours, or when you pick Check for Updates… in the tray menu. The check sends one request to GitHub and nothing else. When there is a newer release:
- the popover shows an Update to 0.1.3 button at the bottom
- the tray menu shows Update to Everyport 0.1.3…
- a notification appears, once for each new version
Click any of these to update. A terminal opens and runs the install command. It downloads and verifies the new version, quits Everyport, replaces it and opens the new one. In some cases it works differently:
- No terminal opens: Settings → General shows the command to paste in a terminal, with a Copy button.
- Installed with Homebrew: the terminal runs
brew upgrade --cask everyport. - Installed from a
.deb,.rpmor.msi: Update opens the release page. Download and install the new package from there.
Skip This Version, in the notification or in Settings → General, hides that version until a newer one comes out. To stop checking, turn off Check for updates automatically in Settings → General.
For the CLI, run everyport update. If you installed the CLI with Homebrew, cargo, npm or PyPI, it prints the command to update it that way. When run in a terminal, everyport --version also tells you if a newer release is out. It checks at most once a day. Set EVERYPORT_NO_UPDATE_CHECK=1 to turn it off.
Next
- Watch other machines over SSH, Docker, Kubernetes or WSL.
- Set alerts, clean up and auto-kill.
- Fix a problem.