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

omarchy-font-set: terminal restart notifications never fire — -g consumes the message as a glyph

Reported by WhiskeyTuesday · filed Aug 16, 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-font-set: terminal restart notifications never fire — -g consumes the message as a glyphrevision 1 · captured 2026-09-28 21:29 UTC via poll
Filed by Claude (Claude Code) on behalf of @whiskeytuesday, who hit this on their machine and reviewed this report before it was filed.

Summary

omarchy-font-set never delivers its "you must restart your terminal" notifications. Both calls pass the message where omarchy-notification-send expects a glyph, so the message is consumed by -g, no headline argument is left, and omarchy-notification-send exits 1 with its usage string instead of sending anything.

The failure is silent in normal use: omarchy-font-set has no set -e, and the two calls are the last statements before omarchy-hook, so the script still exits 0. Users who change fonts while Ghostty or Foot is running are simply never told to restart, and the stale font reads as "the font change didn't work".

Steps to reproduce

With Ghostty (or Foot) running:

omarchy font set "JetBrainsMono Nerd Font"

Observed on stdout, in place of the notification:

Usage: omarchy-notification-send [--exec <command>] [--app-name <app-name>] [-g <glyph>] [-u <low|normal|critical>] [--image <path-or-uri>] <headline> [description] [notify-send options]

Reduced to the exact call the script makes:

$ omarchy-notification-send -g  "You must restart Ghostty to see font change"
Usage: omarchy-notification-send [--exec <command>] ... <headline> [description] [notify-send options]
$ echo $?
1

No notification appears in either case.

Root cause

bin/omarchy-font-set (lines 71 and 75 on master):

omarchy-notification-send -g  "You must restart Ghostty to see font change"
omarchy-notification-send -g  "You must restart Foot to see font change"

-g is --glyph and takes a value (bin/omarchy-notification-send, parse_omarchy_option):

-g | --glyph)
  if (($# < 2)); then ... fi
  glyph=$2
  parsed_option_args=2

So glyph becomes "You must restart Ghostty to see font change", $# drops to 0, and the (($# < 1)) guard prints usage and exits 1.

The doubled space after -g on both lines suggests a glyph was intended there and was lost at some point.

Expected

A notification with a headline, as omarchy-display-text-size does for the same Foot-cannot-reload case:

omarchy-notification-send "Restart Foot to apply the new terminal font size" ...

Suggested fix

Either drop the empty flag:

omarchy-notification-send "You must restart Ghostty to see font change"

or restore a glyph:

omarchy-notification-send -g "󰛖" "You must restart Ghostty to see font change"

Both verified working on the affected machine (exit 0, notification delivered).

A guard in omarchy-notification-send — warning when a --glyph value looks like a sentence, or making a missing headline noisier than a usage line on stdout — would also have surfaced this at the call site.

System

AMD Ryzen 7 PRO 5850U, AMD Cezanne (Radeon Vega Mobile), Omarchy 4.0.0-1

Omarchy4.0.0-1
Hyprland0.56.2
Kernel7.1.8-arch1-3
MachineThinkPad P14s Gen 2a
Ghostty1.3.1-arch2
Foot1.27.0

Full omarchy-debug output omitted: this is an argument-order defect that reproduces from the source alone and is present on master (verified via repos/basecamp/omarchy/contents/bin/omarchy-font-set at time of filing), not just in the installed package. Happy to attach the log if useful.

Checked for duplicates before filing; nothing found in issues or PRs. Note that open PR #6958 modifies bin/omarchy-font-set for an unrelated reason and stubs omarchy-notification-send in its new test, but does not change these two lines.

View raw text
> Filed by Claude (Claude Code) on behalf of @whiskeytuesday, who hit this on their machine and reviewed this report before it was filed.

## Summary

`omarchy-font-set` never delivers its "you must restart your terminal" notifications. Both calls pass the message where `omarchy-notification-send` expects a *glyph*, so the message is consumed by `-g`, no headline argument is left, and `omarchy-notification-send` exits 1 with its usage string instead of sending anything.

The failure is silent in normal use: `omarchy-font-set` has no `set -e`, and the two calls are the last statements before `omarchy-hook`, so the script still exits 0. Users who change fonts while Ghostty or Foot is running are simply never told to restart, and the stale font reads as "the font change didn't work".

## Steps to reproduce

With Ghostty (or Foot) running:

```bash
omarchy font set "JetBrainsMono Nerd Font"
```

Observed on stdout, in place of the notification:

```
Usage: omarchy-notification-send [--exec <command>] [--app-name <app-name>] [-g <glyph>] [-u <low|normal|critical>] [--image <path-or-uri>] <headline> [description] [notify-send options]
```

Reduced to the exact call the script makes:

```bash
$ omarchy-notification-send -g  "You must restart Ghostty to see font change"
Usage: omarchy-notification-send [--exec <command>] ... <headline> [description] [notify-send options]
$ echo $?
1
```

No notification appears in either case.

## Root cause

`bin/omarchy-font-set` (lines 71 and 75 on `master`):

```bash
omarchy-notification-send -g  "You must restart Ghostty to see font change"
omarchy-notification-send -g  "You must restart Foot to see font change"
```

`-g` is `--glyph` and takes a value (`bin/omarchy-notification-send`, `parse_omarchy_option`):

```bash
-g | --glyph)
  if (($# < 2)); then ... fi
  glyph=$2
  parsed_option_args=2
```

So `glyph` becomes `"You must restart Ghostty to see font change"`, `$#` drops to 0, and the `(($# < 1))` guard prints usage and exits 1.

The doubled space after `-g` on both lines suggests a glyph was intended there and was lost at some point.

## Expected

A notification with a headline, as `omarchy-display-text-size` does for the same Foot-cannot-reload case:

```bash
omarchy-notification-send "Restart Foot to apply the new terminal font size" ...
```

## Suggested fix

Either drop the empty flag:

```bash
omarchy-notification-send "You must restart Ghostty to see font change"
```

or restore a glyph:

```bash
omarchy-notification-send -g "󰛖" "You must restart Ghostty to see font change"
```

Both verified working on the affected machine (exit 0, notification delivered).

A guard in `omarchy-notification-send` — warning when a `--glyph` value looks like a sentence, or making a missing headline noisier than a usage line on stdout — would also have surfaced this at the call site.

## System

AMD Ryzen 7 PRO 5850U, AMD Cezanne (Radeon Vega Mobile), Omarchy 4.0.0-1

| | |
|---|---|
| Omarchy | 4.0.0-1 |
| Hyprland | 0.56.2 |
| Kernel | 7.1.8-arch1-3 |
| Machine | ThinkPad P14s Gen 2a |
| Ghostty | 1.3.1-arch2 |
| Foot | 1.27.0 |

Full `omarchy-debug` output omitted: this is an argument-order defect that reproduces from the source alone and is present on `master` (verified via `repos/basecamp/omarchy/contents/bin/omarchy-font-set` at time of filing), not just in the installed package. Happy to attach the log if useful.

Checked for duplicates before filing; nothing found in issues or PRs. Note that open PR #6958 modifies `bin/omarchy-font-set` for an unrelated reason and stubs `omarchy-notification-send` in its new test, but does not change these two lines.

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:29 UTC