Flux RouterDocumentation

Flux Desktop

Download one app. It detects your installed AI tools and points them at Flux. macOS first; Windows and Linux builds are available.

Flux Desktop is the one-click alternative to editing config files by hand. Download it, sign in, and it detects the AI tools you already have installed and rewrites their config to route through Flux. macOS is the most exercised platform today. Windows and Linux builds are available too, and Windows code-signing is still pending.

Download

Download Flux Desktop. The download page detects your operating system and hands you the right build: a macOS .dmg, a Windows .exe, or a Linux .AppImage.

First launch

Flux Desktop is signed but the trust paperwork is still landing, so your OS may show a one-time warning on first open. Clear it once and you're done:

  • macOS: right-click (or Control-click) the app and choose Open, then confirm. Gatekeeper may warn until notarization is enabled.
  • Windows: if SmartScreen appears, click More info, then Run anyway. SmartScreen may warn until signing validation completes.
  • Linux: make the AppImage executable with chmod +x before running it.

This is a temporary speed bump tied to code-signing, not a sign that anything is wrong with the build.

Three ways to connect

Pick the level of control you want. They all end at the same place: your tools pointed at Flux.

1. Desktop app (recommended)

The fastest path. Download Flux Desktop, sign in through your browser with one click, pick the tools you want from the detected list, and connect. Your Flux key is created during sign-in and stored in your OS keychain. You never paste a key by hand. This is the polished path and is best on macOS today.

2. The flux CLI (power users, CI, headless)

Flux Desktop ships a flux command-line tool for servers, CI, and headless Linux boxes where a GUI isn't ideal. The core commands:

bash
flux init      # detect tools, pick which to connect, install
flux status    # show what's connected
flux add       # connect a single tool
flux remove    # disconnect a single tool
flux reset     # restore every tool's original config
flux doctor    # diagnose connection and daemon health
flux key rotate

flux init detects your installed tools and lets you opt in per tool (nothing is selected by default). Unlike the desktop app, the CLI expects your Flux API key directly: it prompts for it, or reads FLUX_API_KEY when you pass --yes. Before it writes anything, it snapshots every config file it's about to touch so a failed install can be rolled back.

3. Raw manual config (no app at all)

If you don't want to install anything, you can make the same edits the app makes, by hand. See Connect your agent for the exact base URL, key and model settings for each agent.

Supported tools

Flux Desktop ships connectors for the tools below. Each connector rewrites only the relevant block of the tool's config file, preserves everything else (key order and comments included), and can restore the original byte for byte.

Editors and IDE assistants

  • Cursor
  • Zed
  • Cline
  • Continue
  • Roo Code
  • JetBrains
  • VS Code (GitHub Copilot)

CLI and agent tools

  • Claude Code
  • Codex CLI
  • aider
  • opencode
  • Crush
  • Goose
  • Droid
  • Qwen
  • Kimi
  • Hermes
  • Mistral Vibe
  • Pi

Generic

  • MCP (generic connector)

A few tools are recognized but not yet connectable and are deliberately hidden from the connect flow until their integration lands: Gemini CLI (its native wire format isn't routable through Flux yet), Wayland / AionUi, and OpenClaw. We don't claim support for tools we can't actually wire.

How routing works

Most tools route through a small local daemon that Flux Desktop installs and runs on 127.0.0.1:7878. The daemon is a dumb pass-through: it forwards your requests straight to api.fluxrouter.ai, and all the model selection happens server-side. The daemon must be running for non-Claude tools to work. If it's down, those tools can't reach Flux, so the installer refuses to wire a tool to a dead local port rather than break it.

Claude Code is the exception. It pins TLS, so its connector points it directly at https://api.fluxrouter.ai/anthropic instead of the local daemon. Claude Code keeps working whether or not the daemon is up.

Fully reversible

Every connector backs up the original config before it touches anything, and uninstall restores it byte for byte, checked by checksum. Disconnect a tool from the app, or run flux reset, and your config returns exactly to how it was before Flux touched it. Trying Flux Desktop is not a one-way door.

Platform support

macOS is the most exercised target today. Windows and Linux builds are produced and downloadable from the same download page. Windows code-signing validation is still in progress, which is why the first-launch SmartScreen note above applies. Upgrading is a re-download from the download page for now. In-app auto-update is not live yet.