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.