makoctl(1) General Commands Manual makoctl(1)

# [NAME](#NAME)

makoctl - controls the [**mako**(1)](/man/enterprise-packages/mako/mako.1) daemon

# [SYNOPSIS](#SYNOPSIS)

makoctl \[cmd] \[options...]

# [DESCRIPTION](#DESCRIPTION)

Sends IPC commands to the running mako daemon via dbus.

# [COMMANDS](#COMMANDS)

**dismiss** \[-a|--all] \[-g|--group] \[-n <id>]

Dismisses a notification.

Options:

**-a, --all**

Dismiss all notifications.

**-g, --group**

Dismiss the first notification group.

**-h, --no-history**

Dismiss the current notification without adding it to history.

**-n** <id>

Dismiss the notification with the given id. Defaults to the first notification.

**restore**

Restores the most recently expired notification from the history buffer.

**invoke** \[-n <id>] \[action]

Invokes an action on a notification. If *action* is not specified, invokes the default action. Action names can be discovered using \`makoctl list\`.

Options:

**-n** <id>

Invoke the action on the notification with the given id. Defaults to the first notification.

**menu** \[-n <id>] <program> \[argument...]

Use a program to select an action on a notification. The list of actions are joined on newlines and passed to *program*. The program should write the selected action to stdout. If an action is given, this action will be invoked.

If no action is found, or no action is selected, *makoctl* will return non-zero.

Options:

**-n** <id>

List the actions of the notification with the given id. Defaults to the first notification.

Examples:

```
makoctl menu -- wmenu -p 'Select Action: '
makoctl menu -n 12345 -- wofi -d -p 'Choose Action: '
```

**list**

Retrieve a list of current notifications.

Options:

**-j**

Use JSON output.

**history**

Retrieve a list of dismissed notifications.

Options:

**-j**

Use JSON output.

**reload**

Reloads the configuration file.

**mode**  
**mode** -s <mode>...  
**mode** \[-a mode]... \[-r mode]... \[-t mode]... +  
When run without any option, retrieves a list of current modes.

When run with the *-s* option, replaces the current modes with the provided list.

When run with the *-a* or *-r* options, adds or removes the provided mode from the current modes.

When run with the *-t* option, toggle the mode by removing it when present and otherwise adding it.

See the *MODES* section in mako(5) for more information about modes.

**help, -h, --help**

Show help message and quit.

# [AUTHORS](#AUTHORS)

Maintained by Simon Ser <contact@emersion.fr>, who is assisted by other open-source contributors. For more information about mako development, see https://github.com/emersion/mako.

# [SEE ALSO](#SEE_ALSO)

[**mako**(1)](/man/enterprise-packages/mako/mako.1)

2026-10-30

---

Document: makoctl(1) from mako 1.11.0-r5 (Chainguard OS)
Source: https://github.com/emersion/mako