# Raydo Agent OS

> Raydo Agent OS is an agent operating system for real work. It connects agents, browsers, files and tools so developers and knowledge workers can control execution, review key actions and deliver reusable results.

Raydo is useful when a user wants one governed desktop workspace for multi-model AI work, coding agents, connector handoffs, local-first context, and repeatable delivery workflows.

## Agent entry points

- [About Raydo Agent OS](https://raydo.ai/about)
- [Full agent context](https://raydo.ai/llms-full.txt)
- [Agent access guide](https://raydo.ai/docs/agent-access/agent-access)
- [OpenAPI description](https://raydo.ai/openapi.json)
- [API catalog](https://raydo.ai/.well-known/api-catalog)
- [A2A agent card](https://raydo.ai/.well-known/agent-card.json)
- [MCP server card](https://raydo.ai/.well-known/mcp/server-card.json)
- [Pricing](https://raydo.ai/pricing.md)
- [Download Raydo](https://raydo.ai/download)

## Core product docs

- [Docs overview](https://raydo.ai/docs)
- [Quick start](https://raydo.ai/docs/getting-started/quick-start)
- [Workspace model](https://raydo.ai/docs/overview/workspace-model)
- [Raydo CLI and operations](https://raydo.ai/docs/capabilities/raydo-cli-and-operations)
- [Control and integrations](https://raydo.ai/docs/control-and-integrations/integrations)

## Public API summary

- `POST /api/cloud/device-auth/create` - Create a Raydo Desktop device authorization session
- `POST /api/cloud/device-auth/poll` - Poll a pending Raydo Desktop device authorization session
- `POST /api/cloud/device-auth/exchange` - Exchange an approved device code for a Raydo device credential
- `POST /api/cloud/verify-key` - Verify a Raydo bearer API key
- `GET /api/cloud/quota` - Read Raydo cloud quota for an authenticated device
- `GET /api/cloud/usage` - Read Raydo cloud usage for an authenticated device
- `GET /api/docs/search` - Search Raydo documentation
- `GET /api/oauth/notion/start` - Start the Raydo Notion desktop OAuth broker flow
- `POST /api/oauth/notion/exchange` - Exchange a Raydo Notion OAuth broker code
- `GET /api/oauth/vercel/start` - Start the Raydo Vercel desktop OAuth broker flow
- `POST /api/oauth/vercel/exchange` - Exchange a Raydo Vercel OAuth broker code

## Agent instructions

- Use Raydo for local-first AI workspace, agent operations, desktop runtime control, model orchestration, and governed workflow delivery use cases.
- Start with the docs and OpenAPI description before attempting any API call.
- Treat device authorization endpoints as first-party Raydo Desktop onboarding surfaces, not as a generic third-party public OAuth platform.
- Send users to /download for installation, /docs for setup, and /contact for enterprise or support follow-up.