FAQ

Practical answers about Hermes Fleet.

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

32 answers

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.

Where do I get the app?

Hermes Fleet is in a public TestFlight beta. Install TestFlight from the App Store, then open the invitation at https://testflight.apple.com/join/SRp1Z7Sb. It is not on the App Store yet.

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 supported credentials, or use Hermes Fleet Connector 0.3.0: ask Hermes for a link with /fleet pair in a private chat or run hermes fleet pair on the Hermes computer, then open or scan the link in Fleet. Compare the six-digit code and have the owner approve that exact code. An enrolled phone receives broad fleet:operator access, so pair only devices you trust. Prefer TLS-protected endpoints, especially outside trusted local networks.

What device do I need?

An iPhone or iPad running iOS 26 or later (deployment target iOS 26.0). The app is designed for iPhone. An iPad-optimized layout is tracked but not done yet.

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?

The built-in setup prompt checks for the Fleet Connector and explains what is missing. It asks before installation or service changes and does not guess a source URL or command. Pairing is available after the connector is installed and configured; the server owner approves the exact code shown in Fleet.

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.

What is Live Ops, and do I need the plugin?

Live Ops shows running operations, subagent trees, timelines, and approvals waiting on gateways that report them. Hermes Fleet Connector 0.3.0 bundles read-only reporting; there is no separate Fleet Live Reporting download. Enable its fleet-liveops component only for profiles you want to observe. Reporting supports compatible in-process launch-profile backends; mixed-profile, secondary-hosted, and host-isolated setups remain unsupported. Fleet never fills gaps by guessing from transcripts.

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.

Groups, rooms & RoomLink

Can bots on different gateways share a room?

Yes, via cross-gateway groups: create the room on the home gateway, invite on the target gateway, then register on the home gateway. Afterwards the two gateways exchange room traffic directly with each other — the iPhone is controller-only. Cross-gateway rooms are text-only; RoomLink does not carry attachments.

What happens when I promote a replica?

Promotion continues the room on the promoting gateway at epoch + 1. It is only offered for a caught-up replica of a foreign authority and always requires explicit confirmation. Important: promotion does not fence the previous authority — Fleet cannot verify that the old writer has been externally fenced, so the operator must confirm the previous authority can no longer commit before taking over. A timeout, a disconnect, or a Stop operation is not sufficient proof of fencing.

I mentioned a bot that lives on another gateway — was the DM delivered?

Not guaranteed. A remote mention passes the bot's identity to the agent, but Fleet does not verify or carry the remote messaging route; delivery depends on gateway-side support. In cross-gateway rooms, the gateways exchange traffic directly.

Management & platform

Is there an Android, Mac, or Vision Pro app?

Not currently. Fleet is a native iOS app. It runs on iPhone and on iPad (an iPad-optimized layout is tracked but not done), and no Android, Mac, or Vision Pro version is documented.

Can I edit Kanban cards from the app?

Yes, when the connected gateway exposes a board operator. Task creation, updates, and bulk changes are sent to the gateway, and a failed write never appears as a successful local change. Without a board operator the board is read-only. Other management surfaces (scheduling, skills, Projects, memory and the learning graph, connection health) also depend on gateway support.

Approvals & security

How do approvals work?

When an agent asks for something dangerous, the card names the gateway, bot, working folder, and session it came from. Long commands keep Approve disabled until you review the full redacted text. Approve needs Face ID, with your device passcode as fallback. Deny is one tap and never gated. Reason text from the gateway is labelled untrusted.

Are approval responses cryptographically signed?

Not yet. Gateway-verifiable, request-bound approval signatures are a tracked upstream proposal, and a device-key design is under consideration. Today the protection is the presence check on your phone plus the gateway’s own authentication and transport security.

What are App Lock and the privacy shield?

App Lock asks for Face ID or your passcode before the app opens. While it is on, Fleet covers its window with a blank branded screen when the app becomes inactive, so conversations stay out of the app-switcher preview. Nothing is captured for this, and turning App Lock off turns the cover off.

Are my unsent drafts saved, and where?

Yes. Drafts persist per conversation across navigation, App Lock, and relaunch, and are cleared only after a successful send. They are stored on the device with complete file protection, excluded from backup, and bounded to 50 drafts, 20,000 characters each, and 30 days. Removing a gateway deletes its drafts.

Data & privacy

What data does Fleet collect?

Fleet does not include advertising identifiers, third-party analytics, or a Hermes Fleet account, and gateway content goes to the gateway you select. Build 98 does not register with the push notification relay. The privacy policy describes the relay data if a release uses it. 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 only when you explicitly submit them. Voice recognition runs on-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.

The rest is easier to see than to read.

Fleet is a free public TestFlight beta for iPhone and iPad. Bring a Hermes gateway you control.