FAQ

Practical answers about Hermes Fleet.

Questions about coverage, credentials, bots, data, and what Fleet does — and doesn't — do.

Basics

What is Hermes Fleet?
A native iPhone app for controlling Hermes Agent gateways you choose. It connects directly to your gateways, so fleet state, conversations, controls, and credentials stay between your phone and your Hermes infrastructure.
Do I need my own Hermes Agent gateway?
Yes. Fleet connects to gateways you supply and control. It does not ship with a maintainer endpoint or shared credentials, and it does not require an AIowa-hosted relay or shared operator account.

Setup & connectivity

How do I connect a gateway?
Register it in the Gateways tab by address and credentials, or use QR-assisted pairing. Multiple authentication strategies are supported, and you can register several gateways and switch between them. Prefer TLS-protected endpoints, especially outside trusted local networks.
What iPhone do I need?
An iPhone running iOS 26 or later (app deployment target: iOS 26.0).
Which Hermes gateway version do I need?
There is no published minimum. Some features depend on methods exposed by the connected Hermes gateway version; unsupported capabilities fail closed (stay unavailable with an explicit state) rather than misbehaving.
Which credential does each authentication strategy need?
None (no credential), session token, loopback token, or username + password (stored as one Keychain item). A fifth strategy name ("bearer token") exists in the app's vocabulary but is reserved for future gateway support and is not usable in this beta.
Do I need to be on the same Wi-Fi as my gateway?
No, but your iPhone must reach the gateway over the network path used at setup: same LAN, VPN/overlay, or HTTPS tunnel. Local-network gateways need iOS local-network permission.
How do I rotate or revoke a credential?
Rotate at the gateway, then edit the credential in the app (Gateways ▸ gateway ▸ edit) and re-test. Removing a gateway removes its stored credential and gateway-local cached data.
I already have Hermes on a machine — can it set up the gateway for me?
Yes: copy the built-in setup prompt (first-run gate or Settings ▸ Set Up Another Server) and send it to your Hermes agent. It inspects non-destructively, prefers existing supported configuration, never enrolls you in third-party services without asking, creates a scoped least-privilege credential, verifies end-to-end from your phone's network path, and replies with URL + username + password + method.

Fleet Home & coverage honesty

Why does Fleet say "N known items" instead of showing an empty list?
Needs You is known-items only: it lists already-observed actionable items — classified gateway authentication or configuration failures, plus attention observed in rooms this phone has opened. Unobserved rooms contribute nothing, so incomplete coverage is labeled "N known items" rather than reading as a complete (empty) inbox. There is no fleet-wide pending-action summary.
Why doesn't Active Now show all my bots?
Active Now is real execution only. Working/thinking/using-tool states come from actual roster signals, and a recent worker heartbeat renders as "Recent worker activity" — never as executing. There is no fleet-wide execution telemetry, so unseen bots are not claimed to be idle.
A gateway shows "unknown" — is it down?
Not necessarily. Not-yet-loaded bot counts, partial outages, and unclassifiable gateways display as unknown or partial — never as "0" or "all quiet". Unknown means Fleet does not have the fact yet, not that the fleet is empty or idle.
Why is my Continue list different on another phone?
Continue is device-local: a recent-open index stored on this phone, at most 50 references with 30-day retention, pruned when gateways are removed or destinations tombstone. It is not synchronized across devices and implies nothing about other clients.

Conversations & bots

Does Fleet work without a gateway connection?
Partially, from cache. Cached conversation history is preserved for cold-start presentation, and fleet/conversation snapshots may be cached locally to make recently viewed screens useful during a temporary disconnect. There is no documented offline mode beyond this.
What can I do with bots?
The Bots tab is a fleet-wide roster of every bot on every registered gateway, with the full bot lifecycle: create bots; edit name, display name, description, model/provider, SOUL, and Skills/Toolsets/MCP toggles; delete with confirmation. Organize the roster with sections, hide bots from the default view (they stay mentionable), and pin bots to the top. Bots have real avatars, including a generated-portrait workflow with preview and explicit confirm or discard. Bot Routines schedule bots on interval or time-of-day schedules.
What happens when I type /new or /reset in a Bot Chat?
They are intercepted and replaced with /compact. Each bot has one continuous canonical chat, and its context is never silently reset.
Two of my bots have the same name — how do mentions work?
Mention autocomplete uses the fleet-wide roster and disambiguates duplicates: a bare name when it is unique, a gateway-qualified label when it is not (@researcher-mac vs @researcher-4090), and a short deterministic suffix only when the qualified label still collides. A mention identifies a teammate; dispatch happens through the agent, not the client.

Management & platform

Can I edit Kanban cards from the app?
No. The Kanban surface is intentionally read-only in the current client. Other management surfaces — cron, skills, Projects browsing, memory/learning graph browsing and supported mutations, connection-health details — depend on gateway support.
Is there an Android, iPad, or Mac app?
Not currently. Fleet is a native iPhone app; no Android, iPad, Mac, or Vision Pro version is documented.

Data & privacy

What data does Fleet collect?
None beyond what the app needs to run. Fleet does not include advertising identifiers, third-party analytics, or a Hermes Fleet account, and it does not operate a central service that receives gateway content. Gateway credentials and short-lived connection tokens are stored in the iOS Keychain; cached fleet and conversation snapshots are device-local. Attachments and message content go to the gateway you select, only when you explicitly submit them. If you use voice input, speech recognition runs on the device, and audio is not intentionally uploaded by Hermes Fleet.
How do I delete my data?
Remove a saved gateway and Fleet removes its stored credential and gateway-local cached data. Deleting the app removes its local data, subject to iOS backup and device-management behavior. Data already sent to a gateway is controlled by that gateway's operator and must be deleted through the gateway's own controls.

Support & reporting

Who makes Fleet, and how do I report a bug or a security issue?
Fleet is made by AIowa LLC and is open source under the MIT License at github.com/AIowa-LLC/hermes-fleet. For bugs and feature requests, use the GitHub issue tracker. Report security vulnerabilities privately per the repo's SECURITY.md — and never include credentials, private gateway addresses, pairing QR contents, or conversation transcripts in a public issue.