Installation

Installation

Requirements: macOS 14 Sonoma or later, Apple Silicon or Intel (universal), and Claude Code installed. Usage numbers are shown for Pro and Max plans.

brew install --cask roypadina/tap/agents-session-hopper

This installs AgentsSessionHopper.app and links the sessionhopper command (it lives in AgentsSessionHopper.app/Contents/Helpers/).

First launch

The app is self-signed, not notarized. If macOS blocks it, open System Settings → Privacy & Security and click Open Anyway, or clear quarantine once (this also unblocks the CLI):

xattr -dr com.apple.quarantine /Applications/AgentsSessionHopper.app

On first launch a short guide explains what the app does and never does, and lists the Claude Code profiles it found. Turn on Launch at login in Settings → General if you want it always running.

Uninstall

sessionhopper uninstall-hooks --profile <name>   # only for profiles where you ran install-hooks
brew uninstall --zap --cask agents-session-hopper

Your Claude Code profiles and conversations are not touched.