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

Clipboard manager cannot paste images into terminal apps: Shift+Insert is consumed as a text-only paste

Reported by cxj05h · filed Sep 6, 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

Clipboard manager cannot paste images into terminal apps: Shift+Insert is consumed as a text-only pasterevision 1 · captured 2026-09-28 21:23 UTC via poll

What happened

Selecting an image entry in the Omarchy clipboard manager and pressing Enter puts the image on the clipboard correctly, but nothing is pasted when the focused window is a terminal. The same action works in GUI/webapp windows.

What I expected

The selected image to be pasted into the focused application, the same way text entries are.

Root cause

bin/omarchy-clipboard-paste-file always finishes with a Shift+Insert keystroke:

wl-copy --type "$mime" < "$path"

if [[ $copy_only == "true" ]]; then
  exit
fi

sleep 0.15
wtype -M shift -k Insert -m shift 2>/dev/null || true

The wl-copy half is correct — the image really is on the clipboard, and wl-paste --list-types reports image/png with byte-identical content.

The problem is the keystroke. Terminal emulators bind Shift+Insert to their own text-only paste and consume it before the running application ever sees it. foot's default, for example:

clipboard-paste=Shift+Insert Control+Shift+v XF86Paste

So the sequence is: image goes on the clipboard with only an image/png flavor, Shift+Insert is delivered, foot intercepts it, foot looks for a text flavor to write to the tty, finds none, and nothing happens. No error, no feedback.

By contrast, Ctrl+V is not in foot's binding list, so it passes through to the running program. Terminal applications that support image paste (Claude Code, for instance) read the clipboard themselves on Ctrl+V and pick the image up fine. That is why pressing Ctrl+V manually works while the clipboard manager's own paste does not.

This also explains why GUI apps are unaffected: there Shift+Insert reaches the toolkit's paste handler, which honours non-text clipboard flavours.

bin/omarchy-clipboard-paste-text uses the same Shift+Insert keystroke, which is correct for text (and deliberately terminal-safe, since Ctrl+V is not paste in a terminal). The image path appears to have inherited it without adjustment.

Steps to reproduce

  1. Copy any image (e.g. omarchy capture screenshot).
  2. Focus a terminal running an application that accepts pasted images (Claude Code is an easy target).
  3. Open the clipboard manager (Super+Ctrl+V), select the image entry, press Enter.
  4. Nothing is pasted. The overlay closes and the terminal is unchanged.
  5. Press Ctrl+V manually instead — the image pastes, confirming it was on the clipboard the whole time.

Workaround

Use Shift+Enter in the clipboard manager (the --copy-only path), then press the application's own paste binding manually.

Suggested fix

For image entries, send Ctrl+V rather than Shift+Insert, or skip the synthetic keystroke entirely when the focused window is a terminal and let the user paste. An image can never be pasted into a terminal's text-paste path, so Shift+Insert has no valid case here.

Environment

  • Omarchy 4.0.2-1
  • Hyprland 0.56.2
  • foot 1.27.0-2, wtype 0.4-2, wl-clipboard 1:2.3.0-1
  • Reproduced with the stock omarchy.clipboard plugin, no local modifications

Still present on master as of filing — bin/omarchy-clipboard-paste-file is byte-identical to the installed copy.

View raw text
### What happened

Selecting an **image** entry in the Omarchy clipboard manager and pressing Enter puts the image on the clipboard correctly, but nothing is pasted when the focused window is a terminal. The same action works in GUI/webapp windows.

### What I expected

The selected image to be pasted into the focused application, the same way text entries are.

### Root cause

`bin/omarchy-clipboard-paste-file` always finishes with a `Shift+Insert` keystroke:

```bash
wl-copy --type "$mime" < "$path"

if [[ $copy_only == "true" ]]; then
  exit
fi

sleep 0.15
wtype -M shift -k Insert -m shift 2>/dev/null || true
```

The `wl-copy` half is correct — the image really is on the clipboard, and `wl-paste --list-types` reports `image/png` with byte-identical content.

The problem is the keystroke. Terminal emulators bind `Shift+Insert` to their own **text-only** paste and consume it before the running application ever sees it. foot's default, for example:

```ini
clipboard-paste=Shift+Insert Control+Shift+v XF86Paste
```

So the sequence is: image goes on the clipboard with only an `image/png` flavor, `Shift+Insert` is delivered, foot intercepts it, foot looks for a text flavor to write to the tty, finds none, and nothing happens. No error, no feedback.

By contrast, `Ctrl+V` is *not* in foot's binding list, so it passes through to the running program. Terminal applications that support image paste (Claude Code, for instance) read the clipboard themselves on `Ctrl+V` and pick the image up fine. That is why pressing `Ctrl+V` manually works while the clipboard manager's own paste does not.

This also explains why GUI apps are unaffected: there `Shift+Insert` reaches the toolkit's paste handler, which honours non-text clipboard flavours.

`bin/omarchy-clipboard-paste-text` uses the same `Shift+Insert` keystroke, which is correct for text (and deliberately terminal-safe, since `Ctrl+V` is not paste in a terminal). The image path appears to have inherited it without adjustment.

### Steps to reproduce

1. Copy any image (e.g. `omarchy capture screenshot`).
2. Focus a terminal running an application that accepts pasted images (Claude Code is an easy target).
3. Open the clipboard manager (`Super+Ctrl+V`), select the image entry, press Enter.
4. Nothing is pasted. The overlay closes and the terminal is unchanged.
5. Press `Ctrl+V` manually instead — the image pastes, confirming it was on the clipboard the whole time.

### Workaround

Use `Shift+Enter` in the clipboard manager (the `--copy-only` path), then press the application's own paste binding manually.

### Suggested fix

For image entries, send `Ctrl+V` rather than `Shift+Insert`, or skip the synthetic keystroke entirely when the focused window is a terminal and let the user paste. An image can never be pasted into a terminal's text-paste path, so `Shift+Insert` has no valid case here.

### Environment

- Omarchy 4.0.2-1
- Hyprland 0.56.2
- foot 1.27.0-2, wtype 0.4-2, wl-clipboard 1:2.3.0-1
- Reproduced with the stock `omarchy.clipboard` plugin, no local modifications

Still present on `master` as of filing — `bin/omarchy-clipboard-paste-file` is byte-identical to the installed copy.

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 11:00 UTC