Skip to content

aos service

Run a command as a managed per-user OS service

6 commands. Run aos service --help for the same list from the binary, or see every group.

Run any command as a managed per-user service that starts at login and survives reboots: a launchd user agent on macOS, a systemd --user unit on Linux, a Scheduled Task on Windows. Names are prefixed aos., and aos only ever lists or removes its own services. No sudo.

Install a command as a service

Terminal window
aos service create <name> [--autostart] [--now] -- <command> [args...]
flag values meaning
<name> Required positional argument
<command> Required positional argument
--autostart Optional
--now Optional
-- Required
Terminal window
aos service create mcp --autostart --now -- aos serve mcp
aos service create nap -- /bin/sleep 60

List the services aos manages

Terminal window
aos service list
Terminal window
aos service list

Stop a service and delete its definition

Terminal window
aos service remove <name>
flag values meaning
<name> Required positional argument
Terminal window
aos service remove mcp

Start an installed service

Terminal window
aos service start <name>
flag values meaning
<name> Required positional argument
Terminal window
aos service start mcp

Report whether a service is running; exits non-zero when it is not

Terminal window
aos service status <name>
flag values meaning
<name> Required positional argument
Terminal window
aos service status mcp

Stop a running service

Terminal window
aos service stop <name>
flag values meaning
<name> Required positional argument
Terminal window
aos service stop mcp