The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
"""Directories where tools install outside PATH, grouped by the ecosystem that owns them.
Every table in Hermes lives here. A directory literal outside this module fails the ratchet in
`tests/test_managed_runtime_resolution.py`. Each table is empty on an OS where the ecosystem
does not install there, so callers compose tables without OS branches.
"""
from __future__ import annotations
import sys
_POSIX = sys.platform != "win32"
_WIN = sys.platform == "win32"
def homebrew_dirs() -> tuple[str, ...]:
return ("/opt/homebrew/bin", "/usr/local/bin") if sys.platform == "darwin" else ()
def user_local_bin() -> tuple[str, ...]:
return ("~/.local/bin",) if _POSIX else ("%USERPROFILE%/.local/bin",)
def rust_tool_dirs() -> tuple[str, ...]:
return ("~/.cargo/bin",) if _POSIX else ("%USERPROFILE%/.cargo/bin",)
def node_tool_dirs() -> tuple[str, ...]:
return ("~/.npm-global/bin", "~/.bun/bin", "~/.volta/bin") if _POSIX else ("%APPDATA%/npm", "%USERPROFILE%/.bun/bin", "%LOCALAPPDATA%/Volta/bin")
def hermes_vendored_dirs() -> tuple[str, ...]:
return ("~/.hermes/bin",) if _POSIX else ("%USERPROFILE%/.hermes/bin",)
def machine_marker_files() -> tuple[str, ...]:
"""Where Hermes records that this OS user has used it. No Hermes data-dir setting moves these.
The first entry is the one written; the rest are read too (Windows: MSIX builds that ran with
filesystem virtualisation wrote under the package's LocalCache)."""
if _WIN:
return ("%LOCALAPPDATA%/Nous Research/.machine",
"%LOCALAPPDATA%/Packages/NousResearch*_*/LocalCache/Local/Nous Research/.machine")
if sys.platform == "darwin":
return ("~/Library/Application Support/Nous Research/.machine",)
return ("$XDG_STATE_HOME/nous-research/.machine", "~/.local/state/nous-research/.machine")
def hermes_home_globs() -> tuple[str, ...]:
"""Every place a Hermes data root can sit by default: suffixed channel roots, the legacy Windows
root, and the per-package roots of MSIX builds that ran with filesystem virtualisation."""
if _WIN:
return ("%LOCALAPPDATA%/hermes*", "%USERPROFILE%/.hermes",
"%LOCALAPPDATA%/Packages/NousResearch*_*/LocalCache/Local/hermes*")
return ("~/.hermes*",)
def gateway_service_definition_globs() -> tuple[str, ...]:
"""This OS user's gateway service definitions, each naming the HERMES_HOME it serves."""
if _WIN:
return ("%APPDATA%/Microsoft/Windows/Start Menu/Programs/Startup/Hermes_Gateway*",)
if sys.platform == "darwin":
return ("~/Library/LaunchAgents/ai.hermes.gateway*.plist",)
return ("$XDG_CONFIG_HOME/systemd/user/hermes-gateway*.service", "~/.config/systemd/user/hermes-gateway*.service")
def system_gateway_service_definition_globs() -> tuple[str, ...]:
"""Machine-wide gateway services. Each runs as the account its ``User=`` names (root when none)."""
return ("/etc/systemd/system/hermes-gateway*.service",) if _POSIX and sys.platform != "darwin" else ()
def mac_privacy_protected_dirs() -> tuple[str, ...]:
"""Folders macOS guards with a permission prompt (TCC); opening anything inside raises it."""
if sys.platform != "darwin":
return ()
return ("~/Documents", "~/Desktop", "~/Downloads", "~/Library/Mobile Documents") # windows-footgun: ok — macOS only
def windows_user_program_dirs() -> tuple[str, ...]:
if not _WIN:
return ()
return (
"%LOCALAPPDATA%/Programs",
"%USERPROFILE%/scoop/shims",
"%LOCALAPPDATA%/Microsoft/WinGet/Links",
)
def visual_studio_installer_dirs() -> tuple[str, ...]:
"""Where the Visual Studio installer puts vswhere.exe; it is never on PATH."""
return ("%ProgramFiles(x86)%/Microsoft Visual Studio/Installer",) if _WIN else ()
def mac_application_dirs() -> tuple[str, ...]:
return ("/Applications", "~/Applications") if sys.platform == "darwin" else ()
def flatpak_export_dirs() -> tuple[str, ...]:
"""Where flatpak links each installed app's launcher, named by its app id (system, then per-user)."""
return ("/var/lib/flatpak/exports/bin", "~/.local/share/flatpak/exports/bin") if sys.platform.startswith("linux") else ()
def snap_bin_dirs() -> tuple[str, ...]:
return ("/snap/bin",) if sys.platform.startswith("linux") else ()