Skip to content

Architecture

Area Responsibility
src/command.rs Clap CLI and serializable command model.
src/config.rs TOML defaults, loading, and validation.
src/ipc.rs Private Unix socket, framing, and single-instance locking.
src/core/ Motion, geometry, labels, and input state without platform APIs.
src/runtime/ Command execution, bindings, lifecycle, and config watching.
src/platform/ macOS/X11 pointer injection and macOS keyboard input.
src/desktop/ macOS AppKit overlay and accessibility discovery.
src/service.rs macOS LaunchAgent setup.

Keep shared semantics in the core/runtime layers. Platform modules implement operating-system mechanics without changing command behavior. Native macOS UI stays on the main thread.

See architecture decisions for the command-first decision that defines the CLI as the stable integration boundary.