npm install -g @autenai/sdk

$ auten login
Relay base URL [https://relay.auten.ai]:
API key: ********************************
  ✓ Authenticated as my-team — 1 device(s), 0 task(s).
  ✓ Saved to ~/.autenrc

$ auten add-phone
  → USB pair wizard. Confirm the permissions on the phone.
  ✓ Pixel 7 (P3K2H7N) connected to the relay.

import { Auten } from "@autenai/sdk";
 
const auten = new Auten({ apiKey: process.env.AUTEN_API_KEY! });
 
const task = await auten.tasks.run({
  device: (await auten.devices.firstOnline())!.serial,
  prompt: "Open Chrome and search for 'auten.ai'",
});
 
console.log(task.status, task.result?.summary);

new Auten({
  apiKey: string;          // sk_live_... or sk_test_...
  baseUrl?: string;        // default: https://relay.auten.ai
  timeout?: number;        // ms; default 30_000
})

const me = await auten.me();
// { ownerId, name, deviceCount, taskCount, plan }

auten.devices.list(): Promise<Device[]>
auten.devices.get(serial: string): Promise<Device | null>
auten.devices.firstOnline(): Promise<Device | null>
auten.devices.stats(serial: string): Promise<{
  serial: string;
  online: boolean;
  graph_edges: number;
  task_count: number;
  cache_hit_rate: number;   // 0..1
}>

type Device = {
  serial: string;
  model: string | null;
  online: boolean;
  type: string;                  // "physical" | "emulator"
  lastSeenAt: string | null;
  androidVersion: string | null;
  screenW: number | null;
  screenH: number | null;
};

type Speed = "fast" | "instant" | "lightning";
type TaskMode = "task" | "explore";
type TaskStatus =
  | "queued" | "running" | "completed" | "failed" | "cancelled";
 
auten.tasks.create(input: {
  device: string;
  prompt: string;
  mode?: TaskMode;
  speed?: Speed;
  webhook_url?: string;
  webhook_secret?: string;       // HMAC-SHA256
  timeout_seconds?: number;      // default 300; 0 = unlimited
}): Promise<{ task_id: string; status: string; watch_url: string }>
 
auten.tasks.get(id: string): Promise<Task>
auten.tasks.list(opts?: {
  device?: string;
  status?: TaskStatus;
  limit?: number;                // 1..100, default 25
}): Promise<Task[]>
auten.tasks.cancel(id: string): Promise<{ task_id: string; status: string }>
 
// Poll until a terminal state. Returns the final Task.
auten.tasks.wait(id: string, opts?: {
  intervalMs?: number;           // default 1000
  timeoutMs?: number;            // default 300_000
}): Promise<Task>
 
// Sugar: create + wait.
auten.tasks.run(input, waitOpts?): Promise<Task>

auten.keys.list(): Promise<ApiKey[]>
auten.keys.create(name?: string): Promise<{ id: string; secret: string }>
auten.keys.revoke(id: string): Promise<void>
 
// Encrypted credentials per device:
auten.keys.credentials.save(opts: {
  device: string;
  service: string;
  fields: Record<string, string>;  // e.g. { username, password, 2fa }
}): Promise<void>
auten.keys.credentials.list(device: string): Promise<string[]>
auten.keys.credentials.get(device: string, service: string): Promise<Record<string,string>>
auten.keys.credentials.remove(device: string, service: string): Promise<void>

const phone = auten.phone(serial);
 
await phone.tap(x, y);
await phone.swipe({ x1, y1, x2, y2, duration_ms });
await phone.type("hello");
await phone.key("BACK");           // BACK, HOME, RECENTS, ENTER
await phone.look();                // current screen + UI tree
await phone.screenshot();          // PNG buffer
await phone.proxy("GET", "/info"); // direct HTTP to the phone
await phone.clipboardSet("text");
await phone.appLaunch("com.android.chrome");

const task = await auten.tasks.run({
  device: phone.serial,
  prompt: `
    Open Gmail.
    Find the latest email from "[email protected]".
    Reply with "On it — will send by EOD."
    Mark as read.
  `.trim(),
  speed: "fast",
  timeout_seconds: 120,
});

await auten.keys.credentials.save({
  device: phone.serial,
  service: "instagram",
  fields: {
    username: "myhandle",
    password: process.env.IG_PASS!,
    "2fa": process.env.IG_TOTP_SECRET!,  // optional TOTP
  },
});
 
// Later, the agent auto-logs in:
await auten.tasks.run({
  device: phone.serial,
  prompt: "Open Instagram and check my DMs",
});

const { task_id, watch_url } = await auten.tasks.create({
  device: phone.serial,
  prompt: "Open Settings and toggle Dark Mode",
});
 
// watch_url has a short-lived token — drop it into an iframe or img:
res.send(`<iframe src="${watch_url}" allow="autoplay"></iframe>`);

await auten.tasks.create({
  device: phone.serial,
  prompt: "Take a 30s screen recording of TikTok scrolling",
  webhook_url: "https://my-app.com/webhooks/auten",
  webhook_secret: process.env.WEBHOOK_SECRET!,
  timeout_seconds: 60,
});
// → returns immediately with task_id. Webhook fires when finished.

npm ls @autenai/sdk
# Required — @autenai/[email protected] or higher