Skip to content
CommandLatch CommandLatch Docs

Use the dashboard

The dashboard is the web app you sign in to from your phone or any browser. It’s where you send actions to your paired Macs, watch a pending lock count down, cancel it, and manage devices, shortcuts, and webhooks.

Open https://app.commandlatch.app in your phone’s browser — bookmark it for quick access.

Signing in

Section titled “Signing in”

Enter your email, open the sign-in link we email you, and you land on your device list. There’s no password. To sign out, use Settings → Sign out.

Your devices

Section titled “Your devices”

The home screen lists every Mac you’ve paired. Each shows a live status:

  • Online · a few seconds ago — the Mac is awake, running CommandLatch, and ready. The “ago” time ticks up each second.
  • Offline · last seen … — no recent heartbeat. The Mac is asleep, closed, offline, or not running the app. Actions are disabled until it’s back.

Tap a device to open its controls.

Sending an action

Section titled “Sending an action”

On a device’s page you’ll find action buttons. They’re greyed out while the device is offline (or while another command is still in flight) so you can’t queue something that won’t run.

ButtonWhat happens on the Mac
LockLocks the screen immediately.
SleepPuts the Mac to sleep. (asks you to confirm)
Lock + SleepLocks, then sleeps. (asks you to confirm; offers an “In 5 minutes” option)
Keep awakeStops the Mac sleeping for a set time — pick 30 min / 1h / 2h or a custom amount (up to 24h).
Stop keep-awakeEnds the keep-awake window early.
MuteToggles output mute.
Vol − / Vol +Lowers / raises system volume one step.

After you tap, the action is queued and the Mac runs it on its next poll — usually within a couple of seconds. Sleep and Lock + Sleep may keep showing queued until the Mac wakes, because the Mac confirms the result only after it wakes back up. That’s expected.

”In 5 minutes” and delayed locks

Section titled “”In 5 minutes” and delayed locks”

Lock + Sleep offers an In 5 minutes option: instead of locking now, the Mac waits five minutes, giving you a grace period to cancel. While a delayed lock is pending you’ll see a countdown pill with a Cancel button — tap it and the lock is dropped. (The same countdown shows in the Mac’s menu bar and can be cancelled from there or with commandlatch done --cancel.)

This is the same mechanism the Claude Code hook uses to lock your Mac a few minutes after a task finishes.

Activity (command history)

Section titled “Activity (command history)”

The Activity view is a log of every command across all your devices — what was run, when, how it was triggered (dashboard, CLI, Siri, webhook, hook), and whether it succeeded or failed (with the error). Filter by device or by status to answer “did that lock actually go through?” after the fact.

Pausing remote control

Section titled “Pausing remote control”

Remote control is paused from the Mac, not the dashboard — the menu-bar app owns that switch. Flip Disable Remote Commands in the menu bar (or Accept remote commands in its Settings) and all incoming actions are blocked — dashboard, shortcuts, webhooks, and CLI alike — until you re-enable it from the Mac.

The dashboard reflects this state but can’t change it: a disabled device shows Remote commands: Disabled under Agent health, greys out its action buttons, and displays a banner. To leave a Mac alone without unpairing, disable remote commands on the Mac; to remove it entirely, unpair it.

Removing a device

Section titled “Removing a device”

To unpair a Mac from your account, open it and use Remove this device (you’ll be asked to confirm). The Mac disappears from your list and stops accepting commands. To also clear the local record on the Mac, unpair there too — see Pair → re-pairing.

Shortcuts and webhooks

Section titled “Shortcuts and webhooks”

Two tabs/sections let you create reusable triggers for a device:

  • Shortcuts — a single-tap URL for one action on one device, perfect for Siri or a Home-Screen button. Walkthrough: Siri & phone shortcuts.
  • Webhooks — a signed HTTP endpoint for scripts and automation tools. Reference: Webhooks.

Both create a credential the dashboard shows you exactly once — copy it right away. You can delete (revoke) either at any time, and that link stops working immediately.

Use it on your phone

Section titled “Use it on your phone”

Open https://app.commandlatch.app in your phone’s browser. Signing in uses a magic link emailed to you, so you’ll need browser access to receive and open that link — a standalone installed app can’t complete the sign-in flow.

Once signed in, bookmark the page or add it to your Reading List for quick access later.

Settings

Section titled “Settings”

Settings (in the dashboard) holds:

  • Sign out.
  • About — shows the current version of the dashboard and the menu-bar app.
  • Use on your phone — tips for opening the dashboard in your phone’s browser.

See also

Section titled “See also”