Skip to content

Shuttle 1.0.0

Choose a tag to compare

View all tags
@nathandale nathandale released this 20 Feb 03:07
· 194 commits to master since this release
v1.0.0
3887397

Shuttle 1.0.0

A modern SSH address book for your macOS menu bar.

IMPORTANT — READ BEFORE INSTALLING

Shuttle is not signed with an Apple Developer certificate (that program costs $99/yr). macOS will block the app on first launch and may flag it as damaged or unverifiable. This does not mean the app is harmful. Follow the steps below and it will run fine.

Getting Past macOS Security (Gatekeeper & Sequoia)

Step 1 — Remove the quarantine flag

After unzipping, open Terminal and run this command before doing anything else:

```bash
xattr -cr /Applications/Shuttle.app
```

This strips the quarantine attribute macOS attaches to every file downloaded from the internet. It is the cleanest and most reliable fix — no repeated prompts, no loops.

Step 2 — First launch

Right-click Shuttle.app → Open. Do not double-click it. macOS will show a warning dialog with an Open button. Click it. You will only need to do this once.

Step 3 — If macOS says "Apple cannot verify" or "app is damaged"

This is Gatekeeper. Run the xattr command in Step 1 if you haven't already, then try right-click → Open again. If you still get a block:

  1. Go to System Settings → Privacy & Security
  2. Scroll down — you will see a message about Shuttle being blocked
  3. Click Open Anyway
  4. Enter your password if prompted

Step 4 — Sequoia "App Management" prompt

macOS Sequoia added a new permission called App Management that can appear when apps launch other applications (like your terminal). If you see a Privacy & Security alert about Shuttle being prevented from modifying other apps:

  1. Go to System Settings → Privacy & Security → App Management
  2. Find Shuttle in the list and toggle it on
  3. If the toggle turns itself back off — run the xattr command from Step 1, then toggle it on again. The quarantine flag causes this loop.

Installation

  1. Download Shuttle-1.0.0.zip below
  2. Unzip and drag Shuttle.app to your /Applications folder
  3. Open Terminal and run:
    ```bash
    xattr -cr /Applications/Shuttle.app
    ```
  4. Right-click Shuttle.app → Open
  5. Click Open in the warning dialog
  6. Shuttle appears in your menu bar

Requirements

  • macOS 12 Monterey or later (tested on Ventura and Sequoia)
  • Apple Silicon or Intel — Universal Binary

What's in this release

SSH Address Book

  • Store servers by name, hostname/IP/.local, user, port, SSH key, and category
  • Organized into user-defined categories in the menu bar
  • Config lives at ~/.shuttle.json — plain JSON, easy to back up or share

Manager Window (Settings → Manager…)

  • Native Contacts-style split view for adding, editing, and deleting servers
  • SSH key picker auto-populated from ~/.ssh/
  • Per-server terminal override

Multi-Terminal Support
Shuttle detects which terminals you have installed and only shows those. Supported: Terminal.app, iTerm2, Ghostty, Alacritty, kitty, Warp, Hyper, Rio.

LAN SSH Scanner

  • Scans your local /24 subnet for hosts with port 22 open
  • Bonjour/mDNS scan for _ssh._tcp. services — finds .local hostnames without an IP sweep
  • Reverse DNS on each discovered IP
  • Results sorted by last IP octet, merged and deduplicated
  • Connect or Save to Address Book… from each result

Import / Export

  • Import a .json config from anywhere (auto-backup before replacing)
  • Export your current config with a filename preset to shuttle.json

Configuration

Set your preferred terminal in ~/.shuttle.json:

{
  "terminal": "ghostty",
  "categories": ["LOCAL SERVERS", "REMOTE SERVERS"],
  "servers": []
}

Valid terminal values: terminal, iterm, ghostty, alacritty, kitty, warp, hyper, rio

Assets 3
Loading