HeyAgent
Get instant notifications when Claude Code or Codex CLI needs your input
HeyAgent Overview
HeyAgent is an open-source, lightweight wrapper for AI coding agents like Claude Code, Codex CLI, and Gemini CLI, designed to enhance their functionality with practical features. It eliminates the need to constantly monitor your terminal by providing instant notifications when these agents require your input. HeyAgent supports various notification methods including email, Telegram, WhatsApp, Slack, webhooks, and native desktop notifications on macOS and Windows. Target users include developers, data scientists, and AI enthusiasts who use AI coding agents frequently and want to streamline their workflow by reducing the time spent waiting for or babysitting terminal sessions.
HeyAgent Screenshot
HeyAgent Official screenshot of the tool interface
HeyAgent Core Features
Instant Notifications
HeyAgent sends instant notifications via multiple channels (email, Telegram, WhatsApp, Slack, webhooks, and native desktop) when Claude Code, Codex CLI, or other AI agents are waiting for your input. This ensures you never miss a prompt or leave your terminal hanging.
Multi-Platform Support
The tool supports both macOS and Windows, providing native desktop notifications for seamless integration into your workflow. This cross-platform functionality ensures broad accessibility for developers using different operating systems.
Lightweight & Open Source
HeyAgent is open-source and lightweight, meaning it adds minimal overhead to your system while providing powerful features. Being open-source also allows for community contributions and customization to better suit individual needs.
Two-Way Chat (Coming Soon)
A soon-to-be-released feature will enable you to message Claude directly from your DMs, adding another layer of convenience and integration to your AI coding workflow.
Git Auto-Checkpoints (Coming Soon)
An upcoming feature will automatically create Git checkpoints during your coding sessions, ensuring you never lose progress and can easily revert changes if needed.
Whisper Voice Input (Coming Soon)
Future updates will include Whisper voice input, allowing you to interact with your AI coding agents using voice commands, further enhancing productivity and ease of use.
HeyAgent Use Cases
Developer Workflow Optimization
Developers using AI coding agents can integrate HeyAgent to receive notifications when their input is required, allowing them to switch between tasks without constantly monitoring the terminal. This significantly improves productivity and reduces downtime.
Remote Collaboration
Teams working remotely can use HeyAgent to stay updated on the status of AI coding sessions. Notifications via Slack or email ensure all team members are aware when input is needed, facilitating smoother collaboration.
Automated Coding Sessions
Data scientists and AI researchers running long, automated coding sessions can rely on HeyAgent to alert them when human intervention is required, ensuring no time is wasted waiting for prompts.
How to Use HeyAgent
Install HeyAgent globally using npm by running the command `npm i -g heyagent` in your terminal. This sets up the tool on your system for easy access.
Run the command `hey claude` or `hey codex` to start using HeyAgent with your preferred AI coding agent. This command initializes HeyAgent and begins monitoring your terminal sessions.
Configure your notification preferences by setting up email, Telegram, Slack, or other supported notification methods. This ensures you receive alerts in your preferred format when the AI agent requires input.
Continue your coding session as usual. HeyAgent runs in the background and automatically notifies you when Claude Code or Codex CLI stops and is waiting for your input, eliminating the need to constantly check your terminal.
Upgrade to the Pro version if you need additional features like email or Slack notifications, or explore the upcoming features like two-way chat and Git auto-checkpoints as they become available.