The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
docs(webapp): sign-in behind the gate, sign-out and the terminal
emozilla7f1e623c7185
diff --git a/website/docs/reference/cli-commands.md b/website/docs/reference/cli-commands.mdindex e1cad077620..95b971e595f 100644--- a/website/docs/reference/cli-commands.md+++ b/website/docs/reference/cli-commands.md@@ -1944,14 +1944,19 @@ browser in as you until you run `hermes webapp --sign-out`; keep it private.For a named profile served by the default gateway (`hermes -p work webapp`), the Webapp opens on thatprofile.+Behind the dashboard sign-in gate (`webapp.host: 0.0.0.0`), the command opens the Webapp's address+instead of a one-use link, and you sign in there with your dashboard account. When the gateway cannot+serve the Webapp, the command says why; the gateway reads its Webapp settings when it starts, so run+`hermes gateway restart` after fixing the cause.+| Option | Description ||--------|-------------|-| `--no-open` | Print the one-use link instead of opening a browser |+| `--no-open` | Print the one-use link (or, behind the sign-in gate, the address) instead of opening a browser || `--skip-build` | Use the existing `apps/desktop/dist-webapp` as is || `--force-build` | Rebuild the bundle even when its build receipt is current || `--build-only` | Build the bundle and stop || `--status` | Show whether the running gateway serves the Webapp, and at which address |-| `--sign-out` | Sign out every Webapp tab; each needs a new link from `hermes webapp` |+| `--sign-out` | Sign out every tab a link signed in; their connections close and each needs a new link |```bash# Turn it on once, then open itdiff --git a/website/docs/user-guide/configuration.md b/website/docs/user-guide/configuration.mdindex 7f4b8333594..ecb46535d4c 100644--- a/website/docs/user-guide/configuration.md+++ b/website/docs/user-guide/configuration.md@@ -3175,7 +3175,7 @@ webapp:```- `enabled` — the gateway reads it at start; restart the gateway after changing it (`hermes gateway restart`).-- `host` — a loopback address keeps the Webapp on this machine. `0.0.0.0` or `::` makes it reachable from other machines and requires a [dashboard sign-in provider](./features/web-dashboard.md#authentication-gated-mode); without one the gateway serves native clients only and `hermes webapp --status` says why. Any other value keeps the Webapp off.+- `host` — a loopback address keeps the Webapp on this machine. `0.0.0.0` or `::` makes it reachable from other machines and requires a [dashboard sign-in provider](./features/web-dashboard.md#authentication-gated-mode); without one the gateway serves native clients only and `hermes webapp --status` says why. Restart the gateway after adding the provider. Any other value keeps the Webapp off.- `port` — when the port is taken, the gateway likewise serves native clients only and `hermes webapp --status` reports why.The Webapp settings are read from the config of the gateway that serves the profile: the default profile's config for named profiles it serves, a standalone profile's own config otherwise.diff --git a/website/docs/user-guide/desktop.md b/website/docs/user-guide/desktop.mdindex ed6afc648a7..24d2ae63e5a 100644--- a/website/docs/user-guide/desktop.md+++ b/website/docs/user-guide/desktop.md@@ -54,15 +54,18 @@ keeps in that tab, so reloading keeps you signed in, and so does a gateway restabare URL shows instructions instead of access: run `hermes webapp` again for a new link. **NewWindow**, profile windows and session pop-outs hand the sign-in over with their own one-use link. OnmacOS the command prints the gateway's private link instead, for you to open; it signs a browser in as-you until you sign out, so keep it private. `hermes webapp --sign-out` signs out every tab.+you until you sign out, so keep it private. `hermes webapp --sign-out` signs out every tab at once: their+open connections close and each shows the sign-in instructions.For a named profile, `hermes -p work webapp` opens the Webapp on `work`. Profiles the default gatewayserves share its Webapp; a standalone profile's own gateway serves its own when its config turns it on.**From another machine.** Set `webapp.host` to `0.0.0.0`; the gateway then requires the[dashboard sign-in gate](./features/web-dashboard.md#authentication-gated-mode) (username and password-for a trusted LAN or VPN, OAuth/OIDC for anything internet-facing). HTTPS is strongly recommended-remotely and browsers require it for some microphone and clipboard features.+for a trusted LAN or VPN, OAuth/OIDC for anything internet-facing). `hermes webapp` then opens the+Webapp's address, where you sign in with your dashboard account; one-use links serve only a loopback+Webapp. HTTPS is strongly recommended remotely and browsers require it for some microphone and+clipboard features.:::warning Treat Webapp access like access to Hermes on the hostA signed-in Webapp user can run arbitrary commands as the OS account running Hermes, run agent tools,@@ -72,7 +75,8 @@ a sign-in provider. Prefer an SSH tunnel, Tailscale or another trusted VPN.`hermes webapp --status` shows whether the gateway serves the Webapp. When it cannot (the port istaken, or a wildcard host has no sign-in provider), the gateway still serves native clients and the-status says why.+status says why. The gateway reads these settings when it starts, so restart it after fixing the cause+(`hermes gateway restart`).Browser-selected files are staged under the active profile before they enter the normal attachmentflow, with a **16 MiB** limit per file. Host files download through the browser's download manager, and@@ -88,10 +92,12 @@ sessions adopt` for another profile), or open them once in the native Desktop, T### Terminal in the Webapp-The terminal rail opens the host's interactive shell, running as a child of the gateway. Refreshing the-page or losing the connection detaches the terminal without ending its shell; the saved terminal tab-reattaches to that shell and its profile. Hiding a terminal is not closing it; closing its tab ends the-shell. A second browser tab attaching to the same terminal takes over the connection.+The terminal rail opens the host's interactive shell, running as a child of the gateway, in your home+folder unless `terminal.cwd` names another. Dropping files onto it uploads them to the host (**16 MiB**+each) and types their paths. Refreshing the page or losing the connection detaches the terminal+without ending its shell; the saved terminal tab reattaches to that shell and its profile. Hiding a+terminal is not closing it; closing its tab ends the shell. A second browser tab attaching to the same+terminal takes over the connection.Detached shells are kept for **15 minutes** while the gateway runs, up to **16 host terminals**including detached ones. A gateway restart or update ends them. Reconnecting replays up to **1 MiB** of