Desktop App
B3IQ Companion is a lightweight tray app that installs, supervises, and shows status for the host agent, with quick serving and service controls.
B3IQ Companion is a lightweight desktop tray app, built with Tauri, that installs
and supervises the host agent and gives you quick status
at a glance. It does not replace the host agent or fork onboarding: it drives the
same service and the same host-agent-served setup wizard. The curl/irm
install scripts remain the supported headless, server, and
appliance path on every OS.
From the tray you can see runtime and model readiness, pause or resume serving, start, stop, or restart the service, and toggle Launch at Login.
Tray Actions
| Action | Effect |
|---|---|
| Show B3IQ Companion | Brings the Companion window to the front. |
| Open Command Panel | Opens the host-agent command panel — the node dashboard — in a window. |
| Runtimes / Models | Read-only status for installed runtimes and model readiness, reflecting what the host agent reports locally. |
| Pause / Resume serving | Stops or resumes accepting routed work without uninstalling the service or losing local owner state. |
| Start / Stop / Restart service | Controls the host-agent service through the OS service manager (launchd, Task Scheduler, or systemd). |
| Launch at Login | Toggles whether B3IQ Companion starts automatically when you sign in to the machine. |
| Open Coding Agent | Opens a local agent/workspace window for on-device assistant use. Network access is gated by explicit consent. |
macOS Install Flow
On macOS, B3IQ Companion runs a guided, reversible install of the host agent and provisions a runtime for you. The app self-updates through a signed updater.
Install B3IQ Companion
Download the signed, notarized DMG from b3iq.org and drag the app into
Applications. See Release trust for what is
signed today and what is still gated.
Run the guided host-agent install
The app installs and supervises the host-agent service through launchd. The install is reversible: you can uninstall the service from the app later.
Provision a runtime
The app provisions a runtime and walks you to the host-agent-served setup wizard to set local owner auth and choose Serve inference locally or Link to your account — claiming happens on the linked path.
Stay current
The signed updater applies new builds. Review the Updates page for how update state and rollback are surfaced.
Local Agent Workspace
B3IQ Companion can open a local agent/workspace window for on-device assistant
use. It talks to the local host agent at http://127.0.0.1:8831.
The agent workspace reaches the network only after you grant explicit consent. Local request content stays local unless you send it to a routed workflow. Keep local owner sessions and local API keys treated as powerful local credentials.
Availability
Availability is intentionally conservative, and tracks each platform's signing and verification gate. The public install scripts work on all three operating systems regardless of GUI status.
Signed and notarized DMG, available as a public pilot on b3iq.org. This is
the promoted desktop path on macOS today.
Authenticode-signed NSIS installer, available as a public pilot on b3iq.org.
This is the promoted desktop path on Windows today.
The Linux desktop package is gated on package trust and a desktop VM smoke. Linux stays script-only for now.
The macOS DMG and Windows NSIS installer are published as signed public pilots. Linux desktop packages remain gated on package trust and VM verification. See Release trust for the live gate status per platform.
Install One-Liners
If you are running headless, on a server, or on a platform where the desktop app is not yet available, use the public install scripts. They install the same host agent the desktop app supervises.
bashcurl -fsSL https://b3iq.org/install/macos | bash
powershellirm https://b3iq.org/install/windows.ps1 | iex
bashcurl -fsSL https://b3iq.org/install/linux | sudo bash
The desktop app and the scripts share one host-agent and one host-agent-served wizard. Choosing one does not change how your node is claimed, how it serves, or how it is paid.