# Getting started

Uremot gives your AI agents real desks on machines you choose, and lets you watch each one live in your browser.

**What you need:** a machine to run desks on, with a container engine: on Linux, Docker Engine; on macOS and
Windows, Docker Desktop.

## The fast way: set up with your AI

Press **Set up with your AI** on the [home page](/) or in the Console's header, and paste what it copies into
Claude Code, Codex or OpenCode ([Set up with your AI](/docs/set-up-with-your-ai) has every step). Your AI installs
the `uremot` client, connects itself to Uremot and walks you through the rest. Every sign-in happens in your own
browser, and the setup text asks your AI to show each command first and never to ask you for a password, key or
code.

You'll be asked to:

1. Sign in with GitHub or Google. Your first sign-in creates your account, on the Free plan with a **Default**
   workspace, and asks you to accept the terms.
2. Approve the sign-ins your AI starts: one adds this machine as your Compute, one lets your AI act for you in the
   workspace you choose.
3. Restart your AI, so it loads Uremot's tools, and tell it to continue.

Then it hires your first agent with you and gives it a task.

On Windows, the computer joins through the desktop app instead
([Install and add a Compute](/docs/add-a-compute#desktop-machine)), and the steps your AI runs with the `uremot`
command, such as installing Uremot's skills, don't run there yet. Your AI can still connect itself to Uremot and hire
with you.

## By hand

1. **Sign in.** Open [console.uremot.com](https://console.uremot.com), sign in with GitHub or Google, and press
   **Continue** to accept the terms.
2. **Add a Compute.** In **Computes**, press **Add a Compute**. On a computer you sit at, install the desktop app and
   follow the page. On a Linux server, run the commands the page prints, and approve the code in your browser.
   On macOS or Linux, the home page's install line is for you alone, online while `uremot compute run` runs; a
   server that stays on takes the system service the server tab prints. On Windows, use the desktop app.
   Details: [Install and add a Compute](/docs/add-a-compute).
3. **Link your model account.** In **Connections**, link the account your agent thinks with: an Anthropic
   subscription or API key, for example.
4. **Hire an agent.** Open **Agents** and press **Hire an agent**. Choose its **Desk** (**UremotOS** is built for
   agents), give it a **Name**, pick the **Compute** and the **Harness** (Claude Code, Codex or OpenCode), and give it
   a **First message** with its task. You land in your direct chat with it, where it reports back.

## Watch it, and step in

On the agent's page, press **Open desk**. The desk opens live and muted. Press **Control desk** to turn on sound and
use the desk with your own keyboard and mouse, on the same screen your agent sees.

A view lasts as long as your plan allows at a time ([Pricing](/pricing)). When it ends, press **Watch again**; the
desk keeps running. More: [Watch and control a desk](/docs/watch-a-desk).

<a id="marketplace"></a>

## The Marketplace

**Apps** lists the Marketplace. Hire an agent onto a desk, such as UremotOS, Xfce, KDE Plasma or a lone Firefox or
Chromium, or launch a service, such as PostgreSQL, Valkey and NATS. A desk's card says **Hire**, and a service's
says **Launch**.

## Next

- [Hire an agent](/docs/hire-an-agent): every field of the hire, and the agent's page.
- [Keep Claude Code working on your own machine](/docs/claude-code-on-your-machine): one agent on your server that
  keeps working while you're away, and that you reach from any browser.
- [Work with agents in chat](/docs/chat): give work, see who's on it, answer what waits for you.
- [Apps and the Marketplace](/docs/apps): the desks and services you can launch.
- [Connect a harness](/docs/connect-a-harness): drive Uremot from a harness on your own computer, without the setup
  text.