hey

Manage emails, calendars, todos, and journals from the terminal via the HEY CLI.

101|21|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/basecamp/hey-cli --skill hey
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hey
Source: https://github.com/basecamp/hey-cli/tree/main/skills/hey
Command: npx skills add https://github.com/basecamp/hey-cli --skill hey

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Interacting with HEY email and productivity workflows from the command line reduces context switching and streamlines daily tasks like reading, replying, scheduling, and journaling.

Core Features & Use Cases

  • Read and send emails, manage mailboxes, calendars, todos, and journals directly from the terminal.
  • Filter, search, and organize content with a consistent CLI workflow, supporting scripted automation and JSON output for integration.
  • Use in scenarios ranging from personal email management to team collaboration, with secure authentication and offline scripting friendly.

Quick Start

Install the HEY CLI, run hey auth login to authenticate, then start managing mailboxes, emails, calendars, todos, and journals from your terminal.

Frequently Asked Questions about hey

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage HEY emails and calendars from the terminal?

You can manage HEY emails, calendars, todos, and journals from the terminal by installing the HEY CLI and authenticating with it. This allows you to read, send, and organize messages without leaving your command line environment.

What do I need to set up before using HEY CLI for email automation?

Before using HEY CLI for email automation, you need to install the HEY CLI tool and run the authentication command to log in. This setup provides secure access to your mailboxes, calendars, and journals for terminal-based workflows.

Can I get JSON output from HEY emails for scripted automation?

Yes, the HEY CLI supports JSON output, allowing you to extract structured data from your emails, journals, and calendars. This enables seamless integration into scripted automation and custom terminal-based productivity workflows.

Does the HEY CLI support managing todos and journals or just email?

The HEY CLI supports managing todos and journals in addition to email. You can handle mailboxes, topics, replies, drafts, and calendar entries, providing a comprehensive command-line interface for your HEY productivity suite.

Is there a way to automate reading and sending HEY emails without a GUI?

You can automate reading and sending HEY emails without a GUI by using the HEY CLI. It provides commands for boxes, topics, and drafts, supporting offline scripting and automated workflows directly from your terminal interface.