Installation

Installation

Requirements: Node 18+. Tested on macOS; Linux best-effort; Windows not supported. The Homebrew cask installs Node as a dependency.

Homebrew (recommended)

The cask installs the agentctl CLI:

brew install --cask roypadina/tap/agentctl

This:

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

Upgrading from 0.10 or older: brew upgrade --cask agentctl removes the old menu-bar app.

npm (macOS and Linux)

npm i -g @roypadina/agentctl

From source

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

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)