# NousResearch/hermes-agent · Tilde (~) expansion using profile HOME in file tools

## Open now

- 1 issue, 1 PR open on GitHub.
- #27250: Docker/profile mode should avoid different HOME values between Hermes process and tool subprocesses
- PR #27259: fix(docker): align process HOME with active profile home

Members consistently concern in-process file tools expanding \`~\` with the gateway/main process HOME rather than the active profile's HOME, including related Docker/profile alignment of HOME between the main process and tool subprocesses. Most are fix proposals referencing the same issue (#48552), with one bug report and one related issue (#27250).

## TL;DR

- 9 member(s): 1 open issue(s), 1 closed issue(s), 1 open PR(s), 1 merged PR(s), 5 PR(s) closed without merging.
- A fix was merged to main in PR #51060. Verify it addresses your case.
- **Recommended:** read PR #51060 (and any competing PRs below) before filing. Confirm the merged change covers your symptom.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `partially_resolved` · deciding PR(s): `pr-51060`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_PARTIAL`): some members are connected by structural evidence (shared changed files, or a closing/superseded reference); the rest are joined by an automated relevance judgement over their text.
- Members outside that structural core may belong to a different underlying problem.
- Pairwise link density `0.20`: the share of member pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. `1.00` means every pair is linked.

## Open related issues

- #27250: Docker/profile mode should avoid different HOME values between Hermes process and tool subprocesses

## Closed / duplicate issues

- #48552: \[Bug\]: in-process file tools resolve ~ (tilde) using gateway HOME, not profile HOME, breaking cron jobs with tilde paths

## Prior & competing PRs

- **#48566: fix(tools): use profile-aware HOME for ~ expansion in file tools**. closed without merge · fix tier `suggested`
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`; refs `15880da8bbd5c9a48c3bc5f6955bea86fba54965`, `#48552`
- **#48573: fix(file-tools): expand ~ via profile HOME, not gateway process HOME**. closed without merge · fix tier `suggested`
  - maintainer direction: category `superseded_by_pr`; implication `superseded`; refs `#48566`
- **#51060: fix(file_tools): resolve tilde using profile home for file operations (#48552)**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`
  - files: `tests/tools/test_file_tools_tilde_profile.py`, `tools/file_tools.py`
- **#27259: fix(docker): align process HOME with active profile home**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`
  - files: `docker/entrypoint.sh`, `hermes_cli/main.py`, `tests/hermes_cli/test_apply_profile_override.py`
- **#27260: fix(profiles): align main-process HOME with subprocess HOME within a profile (#27250)**. closed without merge
  - maintainer direction: category `superseded_by_pr`; implication `superseded`
- **#48759: fix(file-tools): resolve tilde using effective home for in-process tools (#48552)**. closed without merge
  - maintainer direction: category `duplicate_of`; implication `duplicate`; refs `#48566`, `#48552`, `#48573`
- **#49251: fix(file-tools): resolve tilde paths via profile home (#48552)**. closed without merge
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`; refs `15880da8bbd5c9a48c3bc5f6955bea86fba54965`, `#51060`

## Fix status

- Merged to main in PR #51060 (cited above). No release data is tracked. Verify downstream.
- Fix last verified (merged) `2026-06-22`.
- Subsystem: `agent`