| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211 |
- """Hermes Agent Uninstaller."""
- import os
- import shutil
- import subprocess
- import sys
- from pathlib import Path
- from hermes_constants import get_hermes_home
- from hermes_cli.colors import Colors, color
- def _logger(mark: str, col: str):
- return lambda msg: print(f"{color(mark, col)} {msg}")
- log_info = _logger("→", Colors.CYAN)
- log_success = _logger("✓", Colors.GREEN)
- log_warn = _logger("⚠", Colors.YELLOW)
- def _print_box(middle: str, col: str) -> None:
- """Print the 3-line framed heading used by the uninstall screens."""
- print(color("┌─────────────────────────────────────────────────────────┐", col, Colors.BOLD))
- print(color(middle, col, Colors.BOLD))
- print(color("└─────────────────────────────────────────────────────────┘", col, Colors.BOLD))
- def _prompt(text: str):
- """``input(text).strip().lower()``; None (after printing "Cancelled.") on Ctrl-C/EOF."""
- try:
- return input(text).strip().lower()
- except (KeyboardInterrupt, EOFError):
- print()
- print("Cancelled.")
- return None
- def _cancelled() -> None:
- print()
- print("Uninstall cancelled.")
- def _confirm_yes(text: str) -> bool:
- """Ask the user to type ``yes``; False (after the cancel line, unless Ctrl-C/EOF) otherwise."""
- confirm = _prompt(f"Type '{color('yes', Colors.YELLOW)}' {text}: ")
- if confirm != "yes" and confirm is not None:
- _cancelled()
- return confirm == "yes"
- def _remove_each(candidates, remove) -> list:
- """Run ``remove(path)`` per candidate, collecting the ones it reports removed; failures become
- the shared ``Could not remove <path>: <err>`` warning."""
- removed = []
- for path in candidates:
- try:
- if remove(path):
- removed.append(path)
- except Exception as e:
- log_warn(f"Could not remove {path}: {e}")
- return removed
- def get_project_root() -> Path:
- """Get the project installation directory."""
- return Path(__file__).parent.parent.resolve()
- def code_removal_refusal() -> str | None:
- """Why the uninstaller must not remove this tree's code, or ``None``.
- A git checkout (the install.sh / install.ps1 / `hermes desktop` layout)
- is ours to remove. A sealed tree (no ``.git``) belongs to a steward —
- the Nix store, the bundled desktop app, a Docker image — and only the
- steward removes it. Returns the user-facing refusal text for sealed
- trees; the text always points at ``hermes uninstall --data`` for the
- user-data cleanup that IS allowed everywhere.
- """
- from hermes_cli.steward import sealed_steward, steward_uninstall_message
- steward = sealed_steward(get_project_root())
- if steward is None:
- return None
- return steward_uninstall_message(steward)
- def _refuse_if_steward_owned() -> None:
- """Exit with the steward's instructions when code removal is forbidden."""
- refusal = code_removal_refusal()
- if refusal is None:
- return
- print()
- print(refusal)
- print()
- raise SystemExit(1)
- def find_shell_configs() -> list:
- """Find shell configuration files that might have PATH entries."""
- home = Path.home()
- configs = []
-
- candidates = [
- home / ".bashrc",
- home / ".bash_profile",
- home / ".profile",
- home / ".zshrc",
- home / ".zprofile",
- ]
-
- for config in candidates:
- if config.exists():
- configs.append(config)
-
- return configs
- def remove_path_from_shell_configs():
- """Remove Hermes PATH entries from shell configuration files."""
- removed_from = []
- for config_path in find_shell_configs():
- try:
- content = config_path.read_text(encoding="utf-8-sig")
- original_content = content
-
- # Remove lines containing hermes-agent or hermes PATH entries
- new_lines = []
- skip_next = False
-
- for line in content.split('\n'):
- # Skip the "# Hermes Agent" comment and following line
- if '# Hermes Agent' in line or '# hermes-agent' in line:
- skip_next = True
- continue
- if skip_next and ('hermes' in line.lower() and 'PATH' in line):
- skip_next = False
- continue
- skip_next = False
-
- # Remove any PATH line containing hermes
- if 'hermes' in line.lower() and ('PATH=' in line or 'path=' in line.lower()):
- continue
-
- new_lines.append(line)
-
- new_content = '\n'.join(new_lines)
-
- # Clean up multiple blank lines
- while '\n\n\n' in new_content:
- new_content = new_content.replace('\n\n\n', '\n\n')
-
- if new_content != original_content:
- from utils import atomic_write_text
- # The user's own rc, never backed up: a bare write_text() truncates before the new
- # content lands and a crash mid-write would leave an empty ~/.zshrc. Atomic replace
- # also follows a symlinked rc; preserve_mode keeps its bits/owner (sudo-run uninstalls).
- atomic_write_text(config_path, new_content, preserve_mode=True)
- removed_from.append(config_path)
- except Exception as e:
- log_warn(f"Could not update {config_path}: {e}")
- return removed_from
- def remove_wrapper_script():
- """Remove the hermes wrapper script if it exists."""
- wrapper_paths = [
- Path.home() / ".local" / "bin" / "hermes",
- Path.home() / ".local" / "bin" / "hermes-acp",
- Path.home() / ".local" / "bin" / "hermes-agent",
- Path("/usr/local/bin/hermes"),
- Path("/usr/local/bin/hermes-acp"),
- Path("/usr/local/bin/hermes-agent"),
- ]
-
- removed = []
- for wrapper in wrapper_paths:
- if wrapper.exists():
- try:
- # Check if it's our wrapper (contains hermes_cli reference)
- content = wrapper.read_text(encoding="utf-8-sig")
- if 'hermes_cli' in content or 'hermes-agent' in content:
- wrapper.unlink()
- removed.append(wrapper)
- except Exception as e:
- log_warn(f"Could not remove {wrapper}: {e}")
-
- return removed
- def _node_symlink_candidate_dirs() -> list[Path]:
- """Directories where the installer may have placed node/npm/npx symlinks."""
- dirs: list[Path] = [Path.home() / ".local" / "bin"]
- if sys.platform == "linux": # root FHS installs put links in /usr/local/bin
- dirs.append(Path("/usr/local/bin"))
- return dirs
- def remove_node_symlinks(hermes_home: Path) -> list:
- """Remove the node/npm/npx symlinks the installer placed on PATH.
- Historical POSIX installs (``scripts/install.sh`` before pm owned the
- Node runtime) symlinked node/npm/npx into the same directory as the
- ``hermes`` command:
- - ``/usr/local/bin/`` on root FHS installs (Linux, uid 0)
- - ``~/.local/bin/`` otherwise (the common non-root case)
- We check all candidate directories so that uninstall works regardless of
- how the install was done (e.g. a root FHS install that placed links in
- ``/usr/local/bin``, or an older install that used ``~/.local/bin`` before
- the FHS fix). Only symlinks that resolve into this Hermes home's ``node``
- directory are removed — links the user has repointed elsewhere (nvm, fnm,
- etc.) are left untouched.
- """
- node_dir = (hermes_home / "node").resolve()
- def _unlink_ours(link: Path) -> bool:
- # Only act on symlinks — never delete a real binary the user put here.
- if not link.is_symlink():
- return False
- # resolve() normalizes native Windows extended-path prefixes too.
- target = link.resolve()
- if target != node_dir and node_dir not in target.parents:
- return False
- link.unlink()
- return True
- candidates = (bin_dir / name for name in ("node", "npm", "npx") for bin_dir in _node_symlink_candidate_dirs())
- return _remove_each(candidates, _unlink_ours)
- def uninstall_gateway_service():
- """Stop and uninstall the gateway service (systemd, launchd, Windows
- Scheduled Task / Startup folder) and kill any standalone gateway processes.
- Delegates to the gateway module which handles:
- - Linux: user + system systemd services (with proper DBUS env setup)
- - macOS: launchd plists
- - Windows: Scheduled Task + Startup-folder fallback, via ``gateway_windows``
- - All platforms: standalone ``hermes gateway run`` processes
- """
- import platform
- stopped_something = False
- # 1. Kill any standalone gateway processes (all platforms)
- try:
- from hermes_cli.gateway import kill_gateway_processes, find_gateway_pids
- killed = kill_gateway_processes() if find_gateway_pids() else 0
- if killed:
- log_success(f"Killed {killed} running gateway process(es)")
- stopped_something = True
- except Exception as e:
- log_warn(f"Could not check for gateway processes: {e}")
- # Termux/Android has no systemd and no launchd — nothing left to do.
- if os.getenv("TERMUX_VERSION") or "com.termux/files/usr" in os.getenv("PREFIX", ""):
- return stopped_something
- # 2. Per-platform service removal (systemd / launchd / Scheduled Task).
- remover, warn_label = _GATEWAY_SERVICE_REMOVERS.get(platform.system(), (None, ""))
- if remover is not None:
- try:
- stopped_something = remover() or stopped_something
- except Exception as e:
- log_warn(f"{warn_label}: {e}")
- return stopped_something
- def _remove_systemd_gateway() -> bool:
- """Linux: uninstall systemd services (both user and system scopes)."""
- from hermes_cli.gateway import (
- _systemctl_cmd, _systemd_unit_belongs_to_current_home, get_service_name, get_systemd_unit_path,
- )
- svc_name = get_service_name()
- removed_any = False
- for is_system, scope in ((False, "user"), (True, "system")):
- unit_path = get_systemd_unit_path(system=is_system)
- if not unit_path.exists() or not _systemd_unit_belongs_to_current_home(is_system):
- continue
- try:
- if is_system and os.geteuid() != 0: # windows-footgun: ok — Linux-only systemd path
- log_warn(f"System gateway service exists at {unit_path} but needs sudo to remove")
- continue
- cmd = _systemctl_cmd(is_system)
- for verb in ("stop", "disable"):
- subprocess.run(cmd + [verb, svc_name], capture_output=True, check=False)
- unit_path.unlink()
- subprocess.run(cmd + ["daemon-reload"], capture_output=True, check=False)
- log_success(f"Removed {scope} gateway service ({unit_path})")
- removed_any = True
- except Exception as e:
- log_warn(f"Could not remove {scope} gateway service: {e}")
- return removed_any
- # Both gateway LaunchAgent naming schemes: the current ``ai.hermes.gateway*``
- # label and the ``io.nousresearch.hermes-agent.gateway*`` label older builds
- # installed. An uninstall must sweep BOTH — a stale agent keeps respawning the
- # gateway after the code tree is gone (#62209).
- _LAUNCHD_GATEWAY_PLIST_PATTERNS = (
- "ai.hermes.gateway*.plist",
- "io.nousresearch.hermes-agent.gateway*.plist",
- )
- def _launchd_gateway_plists() -> list[Path]:
- """Every gateway LaunchAgent plist on disk, under the real account home."""
- from hermes_cli.gateway import get_launchd_plist_path
- launch_agents = get_launchd_plist_path().parent
- return sorted({p for pattern in _LAUNCHD_GATEWAY_PLIST_PATTERNS for p in launch_agents.glob(pattern)})
- def _remove_launchd_gateway() -> bool:
- """macOS: boot out and uninstall every gateway LaunchAgent plist.
- Sweeps BOTH label patterns (see ``_LAUNCHD_GATEWAY_PLIST_PATTERNS``):
- uninstalling only the current label's plist left older-label agents
- registered, and launchd kept respawning the gateway after removal.
- ``bootout`` (both Aqua and per-user domains, whichever holds the job) plus
- the legacy ``unload`` run before the unlink so launchd never respawns a
- job whose plist is gone.
- """
- plists = _launchd_gateway_plists()
- uid = os.getuid() # windows-footgun: ok — darwin-only (called from the macOS branch)
- for plist_path in plists:
- label = plist_path.stem
- for domain in (f"gui/{uid}", f"user/{uid}"):
- subprocess.run(["launchctl", "bootout", f"{domain}/{label}"], capture_output=True, check=False)
- subprocess.run(["launchctl", "unload", str(plist_path)], capture_output=True, check=False)
- plist_path.unlink()
- log_success(f"Removed macOS gateway service ({plist_path})")
- return bool(plists)
- def _remove_windows_gateway() -> bool:
- """Windows: uninstall Scheduled Task + Startup-folder entry via ``gateway_windows`` (it owns
- schtasks /Delete, the .cmd unlink and stopping the detached pythonw gateway)."""
- from hermes_cli import gateway_windows as gw
- if not any(probe() for probe in (gw.is_installed, gw.is_task_registered, gw.is_startup_entry_installed)):
- return False
- try:
- gw.stop()
- except Exception as e:
- log_warn(f"Could not stop Windows gateway cleanly: {e}")
- try:
- gw.uninstall()
- log_success("Removed Windows gateway (Scheduled Task + Startup entry)")
- return True
- except Exception as e:
- log_warn(f"Could not fully uninstall Windows gateway: {e}")
- return False
- # platform.system() -> (remover, warning label when the remover itself blows up)
- _GATEWAY_SERVICE_REMOVERS = {
- "Linux": (_remove_systemd_gateway, "Could not check systemd gateway services"),
- "Darwin": (_remove_launchd_gateway, "Could not remove launchd gateway service"),
- "Windows": (_remove_windows_gateway, "Could not check Windows gateway service")}
- # Windows helpers. install.ps1 leaves four things no rc file covers: User-scope env vars
- # HERMES_HOME / HERMES_GIT_BASH_PATH (HKCU\Environment), User-scope PATH entries
- # (%LOCALAPPDATA%\hermes\git\{cmd,bin,usr\bin}, ...\hermes\node), PortableGit + Node copies
- # (~200MB) and the gateway-service dir. Direct winreg writes (not PowerShell): no subprocess, and
- # they work under Constrained Language Mode; new shells see them without WM_SETTINGCHANGE.
- def _hermes_path_markers(hermes_home: Path, *, include_managed_bin: bool = False) -> list[str]:
- r"""Prefixes identifying Hermes-owned User-PATH entries (prefix match sweeps git\cmd, git\bin,
- node...). ``include_managed_bin`` adds ``<root>\bin`` (launchers + managed uv) — only when that
- dir is about to be deleted, so a keep-data uninstall keeps the working uv resolvable."""
- root = str(hermes_home).rstrip("\\/")
- subs = ("hermes-agent", "git", "node", "venv") + (("bin",) if include_managed_bin else ())
- return [f"{root}\\{sub}" for sub in subs]
- def remove_path_from_windows_registry(hermes_home: Path, *, include_managed_bin: bool = False) -> list[str]:
- """Strip Hermes-owned entries from User-scope PATH in the registry (see ``_hermes_path_markers``)."""
- markers = tuple(m.lower() for m in _hermes_path_markers(hermes_home, include_managed_bin=include_managed_bin))
- def edit(winreg, key, removed):
- try:
- path_value, path_type = winreg.QueryValueEx(key, "Path")
- except FileNotFoundError:
- return
- # Preserve REG_EXPAND_SZ vs REG_SZ so unexpanded %VARS% survive.
- kept: list[str] = []
- for entry in (e for e in path_value.split(";") if e):
- is_ours = entry.rstrip("\\/").lower().startswith(markers)
- (removed if is_ours else kept).append(entry)
- if removed:
- winreg.SetValueEx(key, "Path", 0, path_type, ";".join(kept))
- return _edit_user_environment(edit, warn_label="Could not edit User PATH in registry")
- def remove_hermes_env_vars_windows() -> list[str]:
- """Delete HERMES_HOME and HERMES_GIT_BASH_PATH from User-scope env vars."""
- def edit(winreg, key, removed):
- for name in ("HERMES_HOME", "HERMES_GIT_BASH_PATH"):
- try:
- winreg.QueryValueEx(key, name)
- except FileNotFoundError:
- continue
- try:
- winreg.DeleteValue(key, name)
- removed.append(name)
- except OSError as e:
- log_warn(f"Could not delete {name} from User env: {e}")
- return _edit_user_environment(edit, warn_label="Could not open User Environment key")
- def _edit_user_environment(edit, *, warn_label: str) -> list[str]:
- """Open HKCU\\Environment read/write and run ``edit(winreg, key, removed)``. Returns what
- ``edit`` appended to ``removed`` even if a later registry call raised (callers report exactly
- what was touched); ``[]`` off-Windows (no ``winreg``)."""
- removed: list[str] = []
- try:
- import winreg
- except ImportError:
- return removed # not on Windows, nothing to do
- try:
- with winreg.OpenKey(winreg.HKEY_CURRENT_USER, "Environment", 0,
- winreg.KEY_READ | winreg.KEY_WRITE) as key:
- edit(winreg, key, removed)
- except OSError as e:
- log_warn(f"{warn_label}: {e}")
- return removed
- def remove_portable_tooling_windows(hermes_home: Path) -> list[Path]:
- """Delete the PortableGit / Node / gateway-service dirs the Windows installer created under
- ``hermes_home`` (isolated from any system Git / Node, so nothing else breaks)."""
- targets = (hermes_home / sub for sub in ("git", "node", "gateway-service"))
- return _remove_each((t for t in targets if t.exists()), lambda t: shutil.rmtree(t) or True)
- def _xdg_leftover_paths(full_uninstall: bool) -> tuple[list[Path], list[Path]]:
- """The XDG cache/data dirs an install scatters outside HERMES_HOME.
- Returns (removable, data_preserved): the cache dir is always removable;
- the XDG data dir is user data, so it is only removed on a full uninstall
- and otherwise reported as intentionally preserved.
- """
- home = Path.home()
- cache = home / ".cache" / "hermes"
- data = home / ".local" / "share" / "hermes"
- removable = [cache] if cache.exists() else []
- if data.exists() and full_uninstall:
- removable.append(data)
- preserved = [data] if data.exists() and not full_uninstall else []
- return removable, preserved
- def remove_desktop_app_leftovers(*, full_uninstall: bool) -> list[Path]:
- """Remove per-user app leftovers that live outside HERMES_HOME and the
- checkout, which earlier uninstallers left behind (#62209): the macOS
- Library caches/logs/browser-store/state entries the packaged app and
- Electron scatter, and the XDG cache dir on every platform. On a full
- uninstall the XDG data dir (``~/.local/share/hermes``) goes too.
- Only well-known Hermes-named entries are touched — never a glob of the
- whole Library.
- """
- import sys as _sys
- targets: list[Path] = []
- home = Path.home()
- if _sys.platform == "darwin":
- library = home / "Library"
- for parent in ("Caches", "Logs", "WebKit", "HTTPStorages", "Saved Application State"):
- parent_dir = library / parent
- if not parent_dir.is_dir():
- continue
- try:
- entries = list(parent_dir.iterdir())
- except OSError:
- continue
- targets.extend(e for e in entries if "hermes" in e.name.lower())
- removable, _ = _xdg_leftover_paths(full_uninstall=full_uninstall)
- targets.extend(removable)
- return _remove_each((t for t in targets if t.exists()), _remove_path_or_tree)
- def _remove_path_or_tree(path: Path) -> bool:
- try:
- if path.is_symlink() or path.is_file():
- path.unlink()
- else:
- shutil.rmtree(path)
- return True
- except OSError:
- return False
- def remove_legacy_runtime_trees(hermes_home: Path) -> list[Path]:
- """Delete managed-runtime trees a PRE-SPLIT install left in HERMES_HOME.
- Runtime artifacts are install-scoped now, so the current locations go
- away with ``rmtree(project_root)``. But a checkout OUTSIDE the home
- (the common case: ``~/src/hermes-agent``) used to put its node/uv
- under ``$HERMES_HOME`` — that tree survives removing the checkout and
- survives "keep my data" uninstalls, because it is not data.
- Only the exact managed layout is removed: ``node/`` (a tree the
- installer owned wholesale) and ``bin/uv`` (the single binary, NOT the
- whole ``bin/`` dir — a user's own scripts can live there). Profile
- state is never touched.
- """
- removed: list[Path] = []
- node_tree = hermes_home / "node"
- if node_tree.is_dir():
- try:
- shutil.rmtree(node_tree, ignore_errors=False)
- removed.append(node_tree)
- except Exception as e:
- log_warn(f"Could not remove {node_tree}: {e}")
- for uv_name in ("uv", "uv.exe"):
- uv_binary = hermes_home / "bin" / uv_name
- if uv_binary.is_file():
- try:
- uv_binary.unlink()
- removed.append(uv_binary)
- except Exception as e:
- log_warn(f"Could not remove {uv_binary}: {e}")
- return removed
- def remove_windows_bin_launchers(*, windows: bool | None = None) -> list[Path]:
- """Delete the managed binary dir (the default Hermes root's ``bin``).
- The dir holds only hermes-owned launcher copies (the relocatable venv's
- console scripts, staged onto PATH by first-run repair) — pm keeps uv in
- its own store entry, so nothing shared lives here and the whole dir goes.
- Every uninstall mode deletes the code checkout, so a surviving launcher
- would dangle: ``hermes`` in a new terminal resolves and then errors on
- its missing venv target, which reads worse than command-not-found.
- A launcher that IS this process's own trampoline is mandatory-locked
- against deletion but not rename, so removal falls back to renaming it
- aside with a non-executable suffix.
- *windows* is an injectable platform verdict for tests (same pattern as
- ``_install_repair.ensure_windows_bin_launchers``).
- """
- if windows is None:
- windows = _is_windows()
- if not windows:
- return []
- try:
- from hermes_constants import get_default_hermes_root
- bin_dir = get_default_hermes_root() / "bin"
- except Exception as e:
- log_warn(f"Could not locate the managed binary dir: {e}")
- return []
- if not bin_dir.is_dir():
- return []
- removed: list[Path] = []
- for launcher in sorted(bin_dir.iterdir()):
- if not launcher.is_file():
- continue
- try:
- launcher.unlink()
- removed.append(launcher)
- except OSError:
- aside = launcher.with_name(f"{launcher.name}.uninstalled.{os.getpid()}")
- try:
- os.rename(launcher, aside)
- removed.append(launcher)
- except OSError as e:
- log_warn(f"Could not remove {launcher}: {e}")
- try:
- bin_dir.rmdir()
- except OSError:
- pass # leftovers (renamed-aside trampolines) keep the dir until next run
- return removed
- def _is_windows() -> bool:
- return sys.platform == "win32"
- def _is_default_hermes_home(hermes_home: Path) -> bool:
- """Return True when ``hermes_home`` points at the default (non-profile) root."""
- try:
- from hermes_constants import get_default_hermes_root
- return hermes_home.resolve() == get_default_hermes_root().resolve()
- except Exception:
- return False
- def _discover_named_profiles():
- """``ProfileInfo`` for every non-default profile; ``[]`` when profile support is unavailable."""
- try:
- from hermes_cli.profiles import list_profiles
- except Exception:
- return []
- try:
- return [p for p in list_profiles() if not getattr(p, "is_default", False)]
- except Exception as e:
- log_warn(f"Could not enumerate profiles: {e}")
- return []
- def _uninstall_profile(profile) -> None:
- """Fully uninstall a named profile: stop its gateway, remove its alias, wipe its home. Shells
- out to ``hermes -p <name> gateway stop|uninstall`` because service names / unit paths derive
- from the current HERMES_HOME and can't be switched in-process."""
- name = profile.name
- log_info(f"Uninstalling profile '{name}'...")
- # 1. Gateway service, via `python -m hermes_cli.main` (the `hermes` wrapper may be half-gone).
- hermes_invocation = [sys.executable, "-P", "-m", "hermes_cli.main", "--profile", name]
- for subcmd in ("stop", "uninstall"):
- try:
- subprocess.run(
- hermes_invocation + ["gateway", subcmd], capture_output=True, text=True,
- encoding='utf-8', errors='replace', timeout=60, check=False)
- except subprocess.TimeoutExpired:
- log_warn(f" Gateway {subcmd} timed out for '{name}'")
- except Exception as e:
- log_warn(f" Could not run gateway {subcmd} for '{name}': {e}")
- # 2. Remove the wrapper alias script at ~/.local/bin/<name> (if any).
- alias_path = getattr(profile, "alias_path", None)
- if alias_path and alias_path.exists():
- try:
- alias_path.unlink()
- log_success(f" Removed alias {alias_path}")
- except Exception as e:
- log_warn(f" Could not remove alias {alias_path}: {e}")
- # 3. Wipe the profile's HERMES_HOME directory.
- _rmtree_step(profile.path, indent=" ", fully=False)
- def run_data_uninstall(args):
- """Erase this home's data, preserving installed runtimes and sibling profiles."""
- from hermes_cli.data_cleanup import plan_data_removal, remove_data
- from hermes_cli.gui_uninstall import desktop_userdata_dir
- home = get_hermes_home()
- try:
- userdata = getattr(args, "desktop_userdata", None)
- plan = plan_data_removal(home, get_project_root(), Path(userdata) if userdata else desktop_userdata_dir())
- except (OSError, ValueError, RuntimeError) as exc:
- log_warn(str(exc))
- raise SystemExit(1) from exc
- if not plan.remove:
- print(f"No Hermes user data found in {home}.")
- return
- print("Data-only removal: installed code and other profiles stay intact.")
- print("Will remove:")
- for path in plan.remove:
- print(f" {path}")
- if plan.keep:
- print("Kept intact:")
- for path in plan.keep:
- print(f" {path}")
- if bool(getattr(args, "dry_run", False)):
- print("Dry run: no data or processes changed.")
- return
- if not bool(getattr(args, "yes", False)) and not _confirm_yes("to remove this home's data"):
- return
- from hermes_cli.data_cleanup_holders import quiescent_home
- try:
- with quiescent_home(plan.home):
- removed, failed = remove_data(plan)
- except (OSError, ValueError, RuntimeError) as exc:
- log_warn(f"No data removed: {exc}")
- raise SystemExit(1) from exc
- for path in removed:
- log_success(f"Removed {path}")
- if failed:
- print("Hermes data was only partially removed. Surviving targets:")
- for path, reason in failed:
- log_warn(f"{path}: {reason}")
- raise SystemExit(1)
- log_success("Hermes data removed.")
- def run_gui_uninstall(args):
- """GUI-only uninstall: remove the Chat GUI, leave the agent + data intact.
- Mirrors ``hermes uninstall --gui``. Removes the desktop app's built
- artifacts, the packaged app bundle (best-effort), and the Electron
- userData dir — nothing under ``$HERMES_HOME`` config/sessions/.env, and
- never the Python agent or its venv.
- """
- from hermes_cli.gui_uninstall import (
- agent_is_installed,
- desktop_install_record,
- gui_install_summary,
- uninstall_gui,
- )
- _refuse_if_steward_owned()
- hermes_home = get_hermes_home()
- summary = gui_install_summary(hermes_home)
- skip_confirm = bool(getattr(args, "yes", False))
- print()
- _print_box("│ ☤ Hermes Chat GUI Uninstaller │", Colors.MAGENTA)
- print()
- if not summary["gui_installed"]:
- print("No Hermes Chat GUI installation was found.")
- print(f" Checked: {hermes_home}, and the standard app locations for this OS.")
- return
- print(color("This removes the Chat GUI only. The Hermes agent stays installed.", Colors.CYAN))
- print()
- print(color("Will remove:", Colors.YELLOW, Colors.BOLD))
- for p in (*summary["source_built_artifacts"], *summary["packaged_app_paths"]):
- print(f" • {p}")
- if (install_record := desktop_install_record()).exists():
- print(f" • {install_record} (desktop install record)")
- if summary["userdata_exists"]:
- print(f" • {summary['userdata_dir']} (desktop app data)")
- print()
- if agent_is_installed(hermes_home):
- print(color("Kept intact:", Colors.GREEN, Colors.BOLD))
- print(f" • The Hermes agent at {hermes_home / 'hermes-agent'}")
- print(f" • Your config, sessions, and secrets under {hermes_home}")
- if (shared_modules := hermes_home / "hermes-agent" / "node_modules").exists():
- print(f" • Shared workspace dependencies at {shared_modules}")
- print()
- if bool(getattr(args, "dry_run", False)):
- print("Dry run: no files or processes changed.")
- return
- if not skip_confirm and not _confirm_yes("to remove the Chat GUI"):
- return
- print()
- print(color("Uninstalling Chat GUI...", Colors.CYAN, Colors.BOLD))
- print()
- uninstall_gui(hermes_home)
- print()
- _print_box("│ ✓ Chat GUI Uninstalled! │", Colors.GREEN)
- print()
- print("The Hermes agent is still installed. Run 'hermes' to use the CLI,")
- print("or 'hermes uninstall' to remove the agent too.")
- print()
- def run_uninstall(args):
- """
- Run the uninstall process.
-
- Options:
- - Full uninstall: removes code + ~/.hermes/ (configs, data, logs)
- - Keep data: removes code but keeps ~/.hermes/ for future reinstall
- """
- _refuse_if_steward_owned()
- project_root = get_project_root()
- hermes_home = get_hermes_home()
- full_flag = bool(getattr(args, "full", False))
- if bool(getattr(args, "dry_run", False)):
- _print_uninstall_dry_run(
- project_root=project_root, hermes_home=hermes_home, full_uninstall=full_flag)
- return
- # Named profiles (only when uninstalling from the default root) are offered for cleanup too,
- # instead of leaving zombie HERMES_HOMEs and systemd units behind.
- is_default_profile = _is_default_hermes_home(hermes_home)
- named_profiles = _discover_named_profiles() if is_default_profile else []
- # ``--yes`` (the desktop app's detached cleanup script): no prompts; ``--full`` = full wipe.
- # Named profiles are NOT auto-removed here — too destructive a default for an unattended run.
- if bool(getattr(args, "yes", False)):
- _perform_uninstall(
- project_root=project_root, hermes_home=hermes_home, full_uninstall=full_flag,
- remove_profiles=False, named_profiles=named_profiles)
- return
- print()
- _print_box("│ ☤ Hermes Agent Uninstaller │", Colors.MAGENTA)
- print()
- # Show what will be affected
- print(color("Current Installation:", Colors.CYAN, Colors.BOLD))
- print(f" Code: {project_root}")
- print(f" Config: {hermes_home / 'config.yaml'}")
- print(f" Secrets: {hermes_home / '.env'}")
- print(f" Data: {hermes_home / 'cron/'}, {hermes_home / 'sessions/'}, {hermes_home / 'logs/'}")
- from hermes_cli.gui_uninstall import desktop_userdata_dir
- if (desktop_userdata := desktop_userdata_dir()).exists():
- print(f" Desktop: {desktop_userdata} (app data - kept by 'Keep data', removed by 'Full uninstall')")
- print()
- if named_profiles:
- print(color("Other profiles detected:", Colors.CYAN, Colors.BOLD))
- for p in named_profiles:
- print(f" • {p.name}{' (gateway running)' if getattr(p, 'gateway_running', False) else ''}: {p.path}")
- print()
- # Ask for confirmation
- print(color("Uninstall Options:", Colors.YELLOW, Colors.BOLD))
- print()
- print(" 1) " + color("Keep data", Colors.GREEN) + " - Remove code only, keep configs/sessions/logs")
- print(" (Recommended - you can reinstall later with your settings intact)")
- print()
- print(" 2) " + color("Full uninstall", Colors.RED) + " - Remove everything including all data")
- print(" (Warning: This deletes all configs, sessions, and logs permanently)")
- print()
- print(" 3) " + color("Cancel", Colors.CYAN) + " - Don't uninstall")
- print()
- choice = _prompt(color("Select option [1/2/3]: ", Colors.BOLD))
- if choice is None:
- return
- if choice in {"3", "c", "cancel", "q", "quit", "n", "no"}:
- _cancelled()
- return
- full_uninstall = (choice == "2")
- # Full uninstall from the default profile: offer to remove named profiles too (gateway
- # services, alias wrappers, HERMES_HOME dirs) — otherwise they leave zombie services behind.
- remove_profiles = False
- n_profiles = len(named_profiles)
- profile_names = ", ".join(p.name for p in named_profiles)
- if full_uninstall and named_profiles:
- print()
- print(color("Other profiles will NOT be removed by default.", Colors.YELLOW))
- print(f"Found {n_profiles} named profile(s): {profile_names}")
- print()
- resp = _prompt(color(f"Also stop and remove these {n_profiles} profile(s)? [y/N]: ", Colors.BOLD))
- if resp is None:
- return
- remove_profiles = resp in {"y", "yes"}
- # Final confirmation
- print()
- if full_uninstall:
- print(color("⚠️ WARNING: This will permanently delete ALL Hermes data!", Colors.RED, Colors.BOLD))
- print(color(" Including: configs, API keys, sessions, scheduled jobs, logs", Colors.RED))
- if remove_profiles:
- print(color(f" Plus {n_profiles} profile(s): {profile_names}", Colors.RED))
- else:
- print("This will remove the Hermes code but keep your configuration and data.")
- print()
- if not _confirm_yes("to confirm"):
- return
- _perform_uninstall(
- project_root=project_root, hermes_home=hermes_home, full_uninstall=full_uninstall,
- remove_profiles=remove_profiles, named_profiles=named_profiles)
- def _print_uninstall_dry_run(*, project_root: Path, hermes_home: Path, full_uninstall: bool) -> None:
- """Print the uninstall plan without stopping services or deleting files."""
- print()
- print(color("Dry run: no files, services, or environment entries will be changed.", Colors.CYAN, Colors.BOLD))
- print()
- print(color("Would inspect/remove:", Colors.YELLOW, Colors.BOLD))
- print(" • Gateway services and standalone gateway processes")
- print(" • Hermes PATH entries from shell configs / Windows User PATH")
- print(" • Hermes wrapper scripts and Hermes-managed node/npm/npx symlinks")
- print(" • Desktop Chat GUI artifacts")
- print(f" • Code checkout: {project_root}")
- from hermes_cli.gui_uninstall import desktop_userdata_dir
- userdata = desktop_userdata_dir()
- if not full_uninstall:
- print(f" • Keep Hermes config/data: {hermes_home}")
- if userdata.exists():
- print(f" • Keep desktop app data: {userdata}")
- else:
- print(f" • Hermes config/data: {hermes_home}")
- if sys.platform == "darwin":
- print(" • macOS: dashboard/serve launchd jobs, Electron + setup caches")
- if userdata.exists():
- print(f" • Desktop app data: {userdata}")
- profiles = _discover_named_profiles() if _is_default_hermes_home(hermes_home) else []
- if profiles:
- print(" • Named profiles (interactive uninstall asks before removing):")
- for prof in profiles:
- print(f" - {prof.name}: {prof.path}")
- print()
- def _remove_step(label: str, remove, success_fmt: str, none_msg: str) -> None:
- """Announce ``label``, run ``remove()``, log one success line per removed item (or ``none_msg``)."""
- log_info(label)
- removed = remove()
- for item in removed:
- log_success(success_fmt.format(item))
- if not removed:
- log_info(none_msg)
- def _rmtree_step(path: Path, *, indent: str = "", fully: bool = True) -> None:
- """Best-effort ``rmtree`` with the shared success/warning lines."""
- try:
- if path.exists():
- shutil.rmtree(path)
- log_success(f"{indent}Removed {path}")
- except Exception as e:
- log_warn(f"{indent}Could not {'fully ' if fully else ''}remove {path}: {e}")
- if fully:
- log_info("You may need to manually remove it")
- def _macos_cache_leftover_dirs() -> list[Path]:
- """Cache dirs Electron/Chromium and the setup binary write OUTSIDE HERMES_HOME on
- macOS. Chromium splits the desktop app's HTTP/script caches under ``~/Library/Caches``
- keyed by both the product name and the app id, and the Tauri setup binary does the
- same under its own pair of identifiers. ``gui_uninstall`` removes the userData dir
- (``Application Support/Hermes``) but never these (#62209)."""
- caches = Path.home() / "Library" / "Caches"
- return [
- caches / "Hermes",
- caches / "com.nousresearch.hermes",
- caches / "hermes-setup",
- caches / "com.nousresearch.hermes.setup",
- ]
- def _rmtree_if_exists(path: Path) -> bool:
- """``_remove_each`` remover: True (after removing) when *path* exists, else False."""
- if not path.exists():
- return False
- shutil.rmtree(path)
- return True
- def remove_dashboard_launchd_jobs() -> list[Path]:
- """macOS: boot out and delete every launchd job whose ``ProgramArguments`` runs a
- ``hermes dashboard`` / ``hermes serve`` backend, returning the removed plist paths.
- The gateway uninstall only reaches the gateway label, so a dashboard/serve
- LaunchAgent survives a full uninstall and launchd keeps respawning its backend.
- Mirrors the enumeration ``hermes_cli.main_dashboard`` uses to find those jobs
- (``_launchd_plist_dirs`` + ``_parse_dashboard_runtime``): read each plist, match the
- arguments, ``launchctl bootout`` the job's domains (launchd takes the process down;
- booting out an already-unloaded job is fine and never checked), then delete the
- plist — a stale, not-loaded plist is still Hermes-created and still goes. A missing,
- unreadable, or malformed plist is skipped, never fatal. macOS only (empty list
- elsewhere)."""
- if sys.platform != "darwin":
- return []
- import plistlib
- import shlex
- from xml.parsers.expat import ExpatError
- from hermes_cli.main_dashboard import _launchd_plist_dirs, _parse_dashboard_runtime
- uid = os.getuid() # windows-footgun: ok — darwin-only branch
- removed: list[Path] = []
- for kind, plist_dir in _launchd_plist_dirs():
- try:
- plists = sorted(plist_dir.glob("*.plist"))
- except OSError:
- continue
- for plist_path in plists:
- try:
- with open(plist_path, "rb") as f:
- data = plistlib.load(f)
- # ExpatError is NOT a ValueError: plistlib propagates it unwrapped for XML
- # that is not well-formed; one malformed operator file must skip — not
- # abort — the sweep (same contract as main_dashboard's scan).
- except (OSError, ValueError, plistlib.InvalidFileException, ExpatError):
- continue
- if not isinstance(data, dict):
- continue
- label = str(data.get("Label") or "").strip()
- args = data.get("ProgramArguments")
- if not label or not isinstance(args, list) or not args:
- continue
- if _parse_dashboard_runtime(shlex.join([str(a) for a in args])) is None:
- continue
- domains = ("system",) if kind == "daemon" else (f"gui/{uid}", f"user/{uid}")
- for domain in domains:
- try:
- subprocess.run(
- ["launchctl", "bootout", f"{domain}/{label}"],
- capture_output=True, check=False, timeout=90)
- except (OSError, subprocess.TimeoutExpired) as e:
- log_warn(f"Could not boot out {domain}/{label}: {e}")
- try:
- plist_path.unlink()
- removed.append(plist_path)
- except OSError as e:
- log_warn(f"Could not remove {plist_path}: {e}")
- return removed
- def _perform_uninstall(
- *,
- project_root: Path,
- hermes_home: Path,
- full_uninstall: bool,
- remove_profiles: bool,
- named_profiles: list) -> None:
- """The uninstall steps shared by the interactive and ``--yes`` paths: stop gateway -> strip PATH
- (rc files + Windows registry) -> wrapper/launchers/node symlinks -> Chat GUI artifacts -> delete
- the checkout -> (Windows) PortableGit/Node -> optionally ``$HERMES_HOME`` and named profiles."""
- print()
- print(color("Uninstalling...", Colors.CYAN, Colors.BOLD))
- print()
- # 1. Stop and uninstall gateway service + kill standalone processes
- log_info("Checking for running gateway...")
- if not uninstall_gateway_service():
- log_info("No gateway service or processes found")
- # 2-3b. PATH entries, wrapper, Windows launchers, node symlinks. Windows: hermes_home is
- # %VAR%-expanded because install.ps1 writes literal C:\Users\<u>\...; hermes\bin (launchers +
- # managed uv) leaves the PATH only when the full wipe below deletes it (keep-data keeps uv
- # resolvable), while the launchers themselves always go. Symlinks go only when they still
- # point into this home's node dir (never clobber nvm / user-managed Node).
- windows = _is_windows()
- sweep_managed_bin = windows and full_uninstall and _is_default_hermes_home(hermes_home)
- for on_this_platform, label, remove, success_fmt, none_msg in (
- (True, "Removing PATH entries from shell configs...",
- remove_path_from_shell_configs, "Updated {}", "No PATH entries found to remove in shell rc files"),
- (windows, "Removing PATH entries from Windows User environment...",
- lambda: remove_path_from_windows_registry(
- Path(os.path.expandvars(str(hermes_home))), include_managed_bin=sweep_managed_bin),
- "Removed from User PATH: {}", "No Hermes-owned PATH entries in User environment"),
- (windows, "Removing HERMES_HOME / HERMES_GIT_BASH_PATH User env vars...",
- remove_hermes_env_vars_windows, "Removed User env var: {}", "No Hermes-set User env vars to remove"),
- (True, "Removing hermes command...", remove_wrapper_script, "Removed {}", "No wrapper script found"),
- (windows, "Removing Windows hermes launchers...",
- remove_windows_bin_launchers, "Removed {}", "No Windows hermes launchers found"),
- (True, "Removing Hermes-managed node/npm/npx symlinks...",
- lambda: remove_node_symlinks(hermes_home), "Removed {}", "No Hermes-managed node/npm/npx symlinks found"),
- ):
- if on_this_platform:
- _remove_step(label, remove, success_fmt, none_msg)
- # 3c. Chat GUI artifacts go with the agent code. uninstall_gui() never touches config/sessions/
- # .env (safe in keep-data mode); the packaged app + Electron userData live OUTSIDE HERMES_HOME.
- # The userData dir is user configuration (connections.json, OAuth partitions, renderer
- # state), so keep-data preserves it — only the full wipe removes it.
- log_info("Removing desktop Chat GUI artifacts...")
- try:
- from hermes_cli.gui_uninstall import uninstall_gui
- if not uninstall_gui(hermes_home, remove_userdata=full_uninstall):
- log_info("No desktop GUI artifacts found")
- except Exception as e:
- log_warn(f"Could not remove desktop GUI artifacts: {e}")
- # 3d. Per-user app leftovers outside HERMES_HOME: macOS Library caches/logs/
- # browser-store/state entries, the XDG cache dir, and (full mode) the XDG
- # data dir. Only Hermes-named entries are touched (#62209).
- log_info("Removing app caches and leftovers outside the install...")
- removed_leftovers = remove_desktop_app_leftovers(full_uninstall=full_uninstall)
- if removed_leftovers:
- for path in removed_leftovers:
- log_success(f"Removed {path}")
- else:
- log_info("No app caches or leftovers found")
- # 4. Remove installation directory (code) — we may be running from inside it.
- log_info("Removing installation directory...")
- _rmtree_step(project_root)
- # 4b. Windows installer tooling (PortableGit, Node, gateway-service) is not user data:
- # safe to remove in keep-data mode too.
- if windows:
- _remove_step(
- "Removing Windows installer artifacts (PortableGit, Node, gateway-service)...",
- lambda: remove_portable_tooling_windows(hermes_home), "Removed {}",
- "No Windows installer artifacts to remove")
- # 4c. Remove managed-runtime trees a PRE-SPLIT install left in
- # HERMES_HOME. Current installs keep these inside the checkout, so
- # step 4 already removed them — but a checkout outside the home
- # (~/src/hermes-agent) used to leave its node/uv behind, surviving
- # both the checkout removal and a "keep my data" uninstall. They
- # are install tooling, not data, so removing them is correct in
- # either mode.
- log_info("Removing managed runtime trees...")
- removed_runtimes = remove_legacy_runtime_trees(hermes_home)
- if removed_runtimes:
- for path in removed_runtimes:
- log_success(f"Removed {path}")
- else:
- log_info("No legacy runtime trees to remove")
- # 5. Optionally remove ~/.hermes/ data directory (and named profiles)
- if full_uninstall:
- # 5a. Named profiles' homes live under <default>/profiles/ (swept by the rmtree below),
- # but their services + alias scripts live OUTSIDE the default root.
- for prof in named_profiles if remove_profiles else ():
- _uninstall_profile(prof)
- # 5b. macOS: dashboard/serve launchd jobs the gateway uninstall never reaches (it
- # only removes the gateway label) — boot them out and delete their plists,
- # mirroring the enumeration main_dashboard uses to find them (#62209).
- if sys.platform == "darwin":
- _remove_step(
- "Removing dashboard/serve launchd jobs...",
- remove_dashboard_launchd_jobs, "Removed {}",
- "No dashboard/serve launchd jobs found")
- # 5c. macOS: Electron/Chromium and setup cache dirs written OUTSIDE HERMES_HOME
- # survive both the checkout removal and the home rmtree below (#62209).
- if sys.platform == "darwin":
- _remove_step(
- "Removing Electron and setup caches...",
- lambda: _remove_each(_macos_cache_leftover_dirs(), _rmtree_if_exists), "Removed {}",
- "No Electron or setup caches found")
- log_info("Removing configuration and data...")
- _rmtree_step(hermes_home)
- else:
- log_info(f"Keeping configuration and data in {hermes_home}")
- print()
- _print_box("│ ✓ Uninstall Complete! │", Colors.GREEN)
- print()
- if not full_uninstall:
- print(color("Your configuration and data have been preserved:", Colors.CYAN))
- print(f" {hermes_home}/")
- from hermes_cli.gui_uninstall import desktop_userdata_dir
- if (desktop_userdata := desktop_userdata_dir()).exists():
- print(f" {desktop_userdata} (desktop app data)")
- _, preserved = _xdg_leftover_paths(full_uninstall=False)
- for path in preserved:
- print(f" {path}/")
- print()
- print("To reinstall later with your existing settings:")
- print(color(_REINSTALL_HINT[windows], Colors.DIM))
- print()
- for line, col in _RELOAD_HINT[windows]:
- print(color(line, col) if col else line)
- print()
- print("Thank you for using Hermes Agent! ☤")
- print()
- _REINSTALL_HINT = {
- True: " iex (irm https://hermes-agent.nousresearch.com/install.ps1)",
- False: " curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash"}
- # windows -> [(line, color or None)]
- _RELOAD_HINT = {
- True: [("Open a new terminal (PowerShell / Windows Terminal) to pick up", Colors.YELLOW),
- ("the updated User PATH and environment variables.", Colors.YELLOW)],
- False: [("Reload your shell to complete the process:", Colors.YELLOW),
- (" source ~/.bashrc # or ~/.zshrc", None)]}
- class _UninstallArgs:
- """Lightweight args namespace for the module entrypoint below."""
- def __init__(self, *, mode: str, desktop_userdata: Path | None = None):
- self.gui = mode == "gui"
- self.gui_summary = False
- self.full = mode == "full"
- self.data = mode == "data"
- self.yes = True # the module entrypoint is always non-interactive
- self.desktop_userdata = desktop_userdata
- def main(argv=None) -> int:
- """Module entrypoint: ``python -m hermes_cli.uninstall --mode <gui|lite|full|data>``.
- Exists so the desktop app can run the uninstall under a Python interpreter
- OUTSIDE the venv being deleted. On Windows, ``lite``/``full`` rmtree the
- venv that contains the running ``python.exe`` — and a running .exe is
- mandatory-locked, so doing that from the venv's own interpreter half-fails.
- The desktop launches this with the system Python + ``PYTHONPATH=<agentRoot>``
- so ``import hermes_cli`` resolves from source while the venv is torn down.
- ``data`` removes user data only (no code) and is the one mode allowed on
- steward-owned installs (Nix, the bundled desktop app, Docker); the
- code-removing modes hard-fail there with the steward's instructions.
- Data-only mode keeps the runtime installed and uses its dependencies to
- coordinate live writers. Code-removing modes can still run outside the
- environment being removed.
- """
- import argparse
- parser = argparse.ArgumentParser(prog="python -m hermes_cli.uninstall")
- parser.add_argument(
- "--mode",
- choices=["gui", "lite", "full", "data"],
- required=True,
- help="gui = Chat GUI only; lite = GUI + agent, keep data; "
- "full = everything; data = user data only, keep code",
- )
- parser.add_argument("--desktop-userdata", type=Path, help=argparse.SUPPRESS)
- ns = parser.parse_args(argv)
- if ns.desktop_userdata is not None and ns.mode != "data":
- parser.error("--desktop-userdata requires --mode data")
- args = _UninstallArgs(mode=ns.mode, desktop_userdata=ns.desktop_userdata)
- if args.data:
- run_data_uninstall(args)
- elif args.gui:
- run_gui_uninstall(args)
- else:
- run_uninstall(args)
- return 0
- if __name__ == "__main__":
- sys.exit(main())
|