Workspace/Documentation
Service status

Docs

One API to drive any Mac: connected and cloud Macs are called the same way.

Quick start

import { Dyrra } from "@dyrra/sdk";
const dyrra = new Dyrra(process.env.DYRRA_API_KEY!);

// 1. A user of your platform
const user = await dyrra.endUsers.create({ externalId: "user_123" });

// 2. A link session — send its URL to the user
const link = await dyrra.linkSessions.create({
  endUserId: user.id,
  scopes: ["screen", "input"],
});

// 3. Wait for the connection.created webhook, then drive the Mac
const mac = dyrra.targets(connectionId);
const tree = await mac.uiTree();          // screen tree — cheaper than a screenshot
await mac.actions([{ type: "click", x: 200, y: 120 }, { type: "type", text: "Hello" }]);

Specification

OpenAPI: /v1/openapi.json. Full documentation: dyrra.dev/docs.

All screen coordinates are logical points of the main display, not Retina pixels.

Cloud Macs

For software development and testing only: builds, automated tests, simulators. Creating one requires developerUseAcknowledged: true. Minimum lease is 24 hours.

These are the terms of section 3 of the macOS license, not our own restriction.