Build from source

Build Activity Monitor X with the Command Line Tools, run the tests, and run the docs site.

Requirements

• macOS 26 or later, on a Mac with Apple silicon.
• Command Line Tools for Xcode. Run xcode-select --install if you do not have them. Xcode is not necessary.

Build and install

git clone https://github.com/HenryQW/Activity-Monitor-X.git
cd Activity-Monitor-X
make cert
make install
open "/Applications/Activity Monitor X.app"

• make cert makes a self-signed code-signing certificate in your login keychain. Do this one time. macOS asks for your login password.
• make install builds the app, signs it with that certificate, and copies it to /Applications. Then it asks for your administrator password, copies amxd and amx to root-owned folders and starts the helper, as the install script does.

The helper accepts only callers that are signed with the same certificate as itself. So a build that you sign with your certificate works only with a helper from the same certificate. The Release page tells more.

Other tasks

The version is in the VERSION file.

The docs site

Cloudflare Pages builds the docs site from main at each push: the project runs pnpm build in website and publishes website/dist at amx.henry.wang. The pnpm and Node versions come from website/package.json.