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 launchmanager

2. 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.log

Expected 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.

See FAQ and limitations or tool selection and use cases.

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.