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 agent-cli-menu / acm commands:

brew install --cask roypadina/tap/agentclimenu

This:

• moves AgentCliMenu.app into /Applications,
• links agent-cli-menu and the short alias acm into your Homebrew bin,
• installs Node if you don't already have the Homebrew formula.

First launch (Gatekeeper)

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

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

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

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

From source

git clone https://github.com/roypadina/AgentCliMenu.git
cd AgentCliMenu
npm install
npm run build
npm link            # puts agent-cli-menu + acm on your PATH

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

Then seed a starter config:

agent-cli-menu config --setup

Upgrade

brew upgrade --cask agentclimenu

Uninstall

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

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