# NousResearch/hermes-agent · handling OSError when gh CLI is not executable

## Open now

- 1 issue, 2 PRs open on GitHub.
- #39540: hermes doctor crashes with PermissionError when gh is unavailable (e.g. WSL pointing to gh.exe)
- PR #39545: fix(cli): catch OSError in _gh_authenticated to handle PermissionError
- PR #41837: fix(cli): handle gh execution errors in doctor

These issues and PRs address a crash in the hermes doctor command when the gh CLI is unavailable or not executable, such as in WSL environments pointing to gh.exe. The proposed fixes involve catching OSError and PermissionError in the _gh_authenticated function.

## TL;DR

- 5 member(s): 1 open issue(s), 0 closed issue(s), 2 open PR(s), 0 merged PR(s), 2 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.

## Open related issues

- #39540: hermes doctor crashes with PermissionError when gh is unavailable (e.g. WSL pointing to gh.exe)

## Prior & competing PRs

- **#39605: fix(doctor): catch OSError/PermissionError in _gh_authenticated**. closed without merge · fix tier `suggested`
  - maintainer direction: category `uncategorized`; implication `needs_llm`; refs `#39545`, `#39648`
  - _suggested-tier fix detail withheld; re-request with `?tier=all` to include it._
- **#39545: fix(cli): catch OSError in _gh_authenticated to handle PermissionError**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`
  - files: `hermes_cli/doctor.py`, `tests/hermes_cli/test_doctor.py`
- **#39648: fix(doctor): catch OSError when gh CLI is not executable**. closed without merge
  - maintainer direction: category `duplicate_of`; implication `duplicate`; refs `#39545`, `#39605`
- **#41837: fix(cli): handle gh execution errors in doctor**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`; refs `#39540`
  - files: `hermes_cli/doctor.py`, `tests/hermes_cli/test_doctor.py`

## Fix status

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