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

Screenshot editor doesn't close on Enter (tensaku-edit missing --early-exit)

Reported by mtaplits · filed Aug 23, 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

Screenshot editor doesn't close on Enter (tensaku-edit missing --early-exit)revision 1 · captured 2026-09-28 21:24 UTC via poll

Summary

Screenshot editor does not close on Enter in the default Omarchy screenshot flow. After taking a screenshot and opening the annotation editor, pressing Enter copies + saves the annotated image but the editor window stays open — it only closes with Escape. It reads as a "stuck" editor.

Steps to reproduce

  1. Run omarchy screenshot (default slurp mode) or the screenshot keybind.
  2. The notification "Screenshot saved to clipboard and file — Edit with Super + Alt + ," appears. Click it (or press Super + Alt + ,) to open the editor.
  3. Annotate (add an arrow/box/text, etc.).
  4. Press Enter (the natural "I'm done" gesture).

Actual: the image is copied to the clipboard and written to the screenshot file, but the editor window remains open. It does not close.

Expected: Enter closes the editor after saving, matching the previous system's satty editor behavior ("save and close on Enter").

Root cause

Omarchy's capture script defaults the editor to $OMARCHY_SCREENSHOT_EDITOR = tensaku-edit (see /usr/share/omarchy/bin/omarchy-capture-screenshot). The shipped /usr/bin/tensaku-edit wrapper (owned by the tensaku package) is invoked with only the image path, so it supplies the flags itself:

exec tensaku \
  --filename "$1" \
  --output-filename "$1" \
  --actions-on-enter save-to-clipboard \
  --save-after-copy \
  --copy-command wl-copy

Note: no `--early-exit`. In Tensaku, --early-exit is documented as "Exit directly after copy/save action." Without it, Enter copies + saves but deliberately keeps the editor open for continued annotation. This is a behavior mismatch with the satty editor that Omarchy previously used, which the wrapper's own header comment claims it is supposed to match.

Suggested fix

Add --early-exit to the tensaku wrapper so Enter closes the editor after copying/saving, e.g.:

exec tensaku \
  --filename "$1" \
  --output-filename "$1" \
  --actions-on-enter save-to-clipboard \
  --save-after-copy \
  --copy-command wl-copy \
  --early-exit

Since /usr/bin/tensaku-edit ships with the tensaku package, this either needs to be coordinated with the Tensaku maintainer or Omarchy should set $OMARCHY_SCREENSHOT_EDITOR to a wrapper it owns that adds --early-exit.

Notes / severity

  • Low severity. Nothing is lost today: the base screenshot is already saved to disk and the clipboard before the editor opens; the editor is optional annotation. Escape closes it.
  • This is a UX/behavior regression from the earlier satty editor, not a crash or data-loss bug.
  • omarchy debug is listed under omarchy --help in 4.0.0-1 but returns "Unknown Omarchy command" when run, so I couldn't attach a full debug log. Reproducing is straightforward.

Environment

  • Omarchy 4.0.0-1
  • tensaku 0.26.6-1
  • Session: Wayland / Hyprland
  • Default editor resolution: OMARCHY_SCREENSHOT_EDITOR unset → falls back to tensaku-edit
View raw text
### Summary

Screenshot editor does not close on Enter in the default Omarchy screenshot flow. After taking a screenshot and opening the annotation editor, pressing Enter copies + saves the annotated image but the editor window stays open — it only closes with Escape. It reads as a "stuck" editor.

### Steps to reproduce

1. Run `omarchy screenshot` (default `slurp` mode) or the screenshot keybind.
2. The notification "Screenshot saved to clipboard and file — Edit with Super + Alt + ," appears. Click it (or press `Super + Alt + ,`) to open the editor.
3. Annotate (add an arrow/box/text, etc.).
4. Press **Enter** (the natural "I'm done" gesture).

**Actual:** the image is copied to the clipboard and written to the screenshot file, but the editor window remains open. It does not close.

**Expected:** Enter closes the editor after saving, matching the previous system's satty editor behavior ("save and close on Enter").

### Root cause

Omarchy's capture script defaults the editor to `$OMARCHY_SCREENSHOT_EDITOR` = `tensaku-edit` (see `/usr/share/omarchy/bin/omarchy-capture-screenshot`). The shipped `/usr/bin/tensaku-edit` wrapper (owned by the `tensaku` package) is invoked with only the image path, so it supplies the flags itself:

```bash
exec tensaku \
  --filename "$1" \
  --output-filename "$1" \
  --actions-on-enter save-to-clipboard \
  --save-after-copy \
  --copy-command wl-copy
```

Note: **no `--early-exit`**. In Tensaku, `--early-exit` is documented as "Exit directly after copy/save action." Without it, Enter copies + saves but deliberately keeps the editor open for continued annotation. This is a behavior mismatch with the satty editor that Omarchy previously used, which the wrapper's own header comment claims it is supposed to match.

### Suggested fix

Add `--early-exit` to the tensaku wrapper so Enter closes the editor after copying/saving, e.g.:

```bash
exec tensaku \
  --filename "$1" \
  --output-filename "$1" \
  --actions-on-enter save-to-clipboard \
  --save-after-copy \
  --copy-command wl-copy \
  --early-exit
```

Since `/usr/bin/tensaku-edit` ships with the `tensaku` package, this either needs to be coordinated with the Tensaku maintainer or Omarchy should set `$OMARCHY_SCREENSHOT_EDITOR` to a wrapper it owns that adds `--early-exit`.

### Notes / severity

- **Low severity.** Nothing is lost today: the base screenshot is already saved to disk and the clipboard before the editor opens; the editor is optional annotation. Escape closes it.
- This is a UX/behavior regression from the earlier satty editor, not a crash or data-loss bug.
- `omarchy debug` is listed under `omarchy --help` in 4.0.0-1 but returns "Unknown Omarchy command" when run, so I couldn't attach a full debug log. Reproducing is straightforward.

### Environment

- Omarchy `4.0.0-1`
- tensaku `0.26.6-1`
- Session: Wayland / Hyprland
- Default editor resolution: `OMARCHY_SCREENSHOT_EDITOR` unset → falls back to `tensaku-edit`

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 08:25 UTC