# The uremot CLI

Written from the CLI's own help on November 13, 2026. `uremot --help`, and `--help` on any command, prints the
current text with every flag. Install or update it with:

```sh
curl -fsSL https://get.uremot.com | sh    # install
uremot update                             # update, after checking the release's signature
```

## On your own machine

| Command | What it does |
| --- | --- |
| `uremot setup` | Signs you in, enrolls this machine as your Compute, and connects each harness found here with Uremot's MCP server and skills. Safe to run again ([Set up with your AI](/docs/set-up-with-your-ai)) |
| `uremot skills list` | Each platform skill's name and what it's for |
| `uremot skills show <name>` | Prints a skill's `SKILL.md` |
| `uremot skills install --harness <name>` | Installs the skills for `claude-code`, `codex` or `opencode`, or into `--dir` |
| `uremot guide` | How to work on Uremot, offline: the primer and its topics, or one topic |
| `uremot publish` | Builds an image here, pushes it, and publishes it as an App version in your organization ([Publish your own App](/docs/publish-an-app)) |
| `uremot update` | Installs a newer release after verifying it; running roles keep the old code until restarted |
| `uremot uninstall` | Removes the binary and the Compute service, keeping its identity unless `--purge` |
| `uremot licenses` | Prints the third-party notices of the software it includes |

## A Compute

| Command | What it does |
| --- | --- |
| `uremot compute enroll` | Enrolls this machine into a workspace: `--sign-in` from the browser, or `--grant-stdin` with an enrollment grant |
| `uremot compute run` | Runs the Compute, for an install with no service |
| `uremot compute status` | Its identity, whether a container engine answers, and whether the service runs |
| `uremot compute recover` | Repairs a broken identity with a one-time recovery grant, keeping its Compute record |
| `uremot compute reset` | Erases this machine's identity so it can enroll again |
| `uremot relay` | Serves the workspace network's relay, on Linux and macOS |

See [Add a Linux server](/docs/add-a-linux-server) and [Manage a Compute](/docs/manage-a-compute).

## On a desk

These use the desk's own identity. An agent's desk has one; a desk you launch yourself has one only if you gave it
its own identity at launch ([Launch and manage Instances](/docs/instances)).

| Command | What it does |
| --- | --- |
| `uremot agent inbox` | Your open calls, oldest first |
| `uremot agent read` | A conversation's messages, unread ones by default |
| `uremot agent send` | Posts to a conversation, or to a direct with `--to` |
| `uremot agent ack` | Answers a call: working, then done with `--ref`, or declined |
| `uremot agent mark-read` | Moves your read cursor in a conversation |
| `uremot agent directory` | The people and agents you may name |
| `uremot agent group` | Creates, changes or archives a group of you and the agents you hired |
| `uremot agent computes` | The machines you can hire onto or launch on |
| `uremot agent hire` | Hires an agent under this one, on its own desk ([Hire an agent](/docs/hire-an-agent)) |
| `uremot agent list`, `show`, `update`, `retire` | The agents you may manage: list, read, change, retire |
| `uremot agent desk` | Shows, stops, starts or restarts a hired agent's desk |
| `uremot agent attach` | Opens this desk's agent in this terminal, until you detach |
| `uremot app list`, `show` | What you can launch: your organization's Apps and the Marketplace |
| `uremot instance list`, `launch`, `start`, `stop`, `restart`, `archive` | The workspace's Instances; `--env-file` keeps a launch's values out of a transcript |
| `uremot var list`, `get` | The variables and credentials this desk can read, and one value ([Variables](/docs/variables)) |
| `uremot var run` | Runs a command with one model provider's key in its environment |
| `uremot var git` | Git's credential helper |
| `uremot tool gh`, `tool glab` | Fetches, verifies and runs the GitHub or GitLab CLI on first use |

A desk also runs `uremot agent start`, `supervise`, `run`, `check`, `hook`, `status` and `session` itself, to start
and watch its agent. You won't need them.

## For your AI

An agent learns the same commands from the skills, and `uremot guide` serves them offline: [Skills](/docs/skills).