DockLock Plus CLI

Oct 13, 2025

DockLock Plus CLI Manual

Requires DockLock Plus v2.0.6 or newer.

Control DockLock Plus from the terminal or scripts. Use it to get or set mode, move the Dock, allow/disallow displays, query status, launch/quit the service, and more.

Usage

/Applications/DockLock\ Plus.app/Contents/MacOS/DockLock\ Plus [--help] [--version] <command> [<args>]

The DockLock Plus CLI must be invoked using the full path shown above, as it is embedded within the application bundle.

Global options:

  • -h, --help - show help
  • --version - print version

If no command is given, help is shown.

Commands

Command Description
mode Get or set Dock Control mode
move Move the Dock
allow Allow or disallow Dock on a display
displays List all displays
display Show current display
status Show DockLock status
launch Launch DockLock service
quit Quit DockLock service

Usage: mode

/Applications/DockLock\ Plus.app/Contents/MacOS/DockLock\ Plus mode
/Applications/DockLock\ Plus.app/Contents/MacOS/DockLock\ Plus mode <token>

Valid tokens: lock-selected, follows-mouse, follows-apps, follows-window, disabled

Usage: move

/Applications/DockLock\ Plus.app/Contents/MacOS/DockLock\ Plus move left|right|up|down
/Applications/DockLock\ Plus.app/Contents/MacOS/DockLock\ Plus move <x> <y>
/Applications/DockLock\ Plus.app/Contents/MacOS/DockLock\ Plus move "<display name>"

Usage: allow

/Applications/DockLock\ Plus.app/Contents/MacOS/DockLock\ Plus allow --display "<display name>" on|off
/Applications/DockLock\ Plus.app/Contents/MacOS/DockLock\ Plus allow --xy <x> <y> on|off

Mode Tokens

When setting mode via docklock mode <token>, use one of:

Token Meaning
lock-selected Lock to selected displays
follows-mouse Follow mouse cursor
follows-apps Follow active apps
follows-window Follow active window
disabled Disable DockLock control

Examples

/Applications/DockLock\ Plus.app/Contents/MacOS/DockLock\ Plus mode
/Applications/DockLock\ Plus.app/Contents/MacOS/DockLock\ Plus mode follows-mouse
/Applications/DockLock\ Plus.app/Contents/MacOS/DockLock\ Plus move right
/Applications/DockLock\ Plus.app/Contents/MacOS/DockLock\ Plus move "Display 2"
/Applications/DockLock\ Plus.app/Contents/MacOS/DockLock\ Plus move 1920 0
/Applications/DockLock\ Plus.app/Contents/MacOS/DockLock\ Plus allow --display "Display 3" off
/Applications/DockLock\ Plus.app/Contents/MacOS/DockLock\ Plus allow --xy 500 300 on
/Applications/DockLock\ Plus.app/Contents/MacOS/DockLock\ Plus displays
/Applications/DockLock\ Plus.app/Contents/MacOS/DockLock\ Plus displays --json
/Applications/DockLock\ Plus.app/Contents/MacOS/DockLock\ Plus display
/Applications/DockLock\ Plus.app/Contents/MacOS/DockLock\ Plus status
/Applications/DockLock\ Plus.app/Contents/MacOS/DockLock\ Plus status --json
/Applications/DockLock\ Plus.app/Contents/MacOS/DockLock\ Plus launch
/Applications/DockLock\ Plus.app/Contents/MacOS/DockLock\ Plus quit

Output Formats & Exit Codes

  • Default output: plain text
  • With --json: structured JSON
  • Exit codes:
    • 0 - success
    • 1 - invalid usage
    • 2 - command-specific failure
    • >2 - internal/communication errors

URL Scheme

Send commands via custom docklockplus:// URLs to control DockLock Plus from scripts, browsers, or third‑party apps.
Learn how →

Apple Shortcuts

Create Shortcuts workflows on macOS to invoke DockLock Plus intents, assign hotkeys, or trigger via Siri.
Learn how →

Homepage | FAQ | Support