Procexp-Mac README

The project's README from github.com/microsoft/Procexp-Mac. As one markdown file: README.md.

Sysinternals Process Explorer for Mac

Sysinternals Process Explorer for Mac is a native macOS implementation of the core Process Explorer experience. It provides a live process tree, lower-pane module/handle/thread inspection, rich per-process properties, system-wide performance graphs, code-signing inspection, and macOS-specific equivalents for Process Explorer workflows.

The app is built with Swift, SwiftUI, and AppKit, with sampling backed by public macOS APIs such as libproc, sysctl, Mach host statistics, Security.framework, IOKit, Metal, and optional privileged helper support.

Sysinternals Process Explorer for Mac showing process details and system information

Features

Requirements

Install xcodegen if needed:

brew install xcodegen

Build

Generate the Xcode project and build the Debug app:

xcodegen generate
xcodebuild -scheme ProcexpMac -configuration Debug build

The Debug app is written under Xcode DerivedData. On this machine the path is typically:

~/Library/Developer/Xcode/DerivedData/ProcexpMac-czqddcuyalgzfgebjezrhssregtw/Build/Products/Debug/ProcExp\ \(Dev\).app

You can also open the generated project in Xcode:

xcodegen generate
open ProcexpMac.xcodeproj

Run

After a Debug build, launch the app with:

open "$HOME/Library/Developer/Xcode/DerivedData/ProcexpMac-czqddcuyalgzfgebjezrhssregtw/Build/Products/Debug/ProcExp (Dev).app"

If your DerivedData suffix differs, locate the product with:

find ~/Library/Developer/Xcode/DerivedData -path '*/Build/Products/Debug/ProcExp (Dev).app' -print

To relaunch a freshly built app from this workspace:

app="$HOME/Library/Developer/Xcode/DerivedData/ProcexpMac-czqddcuyalgzfgebjezrhssregtw/Build/Products/Debug/ProcExp (Dev).app"
pids=$(pgrep -f "$app/Contents/MacOS/ProcexpMac" || true)
if [[ -n "$pids" ]]; then kill $pids 2>/dev/null || true; fi
open -n "$app"

Bundle identity: development vs. official

Unqualified Xcode and local ad-hoc builds use ProcExp (Dev).app with bundle ID com.sysinternals.procexpmac.dev. Its helper uses the separate launchd and Mach service ID com.sysinternals.procexpmac.dev.helper. The development app, helper approval, preferences, and LaunchServices registration therefore do not replace an installed official copy.

The official identities are reserved for an explicit Developer ID build or the Azure release pipeline: ProcExp.app, com.sysinternals.procexpmac, and com.sysinternals.procexpmac.helper. The build and signing scripts validate the entire tuple before signing or publishing it.

Validate

Run the full Swift package test suite:

swift test

Run the live smoke test:

swift run ProcexpSmoke

Run focused test suites:

swift test --filter ProcexpModelTests
swift test --filter ProcexpNetworkTests
swift test --filter ProcexpSigningTests

TCP/IP Test Fixture

The repository includes a small stateful TCP fixture for testing the TCP/IP tab:

swift build --product ProcexpTcpFixture
.build/debug/ProcexpTcpFixture --duration 3600 --remote-host github.com --remote-port 22

The fixture opens a loopback listener, creates a loopback established connection, and optionally opens a DNS-resolved remote TCP connection. Select the fixture process in Process Explorer and open Properties > TCP/IP to inspect the sockets and remote-name resolution.

Privileged Helper

The app can use an optional privileged root helper for operations that require elevated privileges, such as richer cross-user process detail (full process list, threads, modules, environment) and privileged process control. The helper is a launchd daemon reached over XPC; the app registers it with SMAppService.

macOS gates SMAppService daemon registration on the app's code signature and on an explicit user approval. The app must be signed with a stable, non-ad-hoc identity — a Developer ID Application certificate for distribution, or a self-signed identity for local development — and you approve the daemon once in System Settings ▸ General ▸ Login Items & Extensions. The sections below cover both the Developer ID install and a local self-signed test.

Testing with a Developer ID certificate (real install)

This is the same experience end users get.

DEV_SIGN_IDENTITY="Developer ID Application: NAME (TEAMID)" \
bash Scripts/dev_install_helper.sh

This builds a Release app, embeds the helper and its launchd plist at Contents/Library/LaunchDaemons/, signs everything inside-out with the Hardened Runtime and entitlements, installs /Applications/ProcExp.app, and launches it. Then, in the app, choose ProcexpMac ▸ Install Privileged Helper… and approve the daemon in System Settings ▸ General ▸ Login Items & Extensions. After approval the app adopts the privileged provider and shows all processes.

Testing without a Developer ID certificate (local self-signed)

