Agent Device Cloud
Sign in

Quickstart

Your first call in five steps

Pair one device, share one folder read-only and let an agent list it. Add write access or commands later, once this works.

Before you begin

  • A computer running macOS 13.5+ or glibc 2.28+ Linux (arm64/x64), or Windows 10/11 x64. The installer brings its own runtime.
  • Permission to install user-level background services on it. No admin rights or open ports are needed.
  • An account on the official service or your own deployment.

Windows Node and Android Node are in testing. They are available to try, but compatibility and reliability are still being validated. An available installer does not mean every system, phone model or operation has been verified.

  1. 01

    Create an account

    Register with email or GitHub. The console opens on an overview with your setup progress.

    Create an account
  2. 02

    Pair a device

    Open Devices → Pair device, choose the platform and run the generated command on that computer. The pairing code is single-use and short-lived. On Windows, choose Windows PowerShell to get a PowerShell command.

    macOS / Linux
    curl -fsSL https://adc.220719.uk/install.sh | sh -s -- \
  --url https://adc.220719.uk --code 'PAIRING_CODE'

    The device shows Online in Devices. adc-node status reports it as connected.

  3. 03

    Share a folder

    The installer asks which folders to expose. To add one later, run this on the device. Agents can never see folders you have not exposed.

    On the device
    adc-node roots add ~/work --label Work --read-only
adc-node roots list
  4. 04

    Authorize your agent

    Open Agent access → Authorize agent. Name it my-agent, select the device and folder, choose Read only and No approval for now.

    my-agent lists exactly one device, one folder and read tools only.

  5. 05

    Make the first call

    With a plugin or the Skill installed, just tell your agent:

    Say to your agent
    Help me start using ADC, then list the files in my Work folder.

    Or use the CLI, which the installer already put on the device:

    Terminal
    adc login --url https://adc.220719.uk
adc connect my-agent
adc invoke file.list --args '{"path":"/Users/me/work"}' --wait --json

    The result has "status": "succeeded", and the call appears in Activity with its receipt.

Using ADC for Android (in testing)

Download ADC for Android, sign in with email or approve browser / GitHub authorization in a Custom Tab, then open This phone to connect it to your account and start the Node. Registration, recovery requests, profile/password settings and help are native screens. Devices lists your computers and phones and supports renaming, access settings and removing connections. A pairing code and HTTPS service address also work for self-hosting. Account → Language offers Follow system, 中文 and English; notifications and update notes follow that choice without restarting the Node.

Download Android APK (in testing)

Device status, location, notifications, volume, vibration, app launch, flashlight, screen sharing, interface reading and interface actions have separate local controls. Android permissions and account / agent policies still apply. Screen sharing needs fresh system consent; location is available only while the app is visible. Signing out leaves the phone Node connected; stop it in This phone. Updates are checked from Account and verified before Android asks you to install. This test channel retains its development signing certificate for in-place upgrades.