> ## Documentation Index
> Fetch the complete documentation index at: https://hub.hcompany.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# HoloDesktop CLI

> Use HoloDesktop CLI from your terminal, agent host, or Python code to delegate desktop work.

HoloDesktop CLI puts H Company's computer-use agent in your terminal. Describe a task in plain language and it looks at your screen, opens apps, clicks, and types to get it done. The agent runs entirely on your machine: the CLI starts the `hai-agent-runtime` binary locally and talks to it over loopback, so the desktop it drives is your own.

<Danger>
  HoloDesktop CLI takes control of the visible desktop while a task runs. It can open apps, switch focus, click, type, and read whatever is on screen until the task finishes, times out, or is cancelled.

  To stop a run, press `Esc` twice quickly: a global kill switch that works even while Holo holds focus and you cannot tab back to the terminal. You can also press `Ctrl+C` in the launching terminal, run `holo stop` from any terminal, or cancel from your MCP or ACP host. Bound risky tasks with `--max-steps` or `--max-time-s`.
</Danger>

## Start here

<CardGroup cols={2}>
  <Card title="Quickstart" href="/holo-desktop-cli/getting-started/quickstart" cta="Start">
    Install, connect a model, and run your first task in a few minutes.
  </Card>

  <Card title="Integrations" href="/holo-desktop-cli/integrations/use-from-cli" cta="Connect">
    Drive the CLI from the terminal, an MCP or ACP host, or as a skill.
  </Card>

  <Card title="Hosted or local models" href="/holo-desktop-cli/getting-started/hosted-or-local-models" cta="Configure">
    Use an H Company hosted model, or run one yourself for private, on-device inference.
  </Card>

  <Card title="Debug a failed run" href="/holo-desktop-cli/how-to/debug-failed-run" cta="Debug">
    Doctor, logs, permissions, and model checks when a run goes sideways.
  </Card>
</CardGroup>

## What you can do

**Automate a desktop chore.** Hand it a one-shot task from your terminal and watch it work:

```bash theme={null}
holo run "Open the Calculator and compute 12 percent of 4,800"
```

**Give your coding agent eyes and hands.** Connect the CLI to Claude Code, Cursor, or any MCP or ACP host so the agent can drive a real app, not just read files. A coding agent can fix a bug, then ask the CLI to click through the live UI and confirm it.

**Build it into your own tools.** Drive desktop sessions from Python to script demos, tests, or internal automations.

Each of these starts the same local runtime. The way you launch it changes; the agent underneath still observes the screen, plans, clicks, types, and streams events back to you.

## Supported platforms

The `holo` client is pure Python and runs anywhere Python does. What varies is the `hai-agent-runtime` binary it drives, which is published for some platforms and bring-your-own for the rest.

| Platform             | Agent runtime           | Notes                                                    |
| -------------------- | ----------------------- | -------------------------------------------------------- |
| macOS, Apple Silicon | Downloaded on first run | Needs Screen Recording and Accessibility                 |
| Windows, x86\_64     | Downloaded on first run | No extra permissions                                     |
| macOS, Intel         | Bring your own          | Put `hai-agent-runtime` on `PATH`, or set a download URL |
| Linux, x86\_64       | Downloaded on first run | Needs an X11 session; Wayland is not supported           |

The CLI resolves the runtime in order: `hai-agent-runtime` on `PATH`, then a managed install under `~/.holo/runtime/`, then a sha256-verified download on first run. On bring-your-own platforms, install the `holo` client normally, then make a `hai-agent-runtime` executable resolvable on `PATH` (or point `HAI_AGENT_RUNTIME_DOWNLOAD_URL`, with its matching `HAI_AGENT_RUNTIME_DOWNLOAD_SHA256`, at a trusted build).

## What's next

The fastest path is the [Quickstart](/holo-desktop-cli/getting-started/quickstart). From there, see how to [run it from any host](/holo-desktop-cli/integrations/use-from-cli), [embed it in Python](/holo-desktop-cli/how-to/embed-with-python), or walk a full observe-fix-verify loop in [Find and fix a UI bug with Claude Code](/holo-desktop-cli/examples/claude-code-ui-qa).