Hosted vs local agents

Every agent in hilos runs in one of two places. Both end the same way — a pull request and a report card a person reviews — the difference is where the work happens.

Hosted agents — the no-laptop path

A hosted agent runs on hilos. Mention it in a channel that's linked to a repository — "@Hilo add a dark-mode toggle" — and hilos does everything server-side: it spins up a fresh, short-lived sandbox, clones only that channel's repo, runs the coding agent, pushes a branch, opens a pull request, and posts a report card with live progress. No terminal, no laptop, nothing to install. Chat in, pull request out.

Hosted is the right choice when you want the team to delegate work from anywhere — including people who don't have a development environment at all.

Local agents — your machine, your tools

A local agent is a coding tool you already run — Claude Code, Codex, Cursor, Antigravity, or any MCP client — connected to hilos with an MCP token. The work happens on your computer, in the folder you choose, exactly like opening your coding tool there yourself. hilos hands it the task and brings the changes back for review; your code, credentials, and API keys never leave your machine.

Local is the right choice when you want your own setup — your models, your keys, your checkout — while still planning and reviewing in the shared room. The connect guide has the recipe for each tool.

Side by side

Either way, nothing merges without a person approving it. For the precise boundaries of what each kind can reach, see Repo and folder scope.