Stib

English

Français

English

Français

Appearance

Desktop ​

Install the Stib desktop app for a native experience — a dedicated window, terminal integration, and OS notifications, without needing a browser tab.

The desktop app is a lightweight native client that wraps the Stib web interface. It connects to a running Stib server — it does not include the server itself.

Prerequisites ​

You need a running Stib server before using the desktop app. Install one using any method:

System Requirements ​

PlatformArchitectureMinimum Version
macOSARM64 (Apple Silicon) onlymacOS 11.0 (Big Sur)
Linuxx64, ARM64Any modern distribution
Windowsx64, x86, ARM64Windows 10+

WARNING

macOS Intel (x86_64) is not supported. There is no pre-compiled build for Intel-based Macs. Only Apple Silicon (M1/M2/M3/M4) is supported.

TIP

Not sure if you need the desktop app? See the Server Connection section for a comparison between the desktop app and the server binary.

Download ​

Download the latest release for your platform from the download page.

txt
stib_0.1.0_aarch64.dmg
txt
stib_0.1.0_x64-setup.exe    / stib_0.1.0_x64_en-US.msi
stib_0.1.0_x86-setup.exe    / stib_0.1.0_x86_en-US.msi
stib_0.1.0_arm64-setup.exe  / stib_0.1.0_arm64_en-US.msi
txt
stib_0.1.0_amd64.deb    / stib_0.1.0_amd64.AppImage
stib_0.1.0_arm64.deb    / stib_0.1.0_arm64.AppImage

Platform-native installers are available: .dmg for macOS, .msi / .exe for Windows, .deb / .AppImage for Linux.

macOS Installation ​

  1. Download stib_0.1.0_aarch64.dmg
  2. Open the DMG and drag stib to your Applications folder
  3. Launch the app from Applications

WARNING

On first launch, macOS Gatekeeper may block the app because it is not Apple-notarized yet. To allow it:

  • Right-click the app → Open, then click Open in the dialog
  • Or go to System Settings → Privacy & Security and click Open Anyway

INFO

Only ARM64 (Apple Silicon) is supported. There is no Intel/x86_64 build available.

Linux Installation ​

WARNING

The desktop app requires WebKit2GTK on Linux. Install it before proceeding:

bash
# Debian/Ubuntu
sudo apt-get install libwebkit2gtk-4.1-0

# Fedora
sudo dnf install webkit2gtk4.1

# Arch
sudo pacman -S webkit2gtk-4.1

Option 1 — .deb Package (Debian/Ubuntu) ​

bash
sudo dpkg -i stib_0.1.0_amd64.deb

Option 2 — AppImage (any distribution) ​

bash
chmod +x stib_0.1.0_amd64.AppImage
./stib_0.1.0_amd64.AppImage

INFO

For ARM64 systems, use the arm64 variants: stib_0.1.0_arm64.deb or stib_0.1.0_arm64.AppImage.

Windows Installation ​

  1. Download the installer for your architecture — stib_0.1.0_x64-setup.exe (most common), or the .msi variant
  2. Run the installer and follow the prompts

WARNING

On first launch, Windows SmartScreen may show a warning because the binary is not code-signed yet. Click More info → Run anyway to proceed.

INFO

Three architecture variants are available: x64 (most common), x86 (32-bit), and ARM64.

First Launch ​

On first launch, the app opens a native window displaying the Stib UI.

To connect to your Stib server:

  1. Open Settings (gear icon in the sidebar)
  2. Set the Backend URL to point to your running Stib server (default: http://localhost:50505)
  3. Or scan the QR code — in the web UI of your Stib server, go to Settings and click the QR code connection button. The desktop app can scan this code to auto-configure the backend URL.

Server Connection ​

The desktop app is a client — it connects to a Stib server but does not include one. The server can run:

  • Locally — on the same machine (e.g., http://localhost:50505)
  • Remotely — on another machine on your network (e.g., http://192.168.1.50:50505)

Which should I choose?

  • All-in-one experience — Use the server binary. It includes a system tray, embedded web UI, and runs everything in one process.
  • Dedicated native window with terminal integration — Use the desktop app + a separate server. The desktop app offers terminal integration (open sessions in iTerm, Warp, Kitty, etc.) and a dedicated window without browser overhead.

Desktop App Features ​

The desktop app provides features beyond what a browser tab offers:

  • Terminal integration — open terminal sessions in iTerm2, Warp, Kitty, and other terminal emulators directly from the app
  • Native OS notifications — receive system notifications for agent completions and other events
  • Dedicated window — no browser tabs, no address bar, focused workspace

INFO

The desktop app is a client and does not use server-side environment variables (STIB_ENCRYPTION_KEY, STIB_SERVER_ORIGIN, etc.). For server configuration, see the Configuration guide.

Verify Installation ​

  1. Launch the desktop app
  2. Confirm it connects to your Stib server (you should see the loading screen, then the main UI)
  3. Verify you can see your projects and boards
  4. Check the server health endpoint:
bash
curl http://localhost:50505/api/health
# Expected: {"status":"ok"}

TIP

If the app cannot connect, verify your server is running. Adjust the URL above if your server is remote.

Updating ​

  1. Download the new version from the download page
  2. Close the desktop app
  3. Install the new version (replace/reinstall)

TIP

Auto-update may be available in future versions.

Uninstalling ​

txt
Drag stib from Applications to the Trash, then empty the Trash.
txt
Via Settings → Apps → Installed apps → stib → Uninstall
Or via Control Panel → Programs → Uninstall a program
bash
sudo dpkg -r stib
bash
# Simply delete the AppImage file
rm stib_0.1.0_amd64.AppImage

Next Steps ​

TIP

Need to configure your server? Head to the Configuration guide for server-side settings like admin account setup, OIDC authentication, and environment variables.