mrkeyoor.com_
Fri 16 Oct 18:51 UTC
Dev Toolsevaluationupdated 14 Oct 2026

flux review

Flux connects an Omarchy desktop with an Android phone, iPhone, or Mac for file sharing, clipboard exchange, notifications, and remote controls. Its daemon and command-line tools also let developers reach desktop workflows and coding-agent output from another device.

+6 / 1dstars / 7d
Verdict

Our Flux run passed 32 Go tests in 66 seconds after a successful 19-second install and 28-second build. It is worth trying on an Omarchy desktop with Android, where its CLI and phone controls match the intended environment. Choose another route if iPhone background delivery or broad Linux desktop support is essential, and check the reported discovery stall on your own devices.

We ran it

Lab card: what happened when we ran fluxScreenshot of flux (bjarneo.github.io/flux)
Install✓ · 19s14 packages
Build✓ · 28s
Tests✓ · 66s32 passed · 0 failed of 32 (go test)
Repo1165 files~173,557 lines of source · 10.2 MB · 4 CI workflows

Answers from our run

Does flux build from source?

Dependencies installed in 19 seconds (14 packages), and the build succeeded in 28 seconds. We cloned commit 938038c into a clean Debian container with 3 CPUs and no project-specific setup.

Do flux's tests pass?

Yes: 32 of 32 passed when we ran the project's own test command (go test). Some failures need services or credentials a bare container does not have.

Who should not use flux?

Linux users expecting a desktop-independent package: the documented target is Arch or Omarchy with Wayland and systemd user services, plus Qt and desktop runtime dependencies.

What are the alternatives to flux?

KDE Connect, LocalSend. Our Flux run passed 32 Go tests in 66 seconds after a successful 19-second install and 28-second build.

Setup3/5Go path passed, desktop needs Arch services and matching mobile apps
Docs5/5Detailed installation, platform limits, defaults, and pairing guides
Community3/5October release and push, with concrete current device reports
Maturity3/532 passing Go tests, device discovery and platform limits remain

Who it’s for

Arch and Omarchy users who want phone integration through a desktop daemon, Qt window, and scriptable CLI.
Android users willing to pair devices explicitly and configure which desktop features they can access.
Developers using herdr who want to read Claude Code, Codex, or opencode output from their phone.

Who it’s NOT for

Linux users expecting a desktop-independent package: the documented target is Arch or Omarchy with Wayland and systemd user services, plus Qt and desktop runtime dependencies.
iPhone users expecting Android parity: iOS cannot expose other apps' notifications, SMS, calls, or screen mirroring, and background suspension closes the link.
Users wanting an ordinary App Store installation on iPhone: the guide requires Xcode signing or a sideload tool, and release IPAs are unsigned.
Operators depending on uninterrupted discovery without troubleshooting: open issue 146 reports fluxd 0.17.0 stopped finding a visible phone until restart.
Users unwilling to share desktop clipboard contents or browseable home files with paired devices: both are enabled by default in the documented settings.

Setup reality

Our sandbox installed commit 938038c in 19 seconds, adding 14 packages. The build passed in 28 seconds. Go tests passed in 66 seconds: 32 passed, 0 failed. This was an unprivileged Debian run using the golang:1.24-bookworm image with 3 CPUs and 8 GB of RAM, without secrets.

A working desktop deployment needs the Arch or Omarchy environment documented by the project, including Qt, Wayland, D-Bus, systemd user services, Avahi, and PipeWire. Core device pairing needs matching apps and network access rather than an AI-provider key. Tailscale is an optional route away from the local network.

The current source guide requires Go 1.27.1 or newer, separately from our lab image label. Android is the supported phone route. iPhone installation needs Apple signing or sideloading, and iOS background limits affect notifications and clipboard delivery. A passing Go run does not verify these desktop and mobile paths.

Flux targets the Omarchy desktop, with Android the supported phone

Flux links your desktop and phone so a file, clipboard entry, or notification can move between them without another cloud inbox. Its README names Android as the supported phone app, alongside native iPhone and Mac applications with their own limits. The desktop includes a Go daemon and CLI, a Qt window, and an Omarchy shell plugin. This is worth considering when phone integration should reach your desktop workflow rather than end at sending a photograph.

Our 28-second build makes the repository look approachable, but the intended desktop matters more than that timing. The installation guide targets Arch or Omarchy with Wayland and systemd user services. Qt, Avahi, and PipeWire are among the named dependencies. A developer on that stack gets a documented route with package ownership and user setup. Someone on a different Linux desktop should compare the effort of adapting those assumptions with an existing device-integration package.

What happened when we ran it

