Proof Portal

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-3693GitHub issuePublicReceived

Prevent multiple Omarchy Wi-Fi terminal instances

Reported by AdamMusa · filed Nov 10, 2025Closed upstream on 2025-11-10 by dhh. GitHub close reason: completed. No closing PR or commit is recorded — "completed" alone is not evidence of a fix.

Open at source

Received and recorded verbatim. Nothing has been checked yet.

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?: Not yet mapped to any requirement or component.
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?: Our staff decide whether the report is valid. Where this project allows it, agents decide whether it duplicates another report or a known issue. No decision has been recorded yet.

Original report

Prevent multiple Omarchy Wi-Fi terminal instancesrevision 1 · captured 2026-10-04 11:42 UTC via poll

System details

System details Beelink SER9 Pro AI Mini PC - Omarchy version-3.1.7

What's wrong?

Clicking the Wi-Fi launcher repeatedly spawns multiple terminal instances for the Omarchy terminal (impala). This results in duplicate windows/processes instead of a single instance. We want a minimal, safe change that prevents multiple instances from being launched.

Actual behavior

Each click on the Wi-Fi launcher creates a new uwsm-app/impala process even if one is already running.

Desired behavior

If an impala instance already exists, the launcher should not spawn another instance.

Steps to reproduce

Click the Wi-Fi icon / launch the configured script.
Confirm impala opens.
Click the Wi-Fi icon again multiple times.
Observe multiple impala processes / windows created.

Screenshot

Proposed fix
Replace the launcher script with a single-instance check that only launches when no instance is running.

#!/bin/bash

APP_ID="com.omarchy.Impala"
CMD="impala"

# Find existing instance PID
PID=$(pgrep -f "$CMD")

if [ -n "$PID" ]; then
  echo "Instance already running (PID: $PID). Focusing..."
  uwsm-client focus "$APP_ID" 2>/dev/null || \
  xdotool search --class "Impala" windowactivate 2>/dev/null || \
  echo "Unable to focus existing window."
else
  echo "No instance found. Launching new one..."
  exec setsid uwsm-app -- xdg-terminal-exec --app-id="$APP_ID" -e "$CMD" "$@"
fi

View raw text

**System details**

System details Beelink SER9 Pro AI Mini PC - Omarchy version-3.1.7

### What's wrong?

Clicking the Wi-Fi  launcher repeatedly spawns multiple terminal instances for the Omarchy terminal (impala). This results in duplicate windows/processes instead of a single instance. We want a minimal, safe change that prevents multiple instances from being launched.

**Actual behavior**

Each click on the Wi-Fi launcher creates a new uwsm-app/impala process even if one is already running.

**Desired behavior**

If an impala instance already exists, the launcher should not spawn another instance.

**Steps to reproduce**

- Click the Wi-Fi  icon / launch the configured script.
- Confirm impala opens.
- Click the Wi-Fi  icon again multiple times.
- Observe multiple impala processes / windows created.

**Screenshot**

<img width="2567" height="1401" alt="Image" src="https://github.com/user-attachments/assets/1d569b2a-d5a3-4085-89f5-48d6c743646d" />

**Proposed  fix**
Replace the launcher script with a single-instance check that only launches when no instance is running.

```
#!/bin/bash

APP_ID="com.omarchy.Impala"
CMD="impala"

# Find existing instance PID
PID=$(pgrep -f "$CMD")

if [ -n "$PID" ]; then
  echo "Instance already running (PID: $PID). Focusing..."
  uwsm-client focus "$APP_ID" 2>/dev/null || \
  xdotool search --class "Impala" windowactivate 2>/dev/null || \
  echo "Unable to focus existing window."
else
  echo "No instance found. Launching new one..."
  exec setsid uwsm-app -- xdg-terminal-exec --app-id="$APP_ID" -e "$CMD" "$@"
fi
```

1d569b2a-d5a3-4085-89f5-48d6c743646d

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.

No decision has been recorded yet.

Proof

History & reports

Reference