@livedesk/client

LiveDesk Client

Run a direct LiveDesk remote client from a controlled computer.

npx @livedesk/client
npx @livedesk/client 3

The default flow opens Google sign-in, finds the active LiveDesk manager published by the same account, and connects locally. Omit the number for first-available placement, or pass 1 to 999 to pin this machine to a screen wall slot.

On the manager computer, open the LiveDesk dashboard and sign in first. The dashboard keeps its local hub address and private pair token refreshed in the LiveDesk Supabase registry for the signed-in account.

Supabase Auth must allow the CLI callback URL:

http://127.0.0.1:5198/callback

If you use a custom port, run npx @livedesk/client --auth-port 5200 and add the matching callback URL to Supabase Auth redirect URLs.

For manual LAN fallback, start @livedesk/hub with an externally reachable RemoteHub host and pass the address/token explicitly:

$env:REMOTE_HUB_HOST="0.0.0.0"
$env:REMOTE_HUB_PORT="5197"
npm run dev:hub

npx @livedesk/client --no-login --manager 192.168.0.10:5197 --pair <strong-token> --slot 2

The client registers the device, sends status heartbeats, can return manager-requested thumbnails, can stream a focused view-only live screen, and can receive safe task-only instructions.

By default, the launcher uses the packaged C# RemoteFast engine when supported. It falls back to the Node engine for AI assist or when a compatible .NET runtime is unavailable.

Useful flags:

npx @livedesk/client 3
npx @livedesk/client --no-thumbnail
npx @livedesk/client --no-live
npx @livedesk/client --engine node
npx @livedesk/client --engine fast --trace-frames
npx @livedesk/client --auth-port 5200
npx @livedesk/client --logout