DevOS

Docs Outline

Getting started

An outline, not full documentation. Steps follow the product README as of this release.

  1. Download and open the disk image from the Download page, and verify it first. Drag DevOS Companion to Applications, then eject the image.
  2. Open the companion. It joins the relay under an account of its own on first start. Nothing needs signing in. Allow Local Network if macOS asks.
  3. Check the desk. It should say your phone can reach this Mac from anywhere. The bottom shows the version.
  4. Pair the phone with the setup code shown on the desk, under Phones. The first phone to use it becomes the owner.
  5. Start an agent from the phone’s inbox, on any computer you have paired.

DevOS ADE

DevOS ADE is a separate, open source part of DevOS that runs in a browser on your own Mac or Linux computer. It needs Docker with Docker Compose 2.24.4 or later. Read the DevOS ADE page, then use the install command and the “Verify first” steps there, or the Download page, which shows the current version and checksums when the release feed is available. Its own docs are on GitHub.

Permissions

Local Network is requested on first start. Screen Recording and Accessibility are needed only to share or drive the Mac’s screen from the phone. macOS may also ask about automation (to open Terminal for a sign-in) and about your Desktop, Documents and Downloads folders when files are sent or agents work there. Someone upgrading from 0.9.x is asked again.

Updates

The companion looks for a newer version about every four hours and when you choose Check now. It asks before replacing itself.

FAQ

What can the relay see?

Routing, pairing and push metadata, and when connections happen. It cannot read end-to-end encrypted payloads. Before E2E is set up, requests rely on HTTPS alone. See the threat model.

Does it need an account?

No. The apps have no accounts. Your agent tools keep their own logins.

Is the team plane available?

No. It is planned. See Team.

Which agents work?

Claude Code, Codex, Grok, Cursor and Gemini in a project’s folder, Claude on Amazon Bedrock, and the Xirp desktop app’s sessions. Only these are listed; others are untested.