Pangolin

Companion Mode on Mac: One Login for the App and CLI

On Windows and Linux, Pangolin CLI already shares a login and tunnel with the desktop app through companion mode. On Mac, the app and CLI were separate: you signed into each on its own, and the CLI ran its own tunnel. That made using them together awkward. You could be logged into one account in the menu bar app and a different account in the CLI, or have a different organization selected in each, so a command like pangolin ssh might hit the wrong account or org even though the desktop app looked correct. Keeping both in sync was something you had to do by hand.

Pangolin for macOS 0.14 and Pangolin CLI 0.23 fix this problem. Companion mode on Mac works the same way it does on the other desktop platforms: log in and connect in the app once, then use the CLI as that same account.

Why Companion Mode

Plenty of people keep the Mac client connected all day and still want the CLI for SSH, SCP, and other commands. Two logins meant two places to switch organizations or exit nodes, and two places that could drift out of sync. Companion mode puts the desktop app in charge of identity and the tunnel, so the CLI is just another way to use the connection you already have.

How It Works

Companion mode is on by default once both the Mac app (0.14.0 or later) and the CLI (0.23.0 or later) are installed.

  1. Log in with the Mac client and connect.
  2. Install Pangolin CLI if you need it: from the menu bar, choose More > Install Pangolin CLI…, or use the CLI install steps. The app installs the CLI to /usr/local/bin/pangolin.
  3. Run CLI commands in a terminal. For example:
pangolin ssh username@alias

The CLI follows the account, organization, and exit node selected in the desktop app. Change those in the app. While companion mode is on, pangolin login, pangolin logout, and pangolin select for account, organization, or exit node are blocked.

The desktop app has to be open and logged in. If it isn't, the CLI asks you to start Pangolin and log in. Check status or turn companion mode off with:

pangolin companion status
pangolin companion disable

Turn it back on later with pangolin companion enable. On machines without the desktop app, the CLI keeps its own login and can start its own tunnel as before.

Details are in the Mac companion mode and CLI companion mode docs. Update from Downloads or check for updates in the Mac app under More > Check for Updates….

Get notified of new releases

Follow the release feed in any RSS reader to see each new Pangolin release as soon as it is published.

About Pangolin

Pangolin is the open-source access platform that lets IT and security teams connect their workforce, AI agents, and infrastructure without the friction of legacy VPNs and stitched-together security tools. By unifying a zero-trust VPN, zero-trust reverse proxy, privileged access management, and an identity-aware AI gateway under one policy model, Pangolin helps organizations shrink their attack surface, contain stolen credentials, and pass audits with less work. Teams can roll it out one service at a time, self-hosted or on Pangolin Cloud, and verify exactly how their access is secured because every component is open source.

Ask AI about Pangolin

Ask Pangolin AI, which answers from this site and the docs, or your favorite AI assistant.

Get product updates and news.