# NousResearch/hermes-agent · Matrix adapter macOS E2EE dependency issues

## Open now

- 1 issue, 1 PR open on GitHub.
- #85588: \[Bug\]: mautrix pin bump to 0.21.1 takes the Matrix adapter down on macOS
- PR #93860: fix(matrix): gate only the olm-bound E2EE part to Linux so plaintext Matrix installs on macOS

These items address a bug where mautrix or its encryption-related dependencies break the Matrix adapter on macOS. The proposed fixes involve separating E2EE dependencies and adjusting how mautrix extras are installed.

## TL;DR

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

- #85588: \[Bug\]: mautrix pin bump to 0.21.1 takes the Matrix adapter down on macOS

## Prior & competing PRs

- **#85596: fix(matrix): install mautrix without the encryption extra**. closed without merge
  - maintainer direction: category `superseded_by_pr`; implication `superseded`; refs `#93860`
- **#93860: fix(matrix): gate only the olm-bound E2EE part to Linux so plaintext Matrix installs on macOS**. open
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`; refs `#62401`, `#122733`
  - files: `contributors/emails/[redacted:email]`, `hermes_cli/gateway_setup_wizard.py`, `plugins/platforms/matrix/adapter.py`, `pm/extras.py`, `pyproject.toml`, `tests/gateway/test_matrix.py`, `tests/gateway/test_matrix_plugin_setup.py`, `tests/hermes_cli/test_gateway_platform_gating.py`, `tests/pm/test_extras.py`, `website/docs/user-guide/messaging/matrix.md`, `website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/matrix.md`

## Fix status

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