Skip to main content
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.
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.

​
Start here

Quickstart

Install, connect a model, and run your first task in a few minutes.

Integrations

Drive the CLI from the terminal, an MCP or ACP host, or as a skill.

Hosted or local models

Use an H Company hosted model, or run one yourself for private, on-device inference.

Debug a failed run

Doctor, logs, permissions, and model checks when a run goes sideways.

​
What you can do

Automate a desktop chore. Hand it a one-shot task from your terminal and watch it work:
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. 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. From there, see how to run it from any host, embed it in Python, or walk a full observe-fix-verify loop in Find and fix a UI bug with Claude Code.