For local development you can exercise the same privileged code path with a throwaway self-signed identity. On first run the script creates the identity in a dedicated keychain (no login-keychain involvement), builds a signed, helper-embedded app, installs it to /Applications, and launches it:

bash Scripts/dev_install_helper.sh

Then, one time only, choose ProcexpMac ▸ Install Privileged Helper… and approve the daemon in System Settings ▸ General ▸ Login Items & Extensions. After that, every subsequent run of the script rebuilds and relaunches the signed app with the helper already enabled, so the elevated path is available on each iteration:

bash Scripts/dev_install_helper.sh          # Debug (default), fast
CONFIGURATION=Release bash Scripts/dev_install_helper.sh
RESTART_HELPER=1 bash Scripts/dev_install_helper.sh   # after changing helper code

Notes:

Verifying and cleaning up

Check whether the daemon is registered and running as root:

launchctl print system/com.sysinternals.procexpmac.dev.helper

For an explicit Developer ID install, inspect the official service instead:

launchctl print system/com.sysinternals.procexpmac.helper

If registration succeeded, the process list shows previously hidden cross-user and system processes. If the daemon is registered but not yet enabled, approve it in System Settings ▸ General ▸ Login Items & Extensions and it becomes active. Repeated reinstalls can clear a previously remembered approval, in which case macOS asks you to approve it again. If registration is refused outright (for example, an ad-hoc signature), the app reports that the helper could not be registered and continues in unprivileged mode.

Remove the installed app and unregister the helper:

bash Scripts/dev_uninstall_helper.sh

The cleanup script defaults to the development tuple. To remove an explicit Developer ID test install instead, run:

PROCEXP_LOCAL_FLAVOR=official bash Scripts/dev_uninstall_helper.sh

Remove the throwaway signing keychain when finished:

security delete-keychain "$HOME/Library/Keychains/procexp-dev.keychain-db"

See Helper/README.md and docs/RELEASE.md for the helper architecture and the full Developer ID signing/notarization pipeline.

Release Build

Build a release DMG:

bash Scripts/build_release.sh

This local ad-hoc command creates build/ProcExp-Dev.dmg containing ProcExp (Dev).app. To prepare the canonical app for Developer ID signing:

PROCEXP_BUILD_FLAVOR=official PACKAGE_DMG=0 bash Scripts/build_release.sh

Sign and notarize a release build after configuring Developer ID credentials:

bash Scripts/sign_notarize.sh

See docs/RELEASE.md for the full release pipeline.

Project Layout

Notes

macOS does not expose every Process Explorer data source through public APIs. Where macOS denies access or a metric is not available through supported APIs, the UI leaves values blank rather than fabricating data. Some details become available only for same-user processes or when the privileged helper is active.

Procexp-Mac (microsoft/Procexp-Mac)

Searching Database…

What is this?A native macOS version of Sysinternals Process Explorer, with a live process tree, per-process properties, system performance graphs and code-signing inspection.
Is it a Mac app or a library I can import?It is a standalone macOS GUI app, not a library. It is built with Swift, SwiftUI and AppKit, and you run it on your own Mac.
How do I build and run it?Install xcodegen, generate ProcexpMac.xcodeproj from project.yml, then build the Debug target in Xcode or open the generated project there. Launch the resulting ProcExp (Dev).app from DerivedData.
What do I need before building it?macOS 14 or later, Xcode 26.6 or later (recommended), a Swift 5.9 toolchain or newer, and xcodegen to regenerate the project file.
Does it show everything the Windows Process Explorer does?No. macOS does not expose every data source through public APIs, so unsupported metrics are left blank instead of faked. Some details appear only for same-user processes or when the privileged helper is active.
Does it run on Intel Macs as well as Apple Silicon?It targets macOS 14 and later and has Apple Silicon specific performance and efficiency core labeling, so Apple Silicon is the clearly supported path. Intel Mac support is not explicitly stated in the README.
Does anything leave my Mac?Local process sampling stays on the machine. Search Online and VirusTotal checks send lookups to external services, but only when you choose those actions.
What can I inspect for a single process?The Properties window has Image, Performance, Performance Graph, Threads, TCP/IP, Security, Environment and Strings tabs. The Security tab shows the signer, notarization status and SHA-256.
Can I act on processes from the app?Yes. You can kill a process or its whole tree, suspend and resume it, set priority, restart it, bring it to front, sample it, and check it on VirusTotal.
Do I need admin rights to see every process?Not by default, since the app runs unprivileged. For cross-user and system processes you can install an optional privileged helper and approve it once in System Settings under General and Login Items & Extensions.
Is there anything in the menu bar?Yes, a menu-bar CPU history item. The app also has a native menu bar with File, Options, View, Process, Find, Window and Help commands.
Creator
microsoft
Size
2.4 MB
Stars
997
Age
4mo
Commits · 90 Days