Install Seggo

Seggo installs in a couple of minutes. You don’t need an account or administrator rights.

What you need

• A Mac (Apple Silicon or Intel), or a Windows PC (experimental).
• The pilot package for your computer. The pilot is shared privately, so there’s no public link. To ask for access, email contact@bozomalabs.com and say whether you use a Mac or Windows.
• At least one AI tool you already use, such as Claude Code or Codex.

Which file to download

Computer	File
macOS (recommended)	Seggo-<version>-macos.dmg, the Mac app. Works on Apple Silicon and Intel.
macOS, with Terminal	seggo-<version>-macos-universal.tar.gz, if you want the seggo command.
Windows (experimental)	seggo-<version>-windows-x64.zip

For the Terminal and Windows packages, download SHA256SUMS too if it’s there, into the same folder. The installer uses it to check the files.

Windows is experimental

Windows support hasn’t been tested on a real PC yet. A Mac is the smoothest path for the pilot. If you try Windows and something goes wrong, please send feedback.

The steps in short

Mac app: double-click the .dmg, drag Seggo onto Applications, then double-click Seggo in Applications. It opens in its own Mac window. The first time, macOS asks you to click Open Anyway once.

Terminal or Windows:

1. Unpack the download.

2. Run the installer inside: sh install.sh on macOS, or double-click Install Seggo.cmd on Windows.

3. Open a new terminal window and run:

   seggo open

For the full steps, including what each warning looks like:

• Install on macOS
• Install on Windows

These builds aren’t signed yet

macOS and Windows warn about programs from developers they can’t identify. The install pages say what you’ll see and how to get past it. Only do this for a download you got from the person who shared it with you.

Where Seggo installs

	macOS	Windows
Program	/Applications/Seggo.app (Mac app), or ~/.local/bin/seggo (Terminal install)	%LOCALAPPDATA%\Programs\Seggo\seggo.exe
Data (handoffs, shared context and more)	~/Library/Application Support/Seggo/ (Mac app), or ~/.local/share/seggo/ (Terminal install, and the app too if that folder already exists)	%LOCALAPPDATA%\Seggo\
Optional settings file	~/.config/seggo/config.toml	%APPDATA%\Seggo\config.toml

seggo doctor prints these paths for your computer.