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

contributing guide: 'omarchy debug' command does not exist (4.0.3-1)

Reported by jte369 · filed Sep 15, 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

contributing guide: 'omarchy debug' command does not exist (4.0.3-1)revision 1 · captured 2026-09-28 21:23 UTC via poll

Summary

The contributing guide instructs bug reporters to run omarchy debug, but no debug command exists in the shipped CLI (verified on 4.0.3-1). Reporters following the guide hit a dead end before they can generate the diagnostics the template asks for.

Environment

  • Omarchy: 4.0.3-1 (Arch Linux package)
  • Hyprland: 0.56.2-2
  • CPU: AMD Ryzen 7 7735HS (Radeon 680M iGPU)
  • RAM: 27 GiB

What happened

$ omarchy debug --no-sudo --print
Unknown Omarchy command: omarchy debug
Run 'omarchy commands --all' to discover available commands.
$ omarchy commands --all | grep -- -debug
(no output — the command is not registered)

omarchy debug alone (the interactive variant the guide also references, which it says uploads to logs.omarchy.org and prints a shareable URL) fails identically.

What was expected

The contributing guide (and the omarchy.org docs) reference:

  • omarchy debug --no-sudo --print — "also written to /tmp/omarchy-debug.log"
  • omarchy debug — interactive variant that uploads the log to logs.omarchy.org (expires after 24h) and prints a shareable URL

Given the issue template asks for a diagnostics log, a working omarchy debug (or an updated guide) is needed so reporters can actually gather it.

Suggested fix

Either ship the debug command, or update the contributing guide / docs to point at whatever the current supported way of generating diagnostics is (e.g. vendored omarchy-system-info-style output, journalctl excerpts, hyprctl systeminfo).

View raw text
## Summary

The contributing guide instructs bug reporters to run `omarchy debug`, but no `debug` command exists in the shipped CLI (verified on 4.0.3-1). Reporters following the guide hit a dead end before they can generate the diagnostics the template asks for.

## Environment

- Omarchy: 4.0.3-1 (Arch Linux package)
- Hyprland: 0.56.2-2
- CPU: AMD Ryzen 7 7735HS (Radeon 680M iGPU)
- RAM: 27 GiB

## What happened

```text
$ omarchy debug --no-sudo --print
Unknown Omarchy command: omarchy debug
Run 'omarchy commands --all' to discover available commands.
```

```text
$ omarchy commands --all | grep -- -debug
(no output — the command is not registered)
```

`omarchy debug` alone (the interactive variant the guide also references, which it says uploads to logs.omarchy.org and prints a shareable URL) fails identically.

## What was expected

The contributing guide (and the omarchy.org docs) reference:

- `omarchy debug --no-sudo --print` — "also written to /tmp/omarchy-debug.log"
- `omarchy debug` — interactive variant that uploads the log to logs.omarchy.org (expires after 24h) and prints a shareable URL

Given the issue template asks for a diagnostics log, a working `omarchy debug` (or an updated guide) is needed so reporters can actually gather it.

## Suggested fix

Either ship the `debug` command, or update the contributing guide / docs to point at whatever the current supported way of generating diagnostics is (e.g. vendored `omarchy-system-info`-style output, journalctl excerpts, `hyprctl systeminfo`).

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 13:47 UTC