inboxzero

Files (1)

• SKILL.md

SKILL.md (first lines)

# InboxZero 📬

Autonomous email triage that actually works. Connect any email account (Gmail, Outlook, IMAP), set your rules in plain language, and let Paw handle the noise.

## When to Use

✅ **USE this skill when:**

- Getting 100+ emails a day and drowning
- Want newsletters auto-archived but accessible
- Need email sorted by urgency/importance
- Want draft replies written while you sleep
- Trying to maintain actual inbox zero
- Need better filtering than Gmail's basic rules
- Want email handled autonomously (not just filtered)
- Managing multiple email accounts

## When NOT to Use

❌ **DON'T use this skill when:**

- Sending bulk email / newsletters → use Mailchimp, SendGrid, etc.
- Email marketing campaigns → use dedicated ESP
- Transactional email generation → use platform APIs
- Email deliverability testing → use specialized tools
- Building email lists → use proper CRM tools
- Legal/compliance email archiving → use enterprise solutions

## Setup

Install InboxZero:

```bash
npm install -g @pawhub/inboxzero
```

Connect your email account:

```bash
# Gmail (via IMAP)
inboxzero add gmail \
  --email your.email@gmail.com \
  --app-password your-app-password

# Outlook / Office 365
inboxzero add outlook \
  --email your.email@outlook.com \
  --password your-password

# Generic IMAP
inboxzero add imap \
  --email you@example.com \
  --host imap.example.com \
  --port 993 \
  --user you@example.com \
  --password your-password

# Verify connection
inboxzero status
```

## Example Interactions

### Initial Setup

**You:** Set up email triage for me

**Paw:** *settles in for configuration*

Alright, let's make email bearable again. First question:

**What email account should I watch?**

---

**You:** my.work.email@company.com (Gmail)

**Paw:** Got it. Gmail IMAP. You'll need an app password (not your regular password).

[Generate one here](https://myaccount.google.com/apppasswords)

Once you have it, run:
```bash
inboxzero add gmail --email my.work.email@company.com --app-password YOUR_APP_PASSWORD
```

Then come back and we'll set up your triage rules. ✉️

---

**You:** Done. Now what?

**Paw:** *stretches and opens the rule configurator*

Perfect. Now let's teach me how to handle your inbox.

**Quick setup or custom rules?**

Quick setup = I make smart guesses based on patterns
Custom rules = you tell me exactly what to do

Most people start with quick setup, then tweak later. What sounds good?

---

**You:** Quick setup

**Paw:** *starts analyzing your inbox*

Scanning your last 500 emails to learn patterns...

*30 seconds later*

Okay, here's what I found:

**Newsletters (42% of volume):**
- Substack digests
- Marketing emails from vendors
- Automated reports

From Flexasaurusrex/OpenPaw, MIT.

More from Flexasaurusrex/OpenPaw