Windows - Tray Notification - Reset Titlebar Title

What the tray titlebar reset Worklet does

This Automox Worklet™ reverts the Automox agent tray window titlebar to the default Automox label on Windows endpoints. The Worklet uses the supported amagent.exe CLI rather than editing a registry key or hand-modifying a state file, so the visible titlebar updates in place with no amagent-ui restart or endpoint reboot.

Reset Titlebar Title is built to be triggered on demand with FixNow, not on a recurring policy schedule. The evaluation script always exits 0 (compliant) by design, so remediation only runs when an operator initiates it. The version gate inside both scripts reads the Automox Agent DisplayVersion from HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\* and requires 2.5.0 or higher, because the notifications subcommand does not exist on earlier agent builds.

The remediation phase resolves amagent.exe under C:\Program Files (x86)\Automox\ (with a fallback to C:\Program Files\Automox\) and invokes amagent.exe notifications set_titlebar_title --text "Automox". When that call returns exit code 0, the Worklet also opens C:\Program Files (x86)\Automox\tray_branding_text_state.csv, removes the titlebarTitle row, and either rewrites the file with the remaining keys or deletes it if no other branding entries remain. That keeps the cached state file consistent with the reverted UI on the next agent restart.

Why standardize the Automox tray titlebar on Windows

Custom titlebar text on the Automox tray is useful during pilots, MSP rebranding, or co-managed deployments, but the customizations rarely propagate cleanly. A subset of endpoints gets the branded label, a subset keeps the default, and a third subset ends up with stale test text from a one-off Worklet run. End users opening a support ticket describe a window titled three different ways, and the help desk spends the first two minutes of each call confirming which agent they are looking at.

Resetting the titlebar to the default Automox label removes that ambiguity at the source. Because the Worklet is FixNow-compatible, you can target a single drifted endpoint from the console without waiting for the next policy run, or scope it to a device group after a pilot ends. Pairing this Worklet with the set tray titlebar title Worklet lets you push a temporary brand for a launch and then revert the fleet to the standard label when the campaign closes.

How amagent.exe tray titlebar reset works on Windows

1. Evaluation phase: The script reads HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\* with Get-ItemProperty, filters for the Automox Agent entry, and parses DisplayVersion. It logs whether the installed agent meets version 2.5.0 or higher, then exits 0 by design so the Worklet never auto-remediates on a schedule. Trigger remediation with FixNow when you want to push the reset.

2. Remediation phase: The script re-runs the version gate and exits 2 if the agent is missing or below 2.5.0. On a supported agent, it resolves amagent.exe (preferring C:\Program Files (x86)\Automox\amagent.exe, falling back to C:\Program Files\Automox\amagent.exe) and invokes amagent.exe notifications set_titlebar_title --text "Automox" using the call operator, capturing $LASTEXITCODE. On a zero exit, the script also imports C:\Program Files (x86)\Automox\tray_branding_text_state.csv, removes the titlebarTitle row, and either re-exports the CSV or deletes the file if no rows remain. A non-zero exit code from amagent.exe surfaces stderr to Automox activity logs and the Worklet exits 2.

Tray titlebar reset requirements

• Windows 10, Windows 11, Windows Server 2016, Windows Server 2019, or Windows Server 2022

• Automox Agent 2.5.0 or higher (the notifications subcommand is not present on earlier builds)

• Automox installed under C:\Program Files (x86)\Automox\ or C:\Program Files\Automox\ so amagent.exe is resolvable

• PowerShell 5.1 or higher for script execution

• Run the Worklet on demand with FixNow; the evaluation script always exits 0 (compliant) and is not designed for recurring policy schedules

• A paired set tray titlebar title Worklet if you want to push custom branding before reverting the default with this one

Expected Automox tray titlebar state after reset

After a successful run, the Automox tray window titlebar reads Automox on every targeted endpoint and the titlebarTitle row is gone from tray_branding_text_state.csv. The change is visible the next time a user opens the tray from the Windows notification area; no logoff, sign-out, or amagent-ui restart is required. Help desk staff can verify the result by opening the tray on a sample endpoint and confirming the window title matches the default label.

Exit code 0 from remediation indicates amagent.exe accepted the command and the state file was reconciled. Exit code 2 means the version gate failed or amagent.exe returned a non-zero exit code – check Automox activity logs for the captured stderr, confirm the agent is at 2.5.0 or higher, and rerun the Worklet from FixNow. Endpoints that report 0 from evaluation alone have not been remediated; that is by design, and you should trigger FixNow to push the reset.