Core Helper


(Yang.Y) #1

In order to work with authentication agent, system configurations and other advanced features, you must install Core Helper.

How to install?

  1. Download Core Helper Installer application using the link below.
  2. When the download is complete, launch Core Helper Installer by double-clicking it.
  3. After Core Helper has been installed, enable the features you want.

Download Core Helper 2.0 Installer

Why is this necessary?

The apps on the Mac App Store must be sandboxed, it means they can’t communicate with other apps so there is no way to access authentication agent (like ssh-agent) in the App Store version of Core Shell / Core Tunnel. We have introduced an optional Helper tool which makes Core Shell / Core Tunnel work with authentication agent (e.g. ssh-agent, gpg-agent), system configurations and other advanced features.

The first time you turn on one of those features, it will prompt you to download the Core Helper. The Core Helper only runs when you make a shell / tunnel connection.


It’s safe to uninstall the Core Helper, however, all features rely on it will be disabled after uninstallation.

To uninstall Core Helper, follow these steps:

  1. Open the Terminal application, type in launchctl unload ~/Library/LaunchAgents/ and press Enter to unload Core Helper.
  2. Run command rm -rf ~/Library/LaunchAgents/ to remove the plist file.
  3. Delete the app using command rm -rf ~/Library/Group\ Containers/

Features that require Core Helper

  1. Authentication agent (e.g. ssh-agent, gpg-agent)
  2. Reuse of /etc/ssh_config and ~/.ssh/config
  3. Reuse of /etc/ssh/ssh_known_hosts and ~/.ssh/known_hosts
  4. Set one of following ssh directives:
    • ProxyCommand
    • ProxyUseFdpass
    • UserKnownHostsFile
    • CertificateFile
    • IdentityAgent
    • IdentityFile
    • ControlMaster
    • ControlPath
    • ControlPersist
    • LocalCommand
    • PermitLocalCommand

SSH Agent Problem
Upgrade from 1.0 to App Store version
Core Tunnel 1.3 Release Notes
Permission Denied
Asked to install XPC Component again
CoreTunnel not connecting any more since update to Version1.3
Core Shell 1.2 Release Notes