TL;DR

Modify the _load_agents_md() function to check the HERMES_HOME directory before falling back to the current working directory to ensure the AGENTS.md file is loaded correctly in both CLI and gateway modes.

Guidance

• Update the _load_agents_md() function to prioritize checking the HERMES_HOME directory for the AGENTS.md file, as suggested in the provided code snippet.
• Ensure the get_hermes_home() function is correctly implemented to retrieve the HERMES_HOME directory path.
• Consider adding error handling or logging to handle cases where the AGENTS.md file is not found in either the HERMES_HOME or current working directory.
• Users can create a symlink to their AGENTS.md file in the ~/.hermes/ directory as a temporary workaround.

Example

def _load_agents_md(cwd_path: Path) -> str:
    # 1. Check HERMES_HOME first (works for all platforms)
    hermes_home = get_hermes_home()
    for name in ["AGENTS.md", "agents.md"]:
        candidate = hermes_home / name
        if candidate.exists():
            # Load the AGENTS.md file from HERMES_HOME
            ...

    # 2. Fall back to cwd (project directory)
    for name in ["AGENTS.md", "agents.md"]:
        candidate = cwd_path / name
        if candidate.exists():
            # Load the AGENTS.md file from cwd
            ...

Notes

The provided code snippet and suggested fix assume that the get_hermes_home() function is correctly implemented and returns the path to the HERMES_HOME directory.

Recommendation

Apply the suggested fix by modifying the _load_agents_md() function to check the HERMES_HOME directory first, as this will ensure the AGENTS.md file is loaded correctly in both CLI and gateway modes.