Proof Portal

Project overview

Omarchy

ProbeLabs65 findings · 95 requirements

A proof layer — requirements, tests and verified fixes — for two of Omarchy's subsystems: the application menu (launcher scripts, QML model, JSONC config, search and selection) and the lock screen (lock scripts, QML, PAM authentication). Scope is deliberately limited to those components of omacom/omarchy; the rest of the distribution is not covered.

Inbox
ReportR-2125GitHub issuePublicDecided· Out of scope

hermes-desktop launcher crashes: _desktop_launch_options() now returns 5 values

Reported by TimRudorf · filed Sep 30, 2026 · open at source

Decided: Out of scope — decided by agents · verified 3 days ago.

At a glance

1 · What is claimed?
Only the report text below — no validator has restated it as checkable claims yet.
2 · What does it affect?
AreaOutside the audited area· Decided by agents · verified
3 · Is it reproducible?
No validation has been run yet.
4 · What remains unclear?
  • Not validated yet: no claims, no reproducer.
5 · What happens next?
Decided by agents and verified by a second, independent agent — see the decision.

Original report

hermes-desktop launcher crashes: _desktop_launch_options() now returns 5 valuesrevision 1 · captured 2026-09-30 13:10 UTC via poll

Description

Hermes Desktop no longer starts from the app launcher. Running the packaged launcher directly shows:

$ hermes-desktop
Traceback (most recent call last):
  File "<stdin>", line 18, in <module>
ValueError: too many values to unpack (expected 4)

Cause

/usr/bin/hermes-desktop imports _desktop_launch_options() from the user's runtime (~/.hermes/hermes-agent) and unpacks four values:

flags, gpu, store, ozone = _desktop_launch_options()

Upstream hermes-agent added a fifth return value, renderer_accessibility: bool, in commit ea647bd518 ("fix(desktop): expose the renderer accessibility tree to dictation/IME tools (#118271)", 2026-09-26). The signature is now:

def _desktop_launch_options() -> tuple[list[str], str, str, str, bool]:

The launcher only catches ImportError, so this ValueError stops it before Electron starts. Launching from the app launcher fails silently.

Steps to reproduce

  1. Install hermes-desktop 2026.8.31-3 from the omarchy repo.
  2. Update the Hermes runtime in ~/.hermes/hermes-agent to current main (any commit after ea647bd518).
  3. Start Hermes from the app launcher, or run hermes-desktop.

Expected: Hermes Desktop opens.
Actual: The launcher exits with the traceback above.

Workaround

hermes desktop --skip-build (the upstream CLI) starts the app normally.

Possible fix

Accept extra return values, e.g. flags, gpu, store, ozone, *_ = _desktop_launch_options(). Also passing renderer_accessibility through the way upstream's own launcher does would be the complete fix.

System

  • Omarchy 4.0.4-1
  • hermes-desktop 2026.8.31-3 (omarchy repo)
  • Kernel 7.2.5-3-omarchy
View raw text
**Description**

Hermes Desktop no longer starts from the app launcher. Running the packaged launcher directly shows:

```
$ hermes-desktop
Traceback (most recent call last):
  File "<stdin>", line 18, in <module>
ValueError: too many values to unpack (expected 4)
```

**Cause**

`/usr/bin/hermes-desktop` imports `_desktop_launch_options()` from the user's runtime (`~/.hermes/hermes-agent`) and unpacks four values:

```python
flags, gpu, store, ozone = _desktop_launch_options()
```

Upstream hermes-agent added a fifth return value, `renderer_accessibility: bool`, in commit `ea647bd518` ("fix(desktop): expose the renderer accessibility tree to dictation/IME tools (#118271)", 2026-09-26). The signature is now:

```python
def _desktop_launch_options() -> tuple[list[str], str, str, str, bool]:
```

The launcher only catches `ImportError`, so this `ValueError` stops it before Electron starts. Launching from the app launcher fails silently.

**Steps to reproduce**

1. Install `hermes-desktop` 2026.8.31-3 from the omarchy repo.
2. Update the Hermes runtime in `~/.hermes/hermes-agent` to current `main` (any commit after `ea647bd518`).
3. Start Hermes from the app launcher, or run `hermes-desktop`.

**Expected:** Hermes Desktop opens.
**Actual:** The launcher exits with the traceback above.

**Workaround**

`hermes desktop --skip-build` (the upstream CLI) starts the app normally.

**Possible fix**

Accept extra return values, e.g. `flags, gpu, store, ozone, *_ = _desktop_launch_options()`. Also passing `renderer_accessibility` through the way upstream's own launcher does would be the complete fix.

**System**

- Omarchy 4.0.4-1
- hermes-desktop 2026.8.31-3 (omarchy repo)
- Kernel 7.2.5-3-omarchy

Validation

Not checked yet. A validator will restate this report as checkable claims, map it to the project's requirements and write a reproducer that the proof engine runs.

Linked

Not linked to any known issue, other report or change yet.

Decision

Decisions are recorded by our staff — or, where this project allows it, by agents: checked by a second, independent agent, or by a single agent where the project's policy says so. Any decision reached so far is shown below.

  • Out of scopeDecided by agents · verified · 2026-10-09 20:20 UTC