Core Helper


(Yang.Y) #1

In order to work with local shell, 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.

For Core Shell / Core Tunnel 1.6.6 or later, download Core Helper 4.0 Installer

For Core Shell / Core Tunnel 1.6.2 or earlier, download Core Helper 3.4 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 local shell nor 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 local shell, 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. Open local shell window / tab (Core Shell specific)
  2. Access authentication agent (e.g. ssh-agent, gpg-agent)
  3. Reuse of /etc/ssh_config and ~/.ssh/config
  4. Reuse of /etc/ssh/ssh_known_hosts and ~/.ssh/known_hosts
  5. 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
SSH Shell - seems to late to purchase but I did it. Missing ssh-agent option?
1.4.9, keeps crashing when pressing connect
After upgrade app keeps crashing and won't even open, also how can I not lose my configuration , which directory do i backup
Keep `Abnormal Disconnect` and reconnect frequently
Multiple jump with multiple keys
Core Helper 3.1 – Notarized
Issues when using proxy server to log in to production server