# NousResearch/hermes-agent · Session file cleanup and directory path fixes

## Open now

- 0 issues, 4 PRs open on GitHub.
- PR #20342: fix(state): use session_ prefix in _remove_session_files for .json cleanup
- PR #20685: fix: pass sessions_dir to delete_session in web API endpoint (#20334)
- PR #55100: fix(session): pass the active sessions_dir to HTTP delete endpoints for on-disk cleanup (#55088)
- PR #123272: fix(sessions): dashboard and gateway API session deletes scrub on-disk transcripts too (salvage #20685 #55100 #20342)

These issues and pull requests address a bug where deleting Hermes sessions leaves orphaned JSON files on disk, caused by filename prefix mismatches and missing sessions_dir arguments in delete endpoints.

## TL;DR

- 5 member(s): 0 open issue(s), 1 closed issue(s), 4 open PR(s), 0 merged PR(s), 0 PR(s) closed without merging.
- No fix has been merged to main; one or more PRs were attempted (see below).
- **Recommended:** review the prior/competing PR(s) below. A fix was attempted but not merged; your case may extend or revive that work.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `unresolved`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_SPANNING`): every member is connected by structural evidence: shared changed files, or a closing/superseded reference.
- Pairwise link density `0.40`: 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.

## Closed / duplicate issues

- #20334: \[Bug\]: \`hermes sessions delete\` leaves \`session_<id>.json\` orphaned on disk (writer/remover filename mismatch)

## Prior & competing PRs

- **#20342: fix(state): use session_ prefix in _remove_session_files for .json cleanup**. open
  - maintainer direction: category `superseded_by_pr`; implication `superseded`; refs `#123272`
  - files: `agent/agent_runtime_helpers.py`, `hermes_state.py`, `hermes_state_common.py`, `run_agent.py`, `tests/test_hermes_state.py`
- **#20685: fix: pass sessions_dir to delete_session in web API endpoint (#20334)**. open
  - maintainer direction: category `merged_via`; implication `superseded`; refs `#123272`
  - files: `hermes_cli/web_server.py`
- **#55100: fix(session): pass the active sessions_dir to HTTP delete endpoints for on-disk cleanup (#55088)**. open
  - maintainer direction: category `superseded_by_pr`; implication `superseded`; refs `#123272`, `#20342`
  - files: `agent/agent_runtime_helpers.py`, `gateway/platforms/api_server.py`, `hermes_cli/web_routers/sessions.py`, `hermes_state.py`, `hermes_state_common.py`, `run_agent.py`, `tests/gateway/test_session_api.py`, `tests/hermes_cli/test_web_server.py`, `tests/test_hermes_state.py`
- **#123272: fix(sessions): dashboard and gateway API session deletes scrub on-disk transcripts too (salvage #20685 #55100 #20342)**. open
  - maintainer direction: category `wontfix_bydesign`; implication `wontfix`; refs `#55100`
  - files: `gateway/platforms/api_server.py`, `hermes_cli/web_routers/sessions.py`, `hermes_state_sessions.py`, `tests/gateway/test_session_api.py`, `tests/hermes_cli/test_web_server.py`, `tests/hermes_state/test_hermes_state.py`

## Fix status

- No merged fix on record.
- Subsystem: `dashboard`