| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667 |
- """``hermes gui`` subcommand parser."""
- from __future__ import annotations
- from typing import Callable
- def build_gui_parser(subparsers, *, cmd_gui: Callable) -> None:
- """Attach the ``gui`` subcommand to ``subparsers``."""
- gui_parser = subparsers.add_parser(
- "desktop", aliases=["gui"], help="Build and launch the native desktop app",
- description="Launch the Hermes Electron desktop app. By default this installs "
- "workspace Node dependencies, builds the current OS's unpacked "
- "Electron app, then launches that packaged artifact.")
- gui_parser.add_argument(
- "--source", action="store_true",
- help="Launch via `electron .` against apps/desktop/dist instead of the packaged app")
- gui_parser.add_argument(
- "--build-only", action="store_true",
- help="Build the desktop app but do not launch it (used by the installer's --update flow)")
- gui_parser.add_argument(
- "--fake-boot", action="store_true",
- help="Enable deterministic desktop boot delays for validating startup UI")
- gui_parser.add_argument(
- "--ignore-existing", action="store_true",
- help="Skip the installed Hermes runtime (~/.hermes/hermes-agent) so no local "
- "backend starts and Desktop offers connect or install instead. --hermes-root "
- "and the bundled runtime still win; a runtime installed during this launch is used.")
- gui_parser.add_argument(
- "--hermes-root",
- help="Override the Hermes source root used by Desktop (sets HERMES_DESKTOP_HERMES_ROOT)")
- gui_parser.add_argument(
- "--cwd",
- help="Initial project directory for Desktop chat sessions (sets HERMES_DESKTOP_CWD)")
- gui_parser.add_argument(
- "--skip-build", action="store_true",
- help="Skip npm install/package and launch the existing unpacked app from apps/desktop/release",
- )
- gui_parser.add_argument(
- "--local", action="store_true",
- help="Show the local-models UI in the desktop app (models pane, quickstart, picker rows)")
- gui_parser.add_argument(
- "--force-build", action="store_true",
- help="Force a full rebuild even if the content stamp matches")
- gui_parser.add_argument(
- "--setup-tcc-identity", action="store_true",
- help="macOS only: create/import a self-signed code-signing certificate "
- "in the login keychain and point desktop.macos_signing_identity at "
- "it, then re-sign the packaged app. Makes macOS TCC grants (Full "
- "Disk Access, Accessibility, Files and Folders, microphone) survive "
- "rebuilds with a certificate-anchored identity. Idempotent — safe "
- "to re-run after updates.")
- gui_parser.add_argument(
- "--identity", default="Hermes Local Signing",
- help="Certificate name to create/use for --setup-tcc-identity (default: Hermes Local Signing)",
- )
- gui_parser.add_argument(
- "--install-apparmor-profile", action="store_true",
- help="Linux only: install an AppArmor profile (sudo) that lets the packaged app use Chromium's "
- "user-namespace sandbox on hosts with kernel.apparmor_restrict_unprivileged_userns=1 "
- "(Ubuntu 23.10+), then exit. Survives rebuilds of the same checkout.")
- gui_parser.add_argument(
- "--close-preview",
- action="store_true",
- help="Close the preview pane and exit its fullscreen (out-of-band escape hatch when the pane captured all input)",
- )
- gui_parser.set_defaults(func=cmd_gui)
|