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

omarchy-tailscale-receive ignores user-dirs.dirs and recreates ~/Downloads every login

Reported by vexlin · filed Sep 15, 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

omarchy-tailscale-receive ignores user-dirs.dirs and recreates ~/Downloads every loginrevision 1 · captured 2026-09-28 21:23 UTC via poll

System details

AMD Ryzen AI MAX+ 395 w/ Radeon 8060S, Omarchy 4.0.3-1

What's wrong?

omarchy-tailscale-receive ignores the downloads directory configured in ~/.config/user-dirs.dirs and recreates ~/Downloads at every login.

Steps to reproduce

  1. Set XDG_DOWNLOAD_DIR="$HOME/dl" in ~/.config/user-dirs.dirs (xdg-user-dir DOWNLOAD prints /home/user/dl).
  2. Delete ~/Downloads.
  3. Log out and back in, so omarchy-tailscale-receive.service starts with the graphical session.

Expected: the Taildrop staging directory is created at ~/dl/.omarchy-taildrop and received files land in ~/dl.

Actual: ~/Downloads/.omarchy-taildrop is created and ~/Downloads comes back every login.

Cause

bin/omarchy-tailscale-receive picks its directory from an environment variable only:

dir="${1:-${XDG_DOWNLOAD_DIR:-$HOME/Downloads}}"

XDG_DOWNLOAD_DIR is not a variable the session exports; it only exists as a line in user-dirs.dirs. The systemd user manager's environment (systemctl --user show-environment) does not contain it, so the service always takes the $HOME/Downloads fallback. The migration that enables the service (migrations/1785101000.sh) also hardcodes "Save incoming Taildrop files to ~/Downloads".

Suggested fix

Resolve the directory the same way the rest of the desktop does, e.g.

dir="${1:-$(xdg-user-dir DOWNLOAD)}"

with $HOME/Downloads only as a last resort if xdg-user-dir is unavailable. This is the same class of problem as #7733 / #8091 (provisioning recreating default XDG folders despite a customized user-dirs.dirs).

Workaround

A drop-in passes the directory explicitly and survives updates:

# ~/.config/systemd/user/omarchy-tailscale-receive.service.d/override.conf
[Service]
ExecStart=
ExecStart=/usr/bin/omarchy-tailscale-receive %h/dl
View raw text
### System details

AMD Ryzen AI MAX+ 395 w/ Radeon 8060S, Omarchy 4.0.3-1

### What's wrong?

`omarchy-tailscale-receive` ignores the downloads directory configured in `~/.config/user-dirs.dirs` and recreates `~/Downloads` at every login.

**Steps to reproduce**

1. Set `XDG_DOWNLOAD_DIR="$HOME/dl"` in `~/.config/user-dirs.dirs` (`xdg-user-dir DOWNLOAD` prints `/home/user/dl`).
2. Delete `~/Downloads`.
3. Log out and back in, so `omarchy-tailscale-receive.service` starts with the graphical session.

**Expected:** the Taildrop staging directory is created at `~/dl/.omarchy-taildrop` and received files land in `~/dl`.

**Actual:** `~/Downloads/.omarchy-taildrop` is created and `~/Downloads` comes back every login.

**Cause**

`bin/omarchy-tailscale-receive` picks its directory from an environment variable only:

```bash
dir="${1:-${XDG_DOWNLOAD_DIR:-$HOME/Downloads}}"
```

`XDG_DOWNLOAD_DIR` is not a variable the session exports; it only exists as a line in `user-dirs.dirs`. The systemd user manager's environment (`systemctl --user show-environment`) does not contain it, so the service always takes the `$HOME/Downloads` fallback. The migration that enables the service (`migrations/1785101000.sh`) also hardcodes "Save incoming Taildrop files to ~/Downloads".

**Suggested fix**

Resolve the directory the same way the rest of the desktop does, e.g.

```bash
dir="${1:-$(xdg-user-dir DOWNLOAD)}"
```

with `$HOME/Downloads` only as a last resort if `xdg-user-dir` is unavailable. This is the same class of problem as #7733 / #8091 (provisioning recreating default XDG folders despite a customized `user-dirs.dirs`).

**Workaround**

A drop-in passes the directory explicitly and survives updates:

```ini
# ~/.config/systemd/user/omarchy-tailscale-receive.service.d/override.conf
[Service]
ExecStart=
ExecStart=/usr/bin/omarchy-tailscale-receive %h/dl
```

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 13:47 UTC