HoloDesktop CLI - H Platform Docs

HoloDesktop CLI gives Holo your screen, mouse, and keyboard. Hand it a task in plain words and it works through your real apps until the task is done. Start with the quickstart.

Two ways to run it

Surface	Command	When
Terminal	`holo run "task"`	One-shot tasks you type yourself
Agent host	`holo install`	Claude Code, Cursor, Codex, and other MCP hosts hand desktop work to Holo

Holo runs on H’s hosted Models API by default. To keep every screenshot and keystroke on your machine, point it at your own model server. See Models.

HoloDesktop CLI or the Agents API?

HoloDesktop CLI is a thin CLI over Agents API local mode.

Option	Agent runs	Drives	Use it for
HoloDesktop CLI	Your machine	Your desktop	A ready-made `holo` command and MCP tool, with your `~/.holo` instructions and skills
Agents API local mode	Your machine	Your browser or desktop	Desktop or browser sessions from your own Python code (`Client.local()`)
Agents API local control	H’s cloud	Your browser or desktop	Cloud agents that act on your machine

How it works

holo run / holo mcp ──► hai-agents SDK ──► hai-agent-runtime ──► Holo4 (hosted, or your server)
   your ~/.holo          desktop control      the agent loop

Piece	Owns
`holo`	The terminal command, the MCP server, host wiring, your `~/.holo` context
`hai-agents` SDK	Runtime download and launch, sign-in, desktop control, the kill switch, one agent per desktop
`hai-agent-runtime`	The agent: planning and model calls

Everything except the model call runs on your machine. The agent drives the screen in front of you, so it shares your mouse and keyboard while it works.

Supported platforms

Platform	Runtime
macOS, Apple Silicon	Downloaded on first run. Needs Screen Recording and Accessibility permissions.
Windows, x86_64 and ARM64	Downloaded on first run. No extra permissions.
Linux x86_64	Downloaded on first run. Needs glibc 2.34 or newer (Ubuntu 22.04, Debian 12, RHEL 9).
Other platforms	Bring your own: put `hai-agent-runtime` on `PATH`. See Runtime.

Roadmap

Background mode. The agent binds to its own window, so you keep using your machine while it works.
Native app. The same agent as a desktop app that needs no terminal.

Requests: support@hcompany.ai. Hosted runs need an API key: create one on H Platform, then run holo login.