Core Helper

:reminder_ribbon: Core Helper is not required for Core Shell (Setapp)

In order to work with local terminal, 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 it in Preferences:

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 terminal 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. X11 forwarding
  6. Set one of following ssh directives:
    • ProxyCommand
    • ProxyUseFdpass
    • UserKnownHostsFile
    • CertificateFile
    • IdentityAgent
    • IdentityFile
    • Include
    • ControlMaster
    • ControlPath
    • ControlPersist
    • LocalCommand
    • PermitLocalCommand
    • PKCS11Provider
    • SecurityKeyProvider
    • XAuthLocation
1 Like