An AI hand on any computer, one code away.

Your customer installs GuidingHand and types a code. Your team or your agent sends a task, and GuidingHand does it on their screen, with live progress, questions, and approvals.

Your pairing code

••••-••••

Generate a code to begin

macOS Windows

Mac download is for Apple silicon. Intel Mac

Session token: use it as Authorization: Bearer … for the API

Keep this token private. Anyone who has it can send tasks to the paired computer.

How it works

01Get a codeGenerate a pairing code here. Each code is its own session.

02Enter it in the appInstall GuidingHand on the Mac or PC and type the code. The computer is now connected.

03Send tasksCall the API with a prompt. Stream progress, answer questions, approve sensitive steps, or stop at any time.

API

POST/start

start_computer_task: start a task with prompt and optional request_id. Returns the task id and first progress message.

POST/wait

wait_for_computer_task: get the next update with id + after (cursor). Answer with question_id + answer, or approve with approval_id + decision.

POST/stop

Interrupt a task with its id.

GET/health

Check that the server, the agent, and the paired computer are available.

curl -s https://guidinghand.ai/start \
  -H "Authorization: Bearer $GH_TOKEN" -H "Content-Type: application/json" \
  -d '{"prompt":"Open System Settings and turn on Dark Mode","request_id":"ticket-4812"}'

# → {"id":"task_…","status":"running","cursor":1,"update":{"type":"started",…}}

curl -s https://guidinghand.ai/wait \
  -H "Authorization: Bearer $GH_TOKEN" -H "Content-Type: application/json" \
  -d '{"id":"task_…","after":1}'

# answer a question:   {"id":"task_…","after":7,"question_id":"q_…","answer":"The work account"}
# approve an action:   {"id":"task_…","after":9,"approval_id":"appr_…","decision":"approve"}

Machine-readable tool definitions: /tools.json