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-977GitHub issuePublicDecided· Out of scope

o.launch_on_start()/o.launch() breaks Hyprland's [workspace N silent] exec-rule bracket syntax

Reported by je2020je · filed Sep 4, 2026 · open at source

Decided: Out of scope — decided by agents · verified 4 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

o.launch_on_start()/o.launch() breaks Hyprland's [workspace N silent] exec-rule bracket syntaxrevision 1 · captured 2026-09-28 21:24 UTC via poll

Summary

o.launch(command) / o.launch_on_start(command) in default/hypr/helpers.lua prefix every command with uwsm-app --:

function o.launch(command)
  return "uwsm-app -- " .. command
end

This breaks Hyprland's standard exec-rule bracket syntax ([workspace N silent] command, [float], etc. — https://wiki.hypr.land/Configuring/Dispatchers/#exec) when used inside these helpers, because uwsm-app does its own argv parsing and tries to look up [workspace as a literal executable name instead of passing the bracketed prefix through to Hyprland's exec dispatcher.

Repro

On a stock Omarchy Lua-config install (Hyprland 0.56.2):

$ uwsm-app -- '[workspace 4 silent] foot'
Error: Command not found: "[workspace 4 silent] foot"

Confirmed via journalctl --user:

uwsm_app-daemon[...]: received: app -- '[workspace' 4 'silent]' foot
uwsm_app-daemon[...]: sent: error 'Error: Command not found: "[workspace"' 1

By contrast, calling hl.exec_cmd directly (bypassing o.launch/the uwsm-app -- wrapper) works correctly:

$ hyprctl eval 'hl.exec_cmd("[workspace 3 silent] foot")'
ok
# foot lands on workspace 3, confirmed via hyprctl clients -j

So the bracket syntax itself is fine at the Hyprland/hl.exec_cmd layer — it's specifically the uwsm-app -- wrapping in o.launch()/o.launch_on_start() that swallows it.

Impact

Anyone writing ~/.config/hypr/autostart.lua and reaching for the classic Hyprland o.launch_on_start("[workspace 2 silent] some-app") pattern (e.g. from prior hyprlang experience, or Hyprland's own docs) gets a silent no-op — no window ever appears, and there's no obvious error surfaced to the user (it only shows up in journalctl --user). The workaround is to skip o.launch_on_start for such commands and instead persist a class-based o.window(class, { workspace = "N silent" }) rule in hyprland.lua, but that's non-obvious and workspace-pins by class rather than per-launch.

Suggested fix

Either:
- Have o.launch/o.launch_on_start detect a leading [...] bracket prefix and keep it outside the uwsm-app -- wrapping (e.g. [workspace 2 silent] uwsm-app -- some-app), or
- Document in the autostart section of the manual that bracket exec-rule syntax doesn't work through these helpers, and that a persistent o.window class rule is the supported way to pin a launched app's workspace.

Happy to help test a fix if useful.

View raw text
## Summary

`o.launch(command)` / `o.launch_on_start(command)` in `default/hypr/helpers.lua` prefix every command with `uwsm-app --`:

```lua
function o.launch(command)
  return "uwsm-app -- " .. command
end
```

This breaks Hyprland's standard exec-rule bracket syntax (`[workspace N silent] command`, `[float]`, etc. — https://wiki.hypr.land/Configuring/Dispatchers/#exec) when used inside these helpers, because `uwsm-app` does its own argv parsing and tries to look up `[workspace` as a literal executable name instead of passing the bracketed prefix through to Hyprland's exec dispatcher.

## Repro

On a stock Omarchy Lua-config install (Hyprland 0.56.2):

```
$ uwsm-app -- '[workspace 4 silent] foot'
Error: Command not found: "[workspace 4 silent] foot"
```

Confirmed via `journalctl --user`:

```
uwsm_app-daemon[...]: received: app -- '[workspace' 4 'silent]' foot
uwsm_app-daemon[...]: sent: error 'Error: Command not found: "[workspace"' 1
```

By contrast, calling `hl.exec_cmd` directly (bypassing `o.launch`/the `uwsm-app --` wrapper) works correctly:

```
$ hyprctl eval 'hl.exec_cmd("[workspace 3 silent] foot")'
ok
# foot lands on workspace 3, confirmed via hyprctl clients -j
```

So the bracket syntax itself is fine at the Hyprland/`hl.exec_cmd` layer — it's specifically the `uwsm-app --` wrapping in `o.launch()`/`o.launch_on_start()` that swallows it.

## Impact

Anyone writing `~/.config/hypr/autostart.lua` and reaching for the classic Hyprland `o.launch_on_start("[workspace 2 silent] some-app")` pattern (e.g. from prior hyprlang experience, or Hyprland's own docs) gets a silent no-op — no window ever appears, and there's no obvious error surfaced to the user (it only shows up in `journalctl --user`). The workaround is to skip `o.launch_on_start` for such commands and instead persist a class-based `o.window(class, { workspace = "N silent" })` rule in `hyprland.lua`, but that's non-obvious and workspace-pins by class rather than per-launch.

## Suggested fix

Either:
- Have `o.launch`/`o.launch_on_start` detect a leading `[...]` bracket prefix and keep it outside the `uwsm-app --` wrapping (e.g. `[workspace 2 silent] uwsm-app -- some-app`), or
- Document in the autostart section of the manual that bracket exec-rule syntax doesn't work through these helpers, and that a persistent `o.window` class rule is the supported way to pin a launched app's workspace.

Happy to help test a fix if useful.

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 10:46 UTC