Get started with Zestful

Install the macOS app and CLI with Homebrew:

brew tap caladriuslogic/zestful
brew install --cask zestful
brew install zestful-cli

Launch Zestful from Applications and sign in. Then test from your terminal:

zestful notify --agent test --message "Hello from Zestful"

You should see the floating overlay flash. Click it to jump back to your terminal.

No Homebrew? Manual install instructions

Add a hook so your agents notify you automatically. Here's Claude Code — paste this into .claude/settings.json:

{
  "hooks": {
    "Stop": [{
      "matcher": "",
      "hooks": [{
        "type": "command",
        "command": "zestful notify --agent \"claude-code:$(basename $PWD)\" --message 'Waiting for your input'"
      }]
    }],
    "UserPromptSubmit": [{
      "matcher": "",
      "hooks": [{
        "type": "command",
        "command": "zestful notify --agent \"claude-code:$(basename $PWD)\" --message 'Working...' --severity info --no-push"
      }]
    }]
  }
}

Now whenever Claude Code stops and waits for you, Zestful flashes the overlay and sends a push notification to your iPhone.