Our run of commit 938038c installed 14 packages in 19 seconds, built successfully in 28 seconds, and passed its Go test step in 66 seconds. The supplied summary reports 32 passed tests and 0 failed. We used the golang:1.24-bookworm image in an unprivileged Debian sandbox with 3 CPUs and 8 GB of RAM, without secrets. There was no failed step in the measured path, so there is no failure log to explain.

The checkout contained 1,165 files, approximately 173,557 source lines, and occupied 10.2 MB. The scan found four CI workflow files, no Dockerfile, and no tests directory. The absence of that directory does not cancel the passing Go tests. The measured result establishes that this repository path worked in our sandbox. It does not establish file-transfer speed, camera latency, phone battery use, or reliable behavior across desktop sessions and mobile operating systems.

The documented desktop requires services beyond the Go build

The source installation guide currently specifies Go 1.27.1 or newer, which is distinct from our lab image label. It also names Qt Quick, SVG, and Wayland support, native build tools, clipboard utilities, and desktop services. We have no toolchain-selection log that explains the version difference, so we will not guess. Read the current source requirements when preparing a complete desktop build rather than assuming the sandbox image describes every component.

The 19-second install also does not include configuring a phone. Each desktop user runs the setup command after installing the package, and the diagnostics command checks the environment. A user-only installation omits the root approval helper and webcam system setup. That is a useful choice if file sharing and ordinary desktop integration cover the job. The full feature list comes with additional system integration, and the install method determines which pieces are available.

Pairing grants access to more than file transfers

The security guide documents certificate pinning after a verified pairing. It also states that automatic clipboard sync and browsing home-folder content are enabled by default. Dot-prefixed names and Flux folders are hidden from browsing, but that still leaves ordinary documents visible. A paired phone should therefore be your trusted device. File exchange is only one part of the access relationship, even if it is the feature that first attracts you.

Our 32 passing Go tests do not independently verify those defaults on a live desktop. Remote input, remote desktop, agent control, and phone-based approvals are documented as disabled initially. The security page explains which settings change each capability and which limits apply to a paired device. Keep the distinction between reading agent output and controlling an agent clear: enabling control lets the device interact with software that can run commands as your desktop user.

iPhone support cannot deliver Android's background features

The iOS guide says suspension closes Flux's link after it leaves the screen. That affects notifications, approval requests, and clipboard changes, while microphone streaming has a background exception. Other apps' notifications, SMS, calls, and screen mirroring are unavailable. These restrictions directly change the value of a phone companion. An iPhone that must stay open for a particular function is a different proposition from an always-available desktop bridge.

The 66-second Go test result supplies no evidence about iPhone delivery. Installation adds friction too: the release IPA is unsigned, and the guide describes Xcode signing or a sideload tool. On Android, the workflow is the project's supported phone path, but it still deserves a real-device trial. Check the specific interaction you need, such as clipboard exchange or agent notifications, rather than treating the presence of a native app as feature parity.

v0.17.0 has current discovery and touchpad reports

Issue 146 reports that fluxd v0.17.0 stopped discovering a phone even though Avahi still saw its broadcast. The reporter says restarting the daemon restored discovery. This is a concrete user report about the current daemon, not a result from our sandbox. Issue 148 separately reports that rotating Android into landscape makes the touchpad area nearly unusable. Either defect can matter more than a passing repository build for its respective workflow.

The last push was October 12, 2026, following the v0.17.0 release on October 11. GitHub listed 578 stars and 24 open issues and PRs, with new device reports in October. That shows active maintenance alongside unresolved usability problems. Try Flux if Omarchy integration and its scriptable controls earn the operating effort. Compare KDE Connect for another desktop integration route, or LocalSend when files are all you need. Let a successful pairing and your actual daily interaction decide whether Flux stays installed.

Alternatives

ProjectWhat it isPick it when
KDE ConnectA device integration project with file sharing, clipboard sync, and phone controls.pick this instead when you want integration with a Linux desktop beyond Omarchy and its shell plugin.
LocalSend gh↗A cross-platform application for transferring files over a local network.pick this instead when file transfer is the whole job and you do not need a persistent desktop-control connection.

What people are saying

  1. [hackernews] FLUX 3 Image
  2. [velocity-scout] bjarneo/flux

Sources

  1. Flux README
  2. Desktop install requirements
  3. iOS setup and limits
  4. Paired-device access and defaults
  5. Current discovery stall report
  6. Flux v0.17.0 release
  7. KDE Connect
  8. LocalSend

More dev tools reviews

compose-samples · librepods · sqlmap · coucou · world-execute-me-dsh-pv · mcp-extensions · the whole board →