macOS - Tray Notification - Reset Branding Icon

What the tray icon reset Worklet does

This Automox Worklet™ restores the Automox Agent UI tray icon to default Automox branding on macOS endpoints. The Worklet executes the amagent notifications set_icon --reset command to revert any custom branding that was previously applied to the system tray notification icon.

The Worklet validates that the Automox Agent is installed and running version 2.5 or higher before attempting the reset. This maintains compatibility and prevents failures on unsupported agent versions.

The Worklet validates that the Automox Agent is installed and running version 2.5 or higher before attempting the reset, maintaining compatibility and preventing failures on unsupported agent versions.

Why restore default Automox branding

Consistent endpoint branding provides visual continuity across your managed infrastructure. When custom branding is no longer needed or conflicts with organizational standards, reverting to default Automox branding ensures users see the familiar, officially supported interface.

Resetting to default branding also simplifies support workflows and keeps your endpoints aligned with Automox documentation and training materials. This is particularly valuable when transitioning teams, updating corporate branding strategies, or standardizing a newly acquired fleet.

How tray icon reset works

1. Evaluation phase: The Worklet checks that the Automox agent is installed at /usr/local/bin/amagent, verifies the agent version is 2.5.0 or higher, and confirms the Automox Tray application exists at /Library/Application Support/Automox/agent-ui. If any check fails, the Worklet skips remediation.

2. Remediation phase: The Worklet executes amagent notifications set_icon --reset to restore the tray icon to default Automox branding. Upon successful completion, the agent tray displays the standard Automox icon and exits with success status.

Tray icon reset requirements

• macOS operating system (compatible with all supported versions)

• Automox Agent version 2.5.0 or higher

• Automox Agent UI (tray application) installed and running

• RunNow capability enabled on the endpoint for immediate execution

Expected tray icon appearance after remediation

After successful remediation, the Automox Agent tray icon in the macOS system menu bar displays the default Automox branding. Any previously applied custom icons or logos are replaced with the official Automox icon, verifying visual consistency with other Automox-managed endpoints.

You can verify the reset by checking the system tray in the macOS menu bar to confirm the icon displays the standard Automox branding. The agent continues to function normally with all monitoring and remediation capabilities intact.

How to validate reset branding icon changes

1. Run this Worklet on a pilot macOS endpoint and review evaluation output for reset branding icon.

2. Confirm Automox activity logs show successful completion and exit code 0.

3. Verify endpoint state using checks aligned to evaluation script logic, such as function, /usr/local/bin/amagent, break.

4. Validate remediation effects from script operations such as function, /usr/local/bin/amagent, break, then rerun evaluation for compliance.

For technical validation, compare endpoint state to the Worklet evaluation logic and remediation flow for reset branding icon. This supports repeatable tray management workflows, faster change control review, and auditable compliance evidence.

Useful script references for this Worklet include evaluation operations such as function, /usr/local/bin/amagent, break and remediation operations such as function, /usr/local/bin/amagent, break. Use these indicators to verify that endpoint changes match intended policy outcomes.