Procexp-Mac README

README проекта с github.com/microsoft/Procexp-Mac. Одним файлом markdown: 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)

Ищем в базе…

Что это такое?Нативная версия Sysinternals Process Explorer для macOS с живым деревом процессов, свойствами каждого процесса, графиками производительности системы и проверкой подписи кода.
Это приложение для Mac или библиотека, которую можно импортировать?Это самостоятельное графическое приложение для macOS, а не библиотека. Оно написано на Swift, SwiftUI и AppKit и запускается на вашем Mac.
Как собрать и запустить его?Установите xcodegen, сгенерируйте ProcexpMac.xcodeproj из project.yml, затем соберите цель Debug в Xcode или откройте в Xcode созданный проект. Запустите получившийся ProcExp (Dev).app из DerivedData.
Что нужно установить перед сборкой?macOS 14 или новее, Xcode 26.6 или новее (рекомендуется), инструментарий Swift 5.9 или новее и xcodegen для пересоздания файла проекта.
Показывает ли оно всё, что показывает Process Explorer для Windows?Нет. macOS не предоставляет через публичные API все источники данных, поэтому неподдерживаемые метрики оставляются пустыми, а не подделываются. Некоторые сведения доступны только для процессов того же пользователя или когда активен привилегированный помощник.
Работает ли оно на Mac с Intel, а также на Mac с Apple Silicon?Приложение рассчитано на macOS 14 и новее и содержит специфичные для Apple Silicon метки производительности и энергоэффективных ядер, поэтому явно поддерживается путь с Apple Silicon. Поддержка Mac с Intel в README прямо не указана.
Покидают ли мой Mac какие-либо данные?Локальный сбор данных о процессах остаётся на устройстве. Проверки через Search Online и VirusTotal отправляют запросы во внешние сервисы, но только когда вы сами выбираете эти действия.
Что можно посмотреть для одного процесса?В окне свойств есть вкладки Image, Performance, Performance Graph, Threads, TCP/IP, Security, Environment и Strings. На вкладке Security показаны подписант, статус нотаризации и SHA-256.
Можно ли управлять процессами из приложения?Да. Можно завершить процесс или всё его дерево, приостановить и возобновить его, задать приоритет, перезапустить, вывести на передний план, сделать выборку и проверить в VirusTotal.
Нужны ли права администратора, чтобы видеть все процессы?По умолчанию нет, так как приложение работает без привилегий. Для процессов других пользователей и системных процессов можно установить необязательный привилегированный помощник и один раз подтвердить его в Системных настройках в разделе «Основные» → «Объекты входа и расширения».
Есть ли что-то в строке меню?Да, пункт с историей загрузки ЦП в строке меню. Кроме того, в нативном меню приложения есть команды File, Options, View, Process, Find, Window и Help.
Какие есть похожие проекты?FinderSearch, OpenYoink, systeminformer, Argus, status-trio, mac-performance-monitor, Insomnia, MacPacker
Автор
microsoft
Размер
2.4 MB
Звёзды
997
Возраст
4 мес
Коммиты · 90 дней