Frequently Asked Questions

What is Zestful?

Zestful is a notification app for developers who work with AI coding agents. It alerts you when Claude Code, Cursor, Aider, or any agent needs your input — via a floating overlay on Mac, push notifications on iPhone, and a web dashboard.

How does it work?

Install the Mac app and add a one-line hook to your agent. When the agent pauses, Zestful flashes the overlay and sends a push to your phone. Click the alert to jump straight to the agent's terminal tab.

Which agents are supported?

Any agent that can run a shell command. We ship ready-made hooks for Claude Code, Cursor, Aider, GitHub Copilot CLI, OpenAI Codex CLI, and Cline. You can also wrap any command with zestful watch, or use zestful notify directly from any script or CI/CD pipeline.

Is it free?

Yes. The free tier includes the floating overlay, push notifications, and click-to-foreground — up to 25 push notifications per day. Pro ($2.99/month) removes the limit and adds notification history, analytics, and custom sounds.

Do you collect my code or terminal output?

No. The local Unix socket server runs entirely on your machine. Only the agent name, message, and severity are forwarded to deliver push notifications — and that data is not stored after delivery.

Does it work on Windows or Linux?

Not yet. macOS and iOS are supported today. Windows, Linux, and Android are on the roadmap.

How does click-to-foreground work?

Pass --app (and optionally --window-id or --tab-id) with zestful notify. When you click the alert, Zestful brings that app/tab to the front. Tab-level switching works with Kitty, iTerm2, WezTerm, and Terminal.app. Window-level focus works with any app via AppleScript.

What's the Teams plan?

Teams ($5/seat/month, minimum 5 seats) bundles Pro seats with SSO login, admin dashboard, team alert feed, response time analytics, and seat management. Enterprise ($9/seat/month, 100+ seats) adds dedicated support, SLA, security review, and invoice billing.

Can I use it without an account?

The Mac app's local notification overlay works without an account. You only need an account for push notifications to your iPhone and the web dashboard.

How do I cancel or get a refund?

Cancel anytime from your Stripe billing page or by emailing billing@zestful.dev. Full refund within 14 days for Pro, 30 days for Teams. See our Refund Policy for details.

Still have questions? Contact us