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

omarchy-upgrade-to-quattro enables bt-agent.service but orphans bluez-tools (its only source of /usr/bin/bt-agent) — infinite restart loop

Reported by lemachinarbo · filed Aug 15, 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

omarchy-upgrade-to-quattro enables bt-agent.service but orphans bluez-tools (its only source of /usr/bin/bt-agent) — infinite restart looprevision 1 · captured 2026-09-28 21:29 UTC via poll

Note: issue reported by AI.

What happened

After the Quattro migration, bt-agent.service restart-loops forever
(every 2s, indefinitely — 668 restarts in the first 25 minutes of a boot on
my machine):

bt-agent.service: Unable to locate executable '/usr/bin/bt-agent': No such file or directory
bt-agent.service: Failed at step EXEC spawning /usr/bin/bt-agent: No such file or directory
bt-agent.service: Main process exited, code=exited, status=203/EXEC
bt-agent.service: Failed with result 'exit-code'.
(repeats forever)

Root cause (traced through my own pacman.log + the migration script)

/usr/bin/bt-agent is provided by bluez-tools, not bluez-utils. On my
machine omarchy-upgrade-to-quattro ran a transaction that:

  1. Installed bluetui
  2. Removed blueberry via pacman -Rns, which cascaded and removed

gnome-bluetooth and bluez-tools as now-orphaned dependencies
(bluez-tools was never installed for its own sake — it came in
transitively via blueberry/gnome-bluetooth)
3. Later in the same script, enable_user_unit bt-agent.service
(bin/omarchy-upgrade-to-quattro, retiring
systemd/user/bt-agent.service -> /usr/lib/systemd/user/bt-agent.service,
shipped by omarchy-settings)

omarchy-settings does not depend on bluez-tools:

$ pacman -Qi omarchy-settings | grep Depends
Depends On : bash curl gum hicolor-icon-theme plymouth

So the same migration that retires blueberry (bt-agent's last remaining
dependent) also turns on a unit that requires the binary blueberry was
providing indirectly, with nothing left to guarantee it's still installed.
Anyone who goes through this migration and doesn't happen to have
bluez-tools pulled in by something else ends up with a permanently
crash-looping user unit.

Expected

Either:
- omarchy-settings should depend on bluez-tools (or whatever package
currently provides bt-agent upstream), or
- bt-agent.service should have an ExecCondition that fails cleanly when
the binary is missing, the way the neighboring bluetooth condition
(ExecCondition=systemctl is-active --quiet bluetooth.service) already
does for the "no adapter" case.

Possible side effect (correlation, not proven)

While investigating this I was actually chasing an unrelated
sway-audio-idle-inhibit crash (aborts by design on any D-Bus error talking
to logind — that part is a bug in that upstream AUR project, not Omarchy).
All of that program's crashes on my machine landed inside one of these
bt-agent.service restart-loop windows, which touch the system D-Bus every
2 seconds. I can't prove the loop caused the D-Bus hiccup, but it's a
plausible mechanism and seems worth mentioning in case others hit the same
combination.

System

  • Omarchy 4.0.0-1
  • Kernel 7.1.8-arch1-3
View raw text
_Note: issue reported by AI._

## What happened

After the Quattro migration, `bt-agent.service` restart-loops forever
(every 2s, indefinitely — 668 restarts in the first 25 minutes of a boot on
my machine):

    bt-agent.service: Unable to locate executable '/usr/bin/bt-agent': No such file or directory
    bt-agent.service: Failed at step EXEC spawning /usr/bin/bt-agent: No such file or directory
    bt-agent.service: Main process exited, code=exited, status=203/EXEC
    bt-agent.service: Failed with result 'exit-code'.
    (repeats forever)

## Root cause (traced through my own pacman.log + the migration script)

`/usr/bin/bt-agent` is provided by `bluez-tools`, not `bluez-utils`. On my
machine `omarchy-upgrade-to-quattro` ran a transaction that:

1. Installed `bluetui`
2. Removed `blueberry` via `pacman -Rns`, which cascaded and removed
   `gnome-bluetooth` and `bluez-tools` as now-orphaned dependencies
   (`bluez-tools` was never installed for its own sake — it came in
   transitively via blueberry/gnome-bluetooth)
3. Later in the same script, `enable_user_unit bt-agent.service`
   (bin/omarchy-upgrade-to-quattro, retiring
   `systemd/user/bt-agent.service` -> `/usr/lib/systemd/user/bt-agent.service`,
   shipped by `omarchy-settings`)

`omarchy-settings` does not depend on `bluez-tools`:

    $ pacman -Qi omarchy-settings | grep Depends
    Depends On      : bash  curl  gum  hicolor-icon-theme  plymouth

So the same migration that retires blueberry (bt-agent's last remaining
dependent) also turns on a unit that requires the binary blueberry was
providing indirectly, with nothing left to guarantee it's still installed.
Anyone who goes through this migration and doesn't happen to have
`bluez-tools` pulled in by something else ends up with a permanently
crash-looping user unit.

## Expected

Either:
- `omarchy-settings` should depend on `bluez-tools` (or whatever package
  currently provides `bt-agent` upstream), or
- `bt-agent.service` should have an `ExecCondition` that fails cleanly when
  the binary is missing, the way the neighboring bluetooth condition
  (`ExecCondition=systemctl is-active --quiet bluetooth.service`) already
  does for the "no adapter" case.

## Possible side effect (correlation, not proven)

While investigating this I was actually chasing an unrelated
`sway-audio-idle-inhibit` crash (aborts by design on any D-Bus error talking
to logind — that part is a bug in that upstream AUR project, not Omarchy).
All of that program's crashes on my machine landed inside one of these
`bt-agent.service` restart-loop windows, which touch the system D-Bus every
2 seconds. I can't prove the loop caused the D-Bus hiccup, but it's a
plausible mechanism and seems worth mentioning in case others hit the same
combination.

## System

- Omarchy 4.0.0-1
- Kernel 7.1.8-arch1-3

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