v2.1.0 (WIP)

v2.1.0 — WORK IN PROGRESS

Status: WIP. This add-on is functional but still being polished. Hotkeys, foreground routing, and the Hermes app.asar patcher all work, but expect rough edges. Do not rely on it for production screen-reader use without testing your specific workflow first. Please file issues for anything that gets in your way.

What's in this release

• Foreground-aware routing — the same NVDA+Alt+… hotkey does the right thing in Hermes vs OpenCode, with no double-bindings and no conflicts. Pass-through (gesture.send()) when neither app is foreground.
• Message navigation — NVDA+Alt+Up/Down/Home/End jumps between messages, NVDA+Alt+R re-reads the current one.
• Session switching — NVDA+Alt+S opens a session picker, NVDA+Alt+Shift+N/P cycles sessions. Hermes routes through the hermes://session/<id> deep link; OpenCode routes through opencode://open-project?directory=….
• Hermes @ reference picker — NVDA+Alt+Space opens a two-pane dialog for @folder:, @file:, @url:, @diff, @staged, @git:N. Whitespace-safe path wrapping.
• Hermes speech filter — NVDA+Shift+H silences thinking / running / timer / spinner status spam at the speak() interception point. NVDA+Shift+J reports state and suppression count.
• OpenCode auto-read + thinking trace — NVDA+Alt+A toggles auto-read of new assistant messages; NVDA+Alt+T reads the thinking trace.
• Ctrl+N global fallback chain — in OpenCode: button → API → bridge → clipboard → keystroke. Everywhere else: pass-through.
• Self-healing Hermes app.asar patcher (new in 2.1.0) — re-checks the patch on every session-pick (60s TTL cache), re-applies automatically if a Hermes update overwrote it, and announces "Hermes session patch failed: " audibly if the patch cannot be applied. Pattern-based matching so upstream reformatting doesn't break it. Run node patch_app_asar.js --audit for a no-side-effect status report.

Compatibility

• NVDA 2024.1 or later (tested on 2026.1)
• Hermes Agent desktop app (Electron)
• OpenCode Desktop

Install

1. Download agentDesktopAccessibility-2.1.0.nvda-addon below.
2. NVDA+N → Tools → Manage Add-ons → Install → select the file.
3. Restart NVDA when prompted.

Upgrade note: if you have the legacy hermesAccessibility or opencodeAccessibility add-ons installed, disable them before installing this one. Both legacy add-ons can be uninstalled after you confirm the merged add-on works.

License

GNU GPL v2 or later. See COPYING.