Quickstart — Desktop app

The buttons give you the latest release straight from GitHub. On a Mac it is a signed and notarised .dmg: open it, drag Libi into Applications, and launch it. On Windows it is an installer that sets Libi up for your user account — no administrator rights needed. Either way there is nothing else to install: the desktop build carries its own Node runtime.

Mac builds are Apple Silicon for now. The Windows build is not code-signed yet, so Windows shows a “Windows protected your PC” warning on first launch — choose More info, then Run anyway. Signing is on the way; until it lands, the npx route on Windows avoids the warning entirely. Linux builds are still to come.

Libi sets up its workspace and downloads ffmpeg and ffprobe, which it needs for any video at all. That takes a minute or two and shows its progress; every launch afterwards is fast. The rest arrives when you first need it: the adapter for your coding agent while you set it up, and the Chromium used for rendering the first time you export something that needs it.

It deliberately fails loudly. If part of the setup can't complete, Libi says what broke and stops, rather than starting a half-wired app that fails later on something unrelated.

The Agents page walks you through it in four steps: choose Claude Code or Codex, install it (Libi finds a CLI you already have, and downloads the adapter it needs to talk to it), sign in, and Open chat. The account is yours, and the model bill goes to whoever you already pay for it.

Anything that has to change on your machine — installing the CLI, signing in — happens in a terminal inside that step. Libi types the command and says what it will do; nothing runs until you press Enter. If you're already signed in, say so and skip ahead.

Under the last step, optionally, is how you use Libi from your own Claude Code or Codex app or terminal: Connect adds Libi's tools to your account, and once they read Connected you can install Libi's skills, for every folder or for one folder. See Bring your own CLI.

The desktop app keeps itself current. New versions download in the background, and Settings → General → Version & updates shows Restart to apply when one is ready. Most releases update only Libi's runtime; now and then the app itself changes, and that update arrives the same way.