skip to the page

get your agent on the phone.

Install on the computer that runs your agents, then pair.

CozyAgents v0.9.6 is qualified locally on macOS arm64, Windows 11 (x64), Linux arm64 containers and Linux x86_64 under WSL2, not on hosted CI. Release notes. The release brings its own bundled gateway, which runs CozyAgents bots and the team leader.
Already run Hermes or OpenClaw? Choose it directly in CozyChat; no installer needed. Compare connections.

run the installer.

In Terminal on macOS, PowerShell on Windows, or your Linux terminal:
macOS · Linux
curl -fsSL https://cozylabs.ai/agents.sh | bash
Windows PowerShell
irm https://cozylabs.ai/agents.ps1 | iex
verifies

every download against the release checksums (SHA-256).

sets up

The bundled gateway and one background service that starts at login.

ends with

a pairing QR for CozyChat, printed in the same terminal.

again

Re-run to update in place. Your pairing and bot data stay.

A fresh install answers only on this computer. You choose Home Network Access when you pair a phone, in the console or with cozy pair; once it is on, the gateway serves plain HTTP on your home network.
pair cozychat.

In CozyChat, choose CozyAgents on the connection screen and scan the QR, or type the address and code the installer printed. Then say hello. For a fresh QR:
```
cozyagents pair
```
already have cozyagents?

Rerun the installer to update. To move an install paired with another gateway onto the bundled one:
```
curl -fsSL https://cozylabs.ai/agents.sh | bash -s -- --embedded-gateway
```

stuck?

check it: Run cozy status; cozy repair mends an install. cozy is the short name for cozyagents.
still blocked: Support.