Using MacPeek

The launcher

1. Click the menu-bar icon. MacPeek opens a compact popover. At the top, CPU, Memory and Disk rings show CPU in use, memory in use and how full the startup disk is; below them every other utility you have switched on is listed, one per row, with its one-line summary.
2. The sun/moon button switches between dark and light; Settings also offers matching your Mac’s appearance.
3. Search the list by name or by the question a utility answers.
4. Click a ring or a row to open that utility inside the same popover. Use the back button (or ⌘[) to return to the launcher.
5. The gear opens Settings. Manage utilities (launcher footer or Settings) lists every utility with an on/off switch: see managing utilities.

When the popover opens, enabled utilities may take one quick snapshot to fill in the launcher’s one-line summaries (for example PortPeek’s port count). The CPU, Memory and Disk rings update at your refresh interval while the launcher is on screen, and stop as soon as you open a utility or close the menu. Continuous refreshing happens only while a utility’s own screen is open. A switched-off utility does no work at all. The popover always reopens on the launcher.

Using PortPeek

1. Open PortPeek. It scans immediately and refreshes every 2 seconds while its screen is open.
2. Browse the scrollable list of listening ports: port, process name, PID and protocol.
3. Search. Type a port (3000, or just 30), a process name (node), a PID or an address. Multiple words narrow the result (node 5173).
4. Select a row to expand it: process, PID, protocol, address, state, user, and whether you can terminate it. Copy buttons copy the port, PID, process or address.
5. Kill Process. MacPeek confirms (configurable), re-checks the target and asks the process to quit gracefully.
6. Verify. On success you see “✓ Port 3000 freed”. MacPeek confirms the process exited and the port is released before it says so.

Using FileLockPeek

1. Open FileLockPeek and choose a file or folder: click Choose…, drop one onto the popover, or paste a path and press Return.
2. MacPeek lists the processes that have it open, and how: open for reading or writing, locked, working directory, executable or memory-mapped.
3. Select a process to copy its PID or the path, reveal the item in Finder, or Kill Process (same safe checks as PortPeek; nothing is ever terminated for you).

FileLockPeek scans only when you ask, and a folder scan includes everything inside it, so large folders can take a moment.

Using DisplayPeek

1. Open DisplayPeek. It reads your display configuration when the screen opens (use ⌘R to read again) and does nothing in the background.
2. Each connected display gets a card: panel resolution, the “looks like” desktop resolution, refresh rate, scaling, main/mirrored/online state, and anything else macOS reports.
3. Click the copy button on a card to copy its details, without serial numbers.

If macOS does not report a detail, DisplayPeek leaves it out rather than guessing.

Using USBPeek

1. Open USBPeek. It reads when the screen opens and then updates every few seconds while the screen is open, so plugging or unplugging a device shows up without reopening it (⌘R reads immediately).
2. Devices are shown as a tree by USB bus, with hubs and the devices behind them. Click a device for its vendor, vendor:product ID, link speed, declared USB version and class, and copy them.
3. Thunderbolt / USB4 ports are listed below with their status and speed.

Serial numbers are never read. A device’s link speed is what macOS negotiated, which is what to check when a fast drive seems slow.

Using SleepPeek

1. Open SleepPeek. It shows what is keeping your Mac (or its display) awake, refreshing every few seconds while its screen is open.
2. Each blocker shows its process, PID, assertion type and how long it has been held. Statements are labelled Reported by macOS or Likely (inference).
3. Load history reads recent sleep, wake and background-wake events from the power log. That can take up to a minute, so it only runs when you ask.

SleepPeek is read-only: it never changes a power setting.

Using ProcessPeek

1. Open ProcessPeek. It reads the process list when the screen opens (⌘R to read again) and does nothing in the background.
2. Search by name, PID, user or path. The filter menu sorts by name, CPU, memory or PID and can include other users’ processes (your own are shown by default).
3. Open a process to see its PID, user, start time, how long it has been running, CPU and memory, how it was launched (its command name), its full command line, its listening ports (yours only), its parent and its children. Click the parent or a child to jump to it.

The command line and ports are read only for the process you open. Command lines can contain secrets passed as arguments, so they are shown on screen only.

Kill Process works like PortPeek’s: MacPeek confirms (configurable), re-checks that the PID is still the same process (name and start time, so a reused PID is never hit), asks it to quit with SIGTERM and confirms it exited. If it ignores the request you can choose an explicit Force Kill. Ending loginwindow or your user launchd always asks first, because it ends your session. Nothing is ever ended for you.

Using DiskPeek

1. Open DiskPeek. It takes a first sample, and the rates appear after the second one, a couple of seconds later.
2. Each row is a process with its read and write rate over the last interval and the total since you opened DiskPeek. Order them by what is busy right now or by the total.
3. Leave the screen and sampling stops. Returning starts from a fresh baseline.

Every value is sampled and labelled that way. Other users’ and protected processes cannot be read, so they are not shown.

Using EnvPeek

1. Open EnvPeek. This app shows MacPeek’s own environment, which is usually not the environment of your terminal.
2. Switch to A process, enter a PID (ProcessPeek shows PIDs) and press Inspect to read that process’s environment. macOS only allows this for your own processes, and hides it for protected system processes.
3. Search names and values, copy a name, value or NAME=value, and open PATH entry by entry to spot duplicates, missing folders and relative entries.

Values that look like credentials are hidden until you press Reveal. Values stay on screen only: they are never logged or stored, and they are dropped from memory when you leave the screen.

Using NetPeek

1. Open NetPeek. It shows how your Mac is connected: the active interface, its IPv4 and IPv6 addresses, your router and your DNS servers. It refreshes every few seconds while the screen is open.
2. On Wi-Fi you also see signal, noise (and the difference between them), channel, standard, link rate and security. macOS hides the network name from apps without Location access, and MacPeek does not ask for it, so the name shows as hidden.
3. Press Run checks to ping your router and each DNS server three times. Results are labelled Measured or reported or Likely (inference). A device that ignores pings is not proof of an outage, and NetPeek says so.

Pings go only to your router and DNS servers, only when you press the button.

Using DNSPeek

1. Open DNSPeek. It lists the DNS servers macOS uses for ordinary lookups, in order, with their interface and reachability, plus search domains and the other resolvers (per-domain, multicast and scoped).
2. Press Run lookup to resolve a name (apple.com by default) the way apps do, then ask each server directly. You see who answered, how fast, and with what status.
3. Copy the configuration for a support thread.

DNSPeek is read-only: it never changes DNS settings. Only the name you type is queried, only when you press the button.

Using SoundPeek

1. Open SoundPeek. It lists your audio output and input devices with the current defaults first, and updates when a device is plugged in or removed.
2. Each device shows its connection, sample rate, channels and, where the device reports it, volume. Anything else reads Not reported.
3. Press Set as default to switch the output or input device (press it on the other device to go back). On the default output device you can also drag the volume slider and press Mute, where the device allows it.

SoundPeek never opens an audio stream, so it cannot record, and it changes something only when you press a button or move a slider. Only the default output device has a slider and mute button, and only if it lets macOS change them.

Using UpdatePeek

1. Open UpdatePeek to see your macOS version and build and any update macOS has already found. Press Check now to ask Apple’s update servers, or Open Software Update to install macOS updates there.
2. If Homebrew or npm is installed, press Check under its heading to list outdated packages (for npm, the globally installed ones).
3. Press Copy command to get the brew upgrade or npm install -g <name>@latest command for a package and run it in Terminal. For an npm package you can also press Update: after you confirm the command, UpdatePeek runs it for you, without administrator rights. If npm isn’t allowed to change its packages, the row shows the command with sudo for you to copy into Terminal.

UpdatePeek never installs macOS or Homebrew updates and never claims your Mac is up to date. Check now, the npm check and an npm update use the network, only when you press the button.

Keyboard and context menu

Copy, paste, cut, select all and undo (⌘C, ⌘V, ⌘X, ⌘A, ⌘Z) work in every text field, such as the search boxes and FileLockPeek’s path field.

• Arrow keys move the selection; ⌘R refreshes the open utility.
• In PortPeek, right-click a row to copy the port, PID or address, or open http://localhost:<port>.

Settings

Launch at login, refresh interval (1–10 s, used by the utilities that refresh live: PortPeek, USBPeek, SleepPeek, DiskPeek and NetPeek), confirm before kill, notifications and appearance (system, light, dark). See killing processes for how termination works.