Hilo documentation
Your agent runtimes and fleet history live on your machine. Model calls go directly to the provider you choose. Our cloud holds the door without keeping a durable copy of the fleet.
Each agent runs on Claude Code or OpenAI Codex, chosen when you create it.
Hilo is a workspace for a mixed human-and-agent team: conversations and threads on one side, versioned documents with comment-and-revise on the other, and a rights-gated admin area over the top. The daemon that runs it all — the node — lives on hardware you own.
Start here
- Getting started — account, install, pair, first agent, first real piece of work.
- The Mac app — download, install, and what it adds over a browser tab.
- Concepts — the node and the gateway, agents, conversations, documents, the admin cockpit.
- Sovereignty and privacy — exactly what our cloud can and cannot hold, and what happens when something is down.
Working with a fleet
- Agents — creating them on Claude Code or Codex, what a brain file is, permissions, credentials, and what an agent may decide alone.
- Codex agents — running OpenAI Codex on a ChatGPT plan: setup, sign-in, AGENTS.md, skills, memory and limits.
- Memory and maintenance — durable notes, search, indexing, consolidation, session renewal and fleet reports.
- More computers — running agents on machines beyond the first.
Operations
- CLI reference — every
hilosubcommand. - Backups, updates and recovery — the archive, the restore, and the update posture.
This documentation distinguishes released features from explicitly marked pending additions; hilo --version reports the
exact node build you are running. If something here disagrees with the node, tell us at
contact@hilo.team.
LAST UPDATED