API
Specification

A technical index of the Mjolnir architecture. Each module is a precision primitive for macOS orchestration.

Core Architecture

Mjolnir's core is intentionally minimal. It provides the Lua 5.3 environment and the foundational system hooks required for macOS automation. All specialized functionality is loaded through Modules.

keyboard

mjolnir.hotkey

Global keyboard shortcut management. Bind functions to modifiers + keys.

mjolnir.hotkey.bind(mods, key, fn)

mods: A table of modifier strings: "cmd", "alt", "ctrl", "shift".

key: String representing the character (e.g., "A", "left").

fn: The Lua function to execute when triggered.

apps

mjolnir.application

Introspect and manipulate running applications.

mjolnir.application.find(hint)

mjolnir.application.runningapplications()