Install on macOS

Seggo for Mac works on Apple Silicon and Intel Macs. You don’t need administrator rights.

There are two ways to install it:

• The Mac app (recommended). Drag it to Applications and double-click it. No Terminal needed.
• With Terminal, if you want the seggo command on your PATH. See Install with Terminal below.

Install the app

1. Download Seggo-<version>-macos.dmg from the folder you were sent.
2. Double-click the downloaded file. A window opens with Seggo and an Applications folder.
3. Drag Seggo onto Applications.
4. Eject the disk image: click the eject button next to Seggo in the Finder sidebar.
5. Open your Applications folder and double-click Seggo.

The first time: Open Anyway

This pilot build isn’t signed by Apple yet, so the first time macOS stops you. It says Seggo “cannot be opened” or “Apple could not verify” it. That’s expected. Once only:

1. Click Done (or OK) on that message. Don’t move Seggo to the Bin.
2. Open System Settings (Apple menu) and choose Privacy & Security.
3. Scroll down to Security. Next to “Seggo was blocked to protect your Mac”, click Open Anyway, then confirm with your password or Touch ID.
4. Double-click Seggo in Applications again and choose Open.

Only do this for a download you got from the person who shared it with you.

What you’ll see

Seggo opens in its own Mac window, like any other app. It has a Dock icon, the usual menus (Seggo, Edit, View, Window, Help) and shortcuts. No browser tab is needed. The first time, the window starts on the short guided tour.

• Cmd+, opens Seggo’s Settings.
• Cmd+W closes the window but keeps Seggo running. Click Seggo in the Dock to bring it back.
• Cmd+Q quits Seggo.
• Links to other websites open in your usual browser. View > Open in Web Browser shows the page you’re on there too, if you prefer a browser tab.
• Files Seggo saves for you, such as a handoff or a feedback report, go to your Downloads folder.

Seggo’s icon (two crossing lines) also sits in the menu bar at the top right of your screen. Click it any time for:

• Open Seggo: brings the window back.
• A status line: which port Seggo runs on, or why it stopped.
• Show Log: what Seggo wrote while starting, for when something is wrong.
• Open in Web Browser: the same pages in your browser.
• Quit Seggo: stops Seggo. Open the app again to start it.

Good to know:

• The window shows Seggo’s pages from your own computer, at http://127.0.0.1:7420/. Nothing is reachable from other computers.
• If you open Seggo straight from the disk image, it asks you to move it to Applications first, so tools you connect keep working after you eject.
• It doesn’t start when you log in unless you turn that on in Seggo’s Settings.
• The app keeps its data in ~/Library/Application Support/Seggo/. If you already use the seggo command, it uses that same data instead.

Next: first run.

Install with Terminal

Choose this if you want the seggo command in your Terminal.

1. Download

Download seggo-<version>-macos-universal.tar.gz from the folder you were sent. Download SHA256SUMS too if you can, into the same folder.

2. Unpack

Double-click the .tar.gz file in Finder. It unpacks into a folder named seggo-<version>-macos-universal.

3. Run the installer

Open Terminal, type cd (with a space at the end), drag the unpacked folder onto the Terminal window, and press Return. Then run:

sh install.sh

The installer:

• checks the program against the SHA256SUMS file inside the folder;
• copies seggo to ~/.local/bin/seggo (set SEGGO_INSTALL_DIR to choose another folder);
• removes macOS’s download quarantine mark from the installed program only, because macOS refuses to run an unsigned program downloaded through a browser. It changes nothing else;
• if ~/.local/bin isn’t on your PATH, prints the line to add to ~/.zshrc and asks before adding it.

Then open a new Terminal window and check it worked:

seggo --version

It prints something like seggo 0.x.y (abc1234).

Install without unpacking

You can point the installer at the archive instead: sh install.sh --from ~/Downloads/seggo-<version>-macos-universal.tar.gz. If SHA256SUMS is next to the archive, the archive is checked against it.

If macOS blocks it

If seggo won’t run and macOS says it “cannot be opened because the developer cannot be verified” (or “Apple could not verify…”):

1. Open System Settings > Privacy & Security.
2. Scroll down to Security. There’s a line saying "seggo" was blocked to protect your Mac, with an Open Anyway button.
3. Click Open Anyway, confirm with your password or Touch ID, and run seggo --version again. Choose Open if asked once more.

4. Open Seggo

seggo open

This starts Seggo in the background if it isn’t running, then opens it in your browser at http://127.0.0.1:7420/. Seggo keeps running until you log out.

Next: first run.