What Is ~/Library/LaunchAgents on Mac?
Your user folderUpdated
- Full path
~/Library/LaunchAgents
- Scope
- Your user folderInside your home folder — one copy per user account.
- Freshist & this folder
- Freshist checks this folder when uninstalling an app. When you uninstall an app, Freshist looks here for items that belong to it. Matches on the app's bundle ID can be pre-selected; name-only guesses are labeled “not sure” and never pre-selected. Removed items go to the Trash, so you can undo.
From Freshist's own cleaning rules — the same catalog the app uses.
How launch agents work
macOS starts and manages background programs with launchd. Apple's guide to daemons and agents explains that each job is described by a property list naming a label, the program to run and when to run it. Agents in ~/Library/LaunchAgents run as your user, in your login session.
| Folder | Runs as | Who can change it |
|---|---|---|
~/Library/LaunchAgents | You, after you log in | You |
/Library/LaunchAgents | Every user, after login | Administrators |
/Library/LaunchDaemons | root or a system user, from startup | Administrators |
/System/Library/Launch… | macOS components | Nobody, it's on the sealed system volume |
The system-wide folders have their own guides: /Library/LaunchAgents and /Library/LaunchDaemons.
What's usually in here
A typical example: one Mac we looked at had exactly two files here, both from software updaters, each with a ProgramArguments entry pointing into the vendor's folder in Application Support. That's the common pattern. Updaters, cloud sync tools, menu bar helpers and developer tools all add agents.
Why orphans happen
Dragging an app to the Trash leaves its agent behind. launchd keeps trying to start a program that no longer exists, fails, and logs the error. It doesn't harm the Mac, but it's clutter, and on every login it's one more job macOS tries to start.
Inspecting agents read-only
List the files and read one in plain text:
ls -la ~/Library/LaunchAgents
plutil -p ~/Library/LaunchAgents/com.example.agent.plist
Check whether the program it points to still exists, and whether launchd has it loaded:
launchctl list | grep -i example
launchctl print gui/$(id -u) | grep -i example
Since macOS Ventura, System Settings → General → Login Items & Extensions also lists background items under Allow in the Background (labelled App Background Activity in newer versions), so you can turn an agent off without deleting anything.
Removing a leftover agent
Turn it off in Login Items & Extensions if it's listed there, or use the app's own setting.
Unload it from your session (replace the label/path with the real one):
launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.example.agent.plistIn Finder, choose Go → Go to Folder…, enter
~/Library/LaunchAgents, and move the.plistto the Trash.Log out and back in to confirm it doesn't come back.
If it reappears, the app it belongs to is still installed and recreating it; uninstall the app or use its settings instead.
What not to delete
Don't remove agents for apps you rely on to update or sync unless you'll handle that by hand. Leave /System/Library/LaunchAgents alone entirely. For a wider look at what runs in the background and how to manage it, see login items and background apps on Mac.
Sources
- Creating Launch Daemons and Agents, Apple Developer
- Change Login Items & Extensions settings on Mac, Apple Support
- Updating helper executables from earlier versions of macOS, Apple Developer Documentation
man launchctlandman launchd.pliston your Mac
Frequently asked questions
Is an agent in ~/Library/LaunchAgents a sign of malware?
Not by itself. Most entries come from ordinary apps, usually updaters. Check the Program or ProgramArguments path inside the plist: if it points to an app you don't recognize or a hidden folder, investigate further.
What's the difference between LaunchAgents and LaunchDaemons?
Agents run as you, inside your login session, and can show UI. Daemons run in the background as root or another system user, live only in /Library/LaunchDaemons, and need an administrator to change.
Will deleting a LaunchAgent break the app that installed it?
Usually the app still opens, but whatever the agent did stops: automatic updates, background sync or a menu bar helper. Some apps reinstall their agent the next time they launch.