id = "launchctl"
name = "launchctl"
description = "Interface to launchd on macOS."
executables = ["launchctl"]
platforms = ["macos"]

[commands]
format = 1
label = "launchctl"
description = "Inspect and restart launchd services. Load/unload and system changes are left out."
quality = "ai-draft"
base = "fig:launchctl"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.subcommand]]
path = ["list"]
label = "List services"
description = "List services or show one."

[[commands.subcommand.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/launchctl.ts"
license = "MIT"

[[commands.subcommand.field]]
id = "label"
label = "Label"
description = "Leave empty to list all."
type = "string"
position = 0
sources = ["fig"]

[[commands.subcommand.task]]
id = "list"
label = "List"
fields = ["label"]
required = []

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["label"]

[[commands.subcommand]]
path = ["print"]
label = "Print service"
description = "Print a description of a domain or service."

[[commands.subcommand.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/launchctl.ts"
license = "MIT"

[[commands.subcommand.field]]
id = "service"
label = "Service or domain target"
description = "e.g. gui/501/com.example.app."
type = "string"
position = 0
sources = ["fig"]

[[commands.subcommand.task]]
id = "print"
label = "Print"
fields = ["service"]
required = ["service"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["service"]

[[commands.subcommand]]
path = ["kickstart"]
label = "Start service"
description = "Force an existing service to start."

[[commands.subcommand.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/launchctl.ts"
license = "MIT"

[[commands.subcommand.field]]
id = "service"
label = "Service target"
description = "e.g. gui/501/com.example.app."
type = "string"
position = 0
sources = ["fig"]

[[commands.subcommand.field]]
id = "kill"
label = "Kill first"
type = "boolean"
option = ["-k"]
effect = "exec"
sources = ["fig"]

[[commands.subcommand.field]]
id = "pid"
label = "Print PID"
type = "boolean"
option = ["-p"]
sources = ["fig"]

[[commands.subcommand.task]]
id = "restart"
label = "Restart service"
set = { kill = [true] }
fields = ["service", "pid"]
required = ["service"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["service", "pid"]

[[commands.subcommand.group]]
id = "advanced"
label = "Advanced"
fields = ["kill"]