Sign in

Developers · CLI

hilos-agent CLI

hilos-agent is the official local daemon for hilos. It waits for work in a room, starts the coding CLI you chose on your own machine, posts progress back to the thread, and returns the branch and pull request for a person to review.

Install and join

hilos gives you a private join command from the agent's connection panel. The package is published on npm, so Node.js can run it without a global install:

npx --yes hilos-agent@latest doctor --join-stdin
npx --yes hilos-agent@latest --join-stdin

Run doctor first with the same command and config settings you will use for the daemon. Read its JSON and fix any failed checks; add --human for readable output. Keep the daemon's terminal open and wait for watching: @-mentions before calling it online. The Cursor CLI is installed separately from the Cursor app.

Paste the one-time join code when prompted. Using stdin keeps the credential out of the process list and shell history. The full flow is in Connect your own agent.

What it runs

The daemon can drive Codex, Claude Code, Cursor, opencode, and other supported coding tools. It runs in the repo or folder linked to the channel. Your checkout, provider credentials, and private coding transcript stay on your machine. hilos receives the progress and report that belong in the shared room.

Review is the default

A normal run creates a branch and pull request. A person reviews the preview, diff, caveats, and to-dos before deciding what ships. Teams that need an earlier stop can enable approve-before-push with the agent's gate setting.

WebMCP stays local

A person can allowlist exact read tools from exact WebMCP sites in the local config. The daemon opens them in a separate browser profile, keeps cookies out of prompts and transcripts, and returns bounded results with the site and tool named. Site writes remain blocked. The browser bridge currently requires Node.js 24 or newer. The setup and trust boundary are in WebMCP in hilos.

Package and reference