HeyAgent

Get notified when Claude Code and Codex CLI need your attention!

Installation

Install globally via npm:

npm install -g heyagent

Quick Start

1. Install the package globally
2. Run hey claude to start Claude Code with notifications
3. Or run hey codex to start OpenAI Codex CLI with notifications

Usage

Basic Commands

# Start Claude with notifications
hey claude

# Start Codex with notifications
hey codex

# Pass arguments to Claude/Codex
hey claude --help
hey claude -c    # Continue last session

# Configure notification settings
hey config

# Manage license for paid notification channels
hey license

# Toggle notifications
hey on           # Enable notifications
hey off          # Disable notifications

# Setup without starting Claude (hooks and slash commands)
hey setup claude

# Show help
hey help

Notification Methods

HeyAgent supports multiple notification methods:

• Desktop notifications (default)
• Email notifications*
• WhatsApp notifications*
• Telegram notifications*
• Slack notifications*
• Custom webhook notifications

Configure your preferred method with hey config.

*Pro notification channels require a license. Run hey license to set up.

Slash Commands (within Claude Code only)

While Claude is running, you can use:

/hey on          # Enable notifications
/hey off         # Disable notifications

How It Works

HeyAgent wraps your Claude Code or Codex CLI session:

• Claude Code: uses hooks and slash commands for event-driven notifications.
• Codex CLI: listens to stdout and sends a notification after inactivity.

Requirements

• Node.js 18.0.0 or higher
• Claude Code CLI or OpenAI Codex CLI installed
• Active Claude Code or OpenAI Codex CLI license
• HeyAgent license for paid notification channels

Support

• Documentation: https://heyagent.dev
• Issues: Report bugs and feature requests on GitHub

License

MIT License - see LICENSE file for details.