# NousResearch/hermes-agent · sys.path ordering fix for checkout root at import

## Open now

- 1 issue, 2 PRs open on GitHub.
- #117698: Platform adapters prepend the checkout root onto sys.path at import, shadowing installed packages process-wide
- PR #117699: fix(plugins): stop prepending the checkout root onto sys.path at import
- PR #117779: fix(imports): append checkout root instead of prepending it at import

These issues and PRs concern platform adapters prepending the checkout root to sys.path at import time, which can shadow installed packages process-wide. The proposed fix changes the behavior to append rather than prepend the path.

## TL;DR

- 3 member(s): 1 open issue(s), 0 closed issue(s), 2 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.67`: 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

- #117698: Platform adapters prepend the checkout root onto sys.path at import, shadowing installed packages process-wide

## Prior & competing PRs

- **#117699: fix(plugins): stop prepending the checkout root onto sys.path at import**. open
  - maintainer direction: category `partial_fix`; implication `needs_llm`; refs `#117698`
  - files: `cron/scheduler.py`, `gateway/platforms/base.py`, `gateway/run.py`, `hermes_cli/cron.py`, `hermes_cli/doctor_tools.py`, `hermes_cli/gateway.py`, `plugins/platforms/discord/adapter.py`, `plugins/platforms/raft/adapter.py`, `plugins/platforms/slack/adapter.py`, `plugins/platforms/telegram/adapter.py`, `plugins/platforms/whatsapp/adapter.py`, `tests/plugins/platforms/test_platform_adapter_sys_path.py`, `tools/cronjob_tools.py`
- **#117779: fix(imports): append checkout root instead of prepending it at import**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`; refs `#117805`, `#117805`
  - files: `cron/scheduler.py`, `gateway/platforms/base.py`, `gateway/run.py`, `hermes_cli/_startup_fast.py`, `hermes_cli/cron.py`, `hermes_cli/doctor_tools.py`, `hermes_cli/gateway.py`, `hermes_cli/main.py`, `hermes_cli/web_server.py`, `plugins/platforms/discord/adapter.py`, `plugins/platforms/raft/adapter.py`, `plugins/platforms/slack/adapter.py`, `plugins/platforms/telegram/adapter.py`, `plugins/platforms/whatsapp/adapter.py`, `tests/test_import_path_hygiene.py`, `tools/cronjob_tools.py`

## Fix status

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