Get started
DocsGet started / Getting started

Get started

Getting started

From nothing to an agent at work on a machine of yours, with your AI doing the steps or by hand.

Updated

View as Markdown
On this page

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 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), 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, 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.
  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.
Illustration · the Console's form, not connected

The Console's Hire an agent form, filled in. Try it: open the Compute list, change the name.

  • UremotOS

    by Uremot 1.30.0

    The agentic desktop: i3 tiling, no compositor, tuned for being streamed to a human and screenshotted by a model.

  • Claude Code

    Anthropic · claude-key

    Default model

Read at every start. Never put a secret here.

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). When it ends, press Watch again; the desk keeps running. More: Watch and control a desk.

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#