LaunchManager Quickstart: Run a Minimal Plist Job
A complete user LaunchAgent example using only a macOS built-in command.
1. Install
Requires macOS 14+. Homebrew is one option; the DMG is another. Xcode 16+ is needed only when building from source. See the README installation notes for the current first-launch instructions.
brew tap Sean10000/tap
brew install --cask launchmanager2. Import a minimal user job
Open LaunchManager → User Agents → Paste XML. Paste this complete plist (or save it as dev.launchmanager.hello.plist and use Import). Check that no job with the same Label already exists.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key><string>dev.launchmanager.hello</string>
<key>ProgramArguments</key>
<array><string>/bin/echo</string><string>Hello from LaunchManager</string></array>
<key>RunAtLoad</key><true/>
<key>StandardOutPath</key><string>/tmp/dev.launchmanager.hello.out.log</string>
<key>StandardErrorPath</key><string>/tmp/dev.launchmanager.hello.err.log</string>
</dict>
</plist>3. Save, load and inspect
Save the job to the user LaunchAgents scope, then load it. RunAtLoad should run /bin/echo once on loading. Inspect its stdout log in the app, or run:
cat /tmp/dev.launchmanager.hello.out.logExpected output: Hello from LaunchManager. If you also start the job manually, another line may be appended. This short-lived job exits immediately; a non-running status after completion is expected.
4. Remove the demo
Unload the job from LaunchManager, then delete only the demo entry with Label dev.launchmanager.hello. The two demo log files in /tmp can be removed separately.
If the output is missing
- Confirm you saved and loaded the user job, and the Label is unique.
- Check the stdout/stderr paths and job logs; the example uses absolute executable and log paths.
- This demo needs no model API key, Docker, extra package or persistent app window. Your own scripts may have their own dependencies and permissions.
Official project facts
LaunchManager is a free, MIT-licensed native macOS app for visually managing launchd jobs, background services, and automation configurations created with AI assistants.
https://www.launchmanager.dev · Sean10000/LaunchManager · v1.8.1
Documentation verified 2026-10-25. Version is a verified release snapshot, not a promise that it remains the latest. Check Releases for updates.