# hey

The skill connects the HEY CLI to the agent. Read mail, send replies, manage contacts, calendar, todos, time tracking and journal entries from the agent.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 263 installs · ★ 88 repo stars
- Author: basecamp
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/basecamp/skills/tree/HEAD/skills/hey/SKILL.md
- Updated: 2026-11-10
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/hey

## What it does

The skill wires the HEY CLI and lets the agent manage mailboxes, labels, collections, contacts, calendars, todo lists, time tracking and journal entries. The agent reads threads by `id` or `topic_id`, sends messages and drafts, moves threads between boxes, filters senders via the screener, and shares threads with public links.

You need the `hey` CLI installed and authorised via `hey auth login`. The skill uses stored credentials and refreshes tokens itself. If multiple HEY accounts are linked, commands accept `--account <id|all>`. Structured output goes through `--json` and `--jq`; HTML versions of messages and journal entries are printed via `--html` to a file or pipe only.

A send that fails with `not_delivered` is not retried: this prevents duplicates. Box mutation commands require explicit ID confirmation because HEY does not report when a given ID was not found.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add basecamp/skills --skill hey -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/hey/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/hey/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add basecamp/skills --skill hey -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/hey/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add basecamp/skills --skill hey -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/hey/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install basecamp/skills skills/hey
```

2. **Manually: put the files in place**
- File: `.github/skills/hey/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add basecamp/skills --skill hey -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/basecamp/skills --path skills/hey
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/hey/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add basecamp/skills --skill hey -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/basecamp/skills/tree/HEAD/skills/hey/SKILL.md

## When to use it
- read and send HEY mail from the agent
- filter senders and manage the screener queue
- create public share links for threads
- sync calendar, todos and time tracking
- move threads between boxes and apply labels

## Example prompts
- Show unread messages in the Imbox
- Send a message to `team@example.com` with subject "Quarterly sync" and body from `draft.txt`
- Find all mail from `client@domain.com` in the last month and move it to the Projects box

## Similar
- [use-spark](https://affpapa.org/en/nevibecode/skills/use-spark.md) — skill · 539 installs
- [spark-recipe-morning-standup](https://affpapa.org/en/nevibecode/skills/spark-recipe-morning-standup.md) — skill · 384 installs
- [daily-briefing](https://affpapa.org/en/nevibecode/skills/daily-briefing.md) — skill · 3400 installs
- [setup](https://affpapa.org/en/nevibecode/skills/anthropics-setup.md) — skill · 371 installs
- [outlook-automation](https://affpapa.org/en/nevibecode/skills/outlook-automation.md) — skill · 140 installs
- [triage-inbox](https://affpapa.org/en/nevibecode/skills/triage-inbox.md) — skill · ★ 1729 repo stars

From the same set: [basecamp/skills](https://affpapa.org/en/nevibecode/by/basecamp/skills.md) — 3 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
