Docs / Start here

Installation

Get CLI Launcher running on macOS, Linux, or Windows. Choose the one-line script, a native package, or a build from source.

Prerequisites

CLI Launcher itself is a desktop app and needs almost nothing extra. The agents it manages do have runtime requirements:

  • Node.js (LTS, e.g. v22) — required by the 18 Node-based agents.
  • Python (3.10+) — required by the 6 Python-based agents (Aider, Open Interpreter, and others).
  • Standalone agents (Goose, Cursor, Amazon Q, Plandex, Mods, aichat, Fabric, …) bundle their own runtimes.
You don't need the runtimes up front

CLI Launcher can install missing dependencies for you through its in-app dependency panel. Install the app first, then let it guide you.

One-line installer (recommended)

The script and PowerShell installers are mirrored at cli-launcher.veyl.in/install.sh and cli-launcher.veyl.in/install.ps1.

curl · macOS / Linux
curl -fsSL https://cli-launcher.veyl.in/install.sh | bash
wget · macOS / Linux
wget -qO- https://cli-launcher.veyl.in/install.sh | bash
PowerShell · Windows
powershell -ExecutionPolicy Bypass -c "irm https://cli-launcher.veyl.in/install.ps1 | iex"

Native packages

Prefer a graphical setup? Download the build for your platform from the Downloads page:

  • macOS — .dmg (Universal — runs on both Apple silicon and Intel)
  • Windows — .msi installer or portable .exe
  • Linux — .AppImage, .deb, .rpm, or .tar.gz

First launch

Releases are currently not code-signed, so your operating system will warn the first time you open the app. This is expected — just confirm the download came from the official releases page.

  • Windows — SmartScreen shows “Windows protected your PC”. Choose More info, then Run anyway.
  • macOS — Gatekeeper blocks the app on first open. Right-click (or Control-click) CLI Launcher in Applications, choose Open, then confirm. It opens normally after that.
  • Linux — no warning; remember to chmod +x the .AppImage (the one-line installer does this for you).

One consequence worth knowing: in-app updates do not work on macOS while the build is unsigned. Download new releases manually there. Windows and Linux update in place as normal.

Build from source

For the latest unreleased changes or to contribute:

git clone https://github.com/MadBlast0/Cli-launcher && cd Cli-launcher && npm install && npm run build

Verify the install

Launch CLI Launcher from your applications menu (or run it from the terminal). You should see the panel with the agent catalog. If the app doesn't open, see Troubleshooting.

Updating CLI Launcher

CLI Launcher checks for updates and can update itself in place. You can also re-run the installer — it upgrades an existing install without wiping your configuration.

Windows script restrictions

If PowerShell blocks the remote script, re-run it with -ExecutionPolicy Bypass as shown above.