Getting started
Your host, connected.
Graze is in development. These requirements describe the current release candidate.
What you’ll need
- An iPhone or iPad running iOS/iPadOS 27, or an Apple Watch running watchOS 27.
- A running herdr host and the matching Graze bridge. The bridge talks to herdr’s local Unix socket.
- An HTTPS bridge address with a certificate trusted by the device, plus a bridge access token supplied by the host operator.
- For voice, speech-to-text and text-to-speech services configured on the bridge. Provider accounts and any usage charges are managed separately.
Connect a device
- Have your host operator start herdr and the bridge, and verify the bridge is reachable from your device.
- Open Graze’s Connection screen. Enter the HTTPS address and access token, then choose Connect.
- Select an agent. Check its name, project, and host before sending a message.
- To speak, allow microphone access, record, then review the transcript before sending. Listening uses an AI-generated voice.
Using a private network
A private route such as Tailscale can connect supported devices to your host. Graze does not include a VPN client. Installing a VPN on an iPhone does not by itself establish a working route for an independent Watch app. Validate each device on the network you intend to use.
The development simulator can reach a Mac-local bridge through an SSH
tunnel. A physical phone or Watch cannot use that Mac’s
localhost address. It needs its own reachable HTTPS
endpoint.
Host access is powerful
Treat the bridge token like a password for your development host. Management actions can send terminal input, close workspaces, and change host configuration. Share access only with people you intend to grant those abilities, and use an isolated host for evaluation.
Current limits
Agents and terminal excerpts refresh periodically while the app is active. This is not an always-on background session or a complete terminal emulator. Physical-device voice, audio interruptions, and standalone Watch cellular operation still need release validation.