hai-agent-runtime on loopback, like every other surface.
Basic script
After installing HoloDesktop CLI, import the agent client fromholo_desktop:
uv instead: uv run python your_script.py.
Use hosted or local mode
Hosted mode uses the same login state as the CLI. Sign in once:Keep logs for a run
To choose where runtime event logs are written:Send another message
The client exposes pause, resume, cancel, and mid-run messages:Handle cleanup
Always close the daemon:What to avoid
- Do not pass secrets or hidden context only in your app state. HoloDesktop CLI sees the task string and the configured
~/.holocontext, not your surrounding Python variables. - Do not switch
modelorbase_urlper session. Those are runtime process settings. - Do not leave a session running after your program exits. Cancel or close when interrupted.
Next steps
Debug a failed run
Inspect runtime logs and event files.
Automate an expense report
A larger task with deterministic verification.