Installation

Installation

Requires macOS 12+ and Node 18+. The terminal menu runs on Node; the Homebrew cask installs Node as a dependency.

Homebrew (recommended)

One cask installs both the menu-bar GUI app and the agentctl commands:

brew install --cask roypadina/tap/agentctl

This:

• moves Agentctl.app into /Applications,
• links the agentctl command into your Homebrew bin,
• installs Node if you don't already have the Homebrew formula.

First launch (Gatekeeper)

Agentctl is ad-hoc signed, not notarized, so macOS blocks the first launch. Either:

• right-click Agentctl in /Applications → Open → Open again, or
• clear the quarantine flag once:

xattr -dr com.apple.quarantine "/Applications/Agentctl.app"

See FAQ → Is it safe? for why it's not notarized.

From source

git clone https://github.com/roypadina/agentctl.git
cd agentctl
npm install
npm run build
npm link            # puts agentctl on your PATH

# optional: build the Mac GUI
bash gui/build-app.sh
open "gui/Agentctl.app"

Then seed a starter config:

agentctl config --setup

Upgrade

brew upgrade --cask agentctl

Uninstall

brew uninstall --cask agentctl     # if installed via Homebrew
# or: npm unlink -g agentctl       # if installed from source

rm -rf ~/.config/agentctl          # forget config (optional)