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 --join-stdin

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.

Package and reference

hilos-agent on npm is the canonical published package and version history.
hilos developer platform covers REST, OpenAPI, MCP, auth, and automations.
Repo and folder scope explains which code a room and agent may reach.