yeaboi

Desktop App

yeaboi ships as a Mac app as well as a terminal app. It is the same product — the same engines, the same modes, the same data — running in a window. See the product page for the short version.

Requirements

  • macOS 12 Monterey or later, Apple silicon or Intel
  • About 330 MB of disk for the download, a little more once installed
  • No Python. The app carries its own — this is the difference between it and install.sh
  • An API key for at least one LLM provider, same as the CLI. The app asks on first launch.

Download

Two disk images, one per architecture. They differ only in the name, so take a moment over which:

  • Apple silicon — yeaboi.ai-arm64.dmg. Every Mac sold since November 2020.
  • Intel — yeaboi.ai-x64.dmg. Macs from 2020 and earlier.

If you are not sure, open Apple menu → About This Mac. A line reading Chip: Apple M1 (or M2, M3, M4…) means Apple silicon; one reading Processor: Intel means Intel. Installing the wrong one will not damage anything, but it will not open.

All downloads and release notes ↗

Install

  1. Open the .dmg.
  2. Drag yeaboi.ai onto the Applications shortcut in the same window.
  3. Eject the disk image and launch yeaboi.ai from Applications or Spotlight.

Releases are signed with an Apple Developer ID and notarized by Apple, so the app opens the ordinary way. You should not need to right-click → Open, visit Privacy & Security, or run xattr. If macOS does object, that is a problem with the release rather than with your machine — please open an issue rather than working around it.

What's inside

The app is an Electron shell over the same Python that runs in your terminal. The installer bundles two Python runtimes and starts them on loopback ports when the app opens; nothing is downloaded at install time and nothing is fetched on first run.

The practical consequence: it works offline, on a plane, behind a proxy, on a fresh machine with no developer tools. The trade is the download size.

Your data

The app reads and writes ~/.yeaboi/, exactly as the CLI does — the same session database, the same configuration, the same logs. A sprint plan you generated in the terminal opens in the app, and a retro you ran in the app shows up in yeaboi --resume.

Install both if you like. They are two front doors onto one set of files, and neither owns it.

Updating

The app checks for updates when you ask it to — from the menu-bar duck or the About panel — downloads in the background, and applies the update the next time you quit. It never updates itself without being asked.

Uninstalling

Drag yeaboi.ai from Applications to the Trash. That removes the app and the runtimes it carried. Your sessions and configuration live in ~/.yeaboi/ and are deliberately left alone — delete that directory too if you want everything gone.

Platform support

Two different questions, often confused:

  • The desktop app is macOS only for now. Windows and Linux builds exist in the release pipeline but are not published yet.
  • The terminal app runs on macOS and Linux. It does not run on native Windows and is not intended to: the terminal UI needs a POSIX terminal, so install.sh refuses to install there and points at WSL.

So on Windows and Linux today, yeaboi is the terminal app — see Getting Started.

The terminal app

Nothing here replaces it. The CLI remains the primary surface and the one the docs are written against; the app is a second way in for people who would rather not keep a terminal open. Install it with:

curl -LsSf https://yeaboi.ai/install.sh | sh

See Getting Started for setup, and the CLI Reference for every flag.