PR #15729: fix(cli): display profile wrapper alias name in help text

• Repository: NousResearch/hermes-agent
• Author: liuhao1024
• State: open | merged: False
• Link: https://github.com/NousResearch/hermes-agent/pull/15729

Description (problem / solution / changelog)

Summary

Profile wrapper help text now displays the alias name (e.g., june) instead of the hardcoded hermes in usage lines and examples.

Root Cause

Three hardcoded areas prevented wrapper-specific help display:

1. prog="hermes" was hardcoded in the top-level ArgumentParser
2. Help epilog examples contained static hermes strings
3. Wrapper scripts used exec hermes -p {name} without passing the actual binary name

Fix

• Modified wrapper generation in profiles.py and main.py to set HERMES_CLI_NAME env var from $0
• Added _cli_prog() helper to respect HERMES_CLI_NAME or fall back to sys.argv[0]
• Added _examples_epilog(prog) helper to interpolate the program name dynamically
• Updated ArgumentParser to use _cli_prog() and _examples_epilog()

Regression Coverage

Added test_wrapper_includes_hermes_cli_name_env_var to verify wrapper scripts set the env var.

Testing

• All 91 tests in tests/hermes_cli/test_profiles.py pass
• Wrapper script generation verified to include HERMES_CLI_NAME="$(basename "$0")"
• Manual verification of help text output shows wrapper name in usage and examples

Closes #15698

Changed files

• gateway/platforms/whatsapp.py (modified, +4/-1)
• hermes_cli/main.py (modified, +51/-36)
• hermes_cli/profiles.py (modified, +4/-1)
• tests/hermes_cli/test_profiles.py (modified, +44/-0)
• tests/tools/test_file_tools.py (modified, +37/-0)
• tools/file_tools.py (modified, +6/-6)

PR #15758: fix(cli): profile wrappers show alias name instead of hardcoded 'hermes' in --help (#15698)

• Repository: NousResearch/hermes-agent
• Author: briandevans
• State: open | merged: False
• Link: https://github.com/NousResearch/hermes-agent/pull/15758

Description (problem / solution / changelog)

Problem

When hermes profile add june --alias june creates a wrapper, running june --help showed:

usage: hermes [-h] ...

Examples:
    hermes                        Start interactive chat
    hermes chat -q "Hello"        Single query mode
    ...

The alias name was completely invisible to the user — unhelpful and confusing.

Fixes #15698.

Root cause

Two hard-coded "hermes" strings:

1. hermes_cli/main.py — ArgumentParser(prog="hermes", ...) and the epilog examples block were static strings.
2. hermes_cli/profiles.py — wrapper scripts were exec hermes -p {name} "$@" with no way to propagate the alias name back into the process.

Fix

1. Wrapper scripts now export HERMES_CLI_NAME

#!/bin/sh
HERMES_CLI_NAME="$(basename "$0")" exec hermes -p june "$@"

$(basename "$0") resolves to the invoked name (the alias), and the env var travels transparently into the hermes process. If the user symlinks the wrapper to another name, that name is also picked up correctly.

remove_wrapper_script identifies our wrappers by checking for "hermes -p", which still matches the new template — no regression.

2. _cli_prog() helper in main.py

def _cli_prog() -> str:
    return os.environ.get("HERMES_CLI_NAME") or Path(sys.argv[0]).name or "hermes"

Priority order:

1. HERMES_CLI_NAME env var (set by wrapper)
2. Path(sys.argv[0]).name (handles python -m hermes_cli, direct binary invocation)
3. "hermes" (ultimate fallback)

prog=_cli_prog() is passed to ArgumentParser, and the epilog examples use an f-string so every hermes <cmd> line becomes june <cmd> automatically.

After fix

$ june --help
usage: june [-h] [--version] ...

Examples:
    june                        Start interactive chat
    june chat -q "Hello"        Single query mode
    june -c                     Resume the most recent session
    ...

For more help on a command:
    june <command> --help

Tests

• TestWrapperScriptContent (3 tests in test_profiles.py):
  • wrapper contains HERMES_CLI_NAME="$(basename "$0")"
  • wrapper still satisfies remove_wrapper_script's safety check
  • shebang is #!/bin/sh
• TestCliProg (4 tests in test_cli_prog_name.py):
  • env var used when set
  • falls back to argv[0] basename
  • ultimate fallback is "hermes"
  • env var takes precedence over argv[0]

All 7 new tests pass alongside the existing 89 profile tests (96 total).

Checklist

• No breaking change — bare hermes --help still shows hermes (env var absent)
• Existing wrappers re-created via hermes profile add pick up the fix; old wrappers continue to work (they just don't set the env var)
• remove_wrapper_script still works for new wrappers
• Epilog and prog= are consistent — no mixed branding

Closes #15698

Changed files

• hermes_cli/main.py (modified, +46/-35)
• hermes_cli/profiles.py (modified, +16/-2)
• tests/hermes_cli/test_cli_prog_name.py (added, +31/-0)
• tests/hermes_cli/test_profiles.py (modified, +82/-0)