inboxd 1.1.0 → 1.2.0

package/.claude/skills/inbox-assistant/SKILL.md

@@ -113,7 +113,7 @@ When a user has a heavy inbox (>20 unread emails), use this optimized workflow:
 ### 1. Quick Assessment
 
 ```bash
-inbox summary --json
+inboxd summary --json
 ```
 
 Identify which account(s) have the bulk of unread emails.
@@ -123,7 +123,7 @@ Identify which account(s) have the bulk of unread emails.
 For heavy inboxes, **always start with grouped analysis**:
 
 ```bash
-inbox analyze --count 100 --account <name> --group-by sender
+inboxd analyze --count 100 --account <name> --group-by sender
 ```
 
 This reveals:
@@ -163,7 +163,7 @@ Delete all LinkedIn job alerts and old newsletters?
 For cleanup of old emails, use server-side filtering:
 
 ```bash
-inbox analyze --older-than 30d --group-by sender
+inboxd analyze --older-than 30d --group-by sender
 ```
 
 Old emails (>30 days) are usually safe to batch delete:
@@ -198,15 +198,15 @@ Unread count?
 
 | Task | Command |
 |------|---------|
-| Check status | `inbox summary --json` |
-| Full triage | `inbox analyze --count 50` → classify → present |
-| Analyze by sender | `inbox analyze --count 50 --group-by sender` |
-| Find old emails | `inbox analyze --older-than 30d` |
-| Extract links from email | `inbox read --id <id> --links` |
-| Delete by ID | `inbox delete --ids "id1,id2" --confirm` |
-| Delete by sender | `inbox delete --sender "linkedin" --dry-run` → confirm → delete |
-| Delete by subject | `inbox delete --match "weekly digest" --dry-run` |
-| Undo deletion | `inbox restore --last N` |
+| Check status | `inboxd summary --json` |
+| Full triage | `inboxd analyze --count 50` → classify → present |
+| Analyze by sender | `inboxd analyze --count 50 --group-by sender` |
+| Find old emails | `inboxd analyze --older-than 30d` |
+| Extract links from email | `inboxd read --id <id> --links` |
+| Delete by ID | `inboxd delete --ids "id1,id2" --confirm` |
+| Delete by sender | `inboxd delete --sender "linkedin" --dry-run` → confirm → delete |
+| Delete by subject | `inboxd delete --match "weekly digest" --dry-run` |
+| Undo deletion | `inboxd restore --last N` |
 
 ## Package Information
 
@@ -214,7 +214,7 @@ Unread count?
 |---|---|
 | **Package** | `inboxd` |
 | **Install** | `npm install -g inboxd` |
-| **Setup** | `inbox setup` (interactive wizard) |
+| **Setup** | `inboxd setup` (interactive wizard) |
 | **Documentation** | https://github.com/dparedesi/inboxd |
 | **npm** | https://www.npmjs.com/package/inboxd |
 
@@ -224,10 +224,10 @@ Before any inbox operation, always verify the setup:
 
 ```bash
 # 1. Check if inboxd is installed
-inbox --version
+inboxd --version
 
 # 2. Check if accounts are configured
-inbox accounts
+inboxd accounts
 ```
 
 ## Account Management
@@ -235,24 +235,24 @@ inbox accounts
 ### Adding New Accounts
 If the user wants to add an account (e.g. "add my work email"):
 ```bash
-inbox auth -a <name>
-# Example: inbox auth -a work
+inboxd auth -a <name>
+# Example: inboxd auth -a work
 ```
 
 ### Listing Accounts
 ```bash
-inbox accounts
+inboxd accounts
 ```
 
 ### Removing Accounts
 ```bash
-inbox logout -a <name>    # Remove specific account
-inbox logout --all        # Remove all accounts
+inboxd logout -a <name>    # Remove specific account
+inboxd logout --all        # Remove all accounts
 ```
 
 ### Re-authenticating (Token Expired)
 ```bash
-rm ~/.config/inboxd/token-<account>.json && inbox auth -a <account>
+rm ~/.config/inboxd/token-<account>.json && inboxd auth -a <account>
 ```
 
 ### If Not Installed
@@ -264,7 +264,7 @@ rm ~/.config/inboxd/token-<account>.json && inbox auth -a <account>
 inboxd is not installed. To install:
 
 1. Run: npm install -g inboxd
-2. Run: inbox setup
+2. Run: inboxd setup
 3. Follow the wizard to configure your Gmail account
 
 The setup requires creating OAuth credentials in Google Cloud Console.
@@ -272,7 +272,7 @@ The setup requires creating OAuth credentials in Google Cloud Console.
 
 ### If No Accounts Configured
 ```
-No Gmail accounts configured. Run: inbox setup
+No Gmail accounts configured. Run: inboxd setup
 
 This will guide you through:
 1. Creating OAuth credentials in Google Cloud Console
@@ -284,9 +284,9 @@ This will guide you through:
 Users can enable automatic inbox checking with notifications:
 
 ```bash
-inbox install-service              # Check every 5 minutes
-inbox install-service --interval 10  # Check every 10 minutes
-inbox install-service --uninstall    # Remove service
+inboxd install-service              # Check every 5 minutes
+inboxd install-service --interval 10  # Check every 10 minutes
+inboxd install-service --uninstall    # Remove service
 ```
 
 This installs and starts a background service that:
@@ -304,43 +304,43 @@ This installs and starts a background service that:
 
 | Command | Description | Output |
 |---------|-------------|--------|
-| `inbox summary --json` | Quick inbox overview | `{accounts: [{name, email, unreadCount}], totalUnread}` |
-| `inbox analyze --count 50` | Get email data for analysis | JSON array of email objects |
-| `inbox analyze --count 50 --all` | Include read emails | JSON array (read + unread) |
-| `inbox analyze --since 7d` | Only emails from last 7 days | JSON array (filtered by date) |
-| `inbox analyze --older-than 30d` | Only emails older than 30 days | JSON array (server-side filtered) |
-| `inbox analyze --group-by sender` | Group emails by sender domain | `{groups: [{sender, count, emails}], totalCount}` |
-| `inbox read --id <id>` | Read full email content | Email headers + body |
-| `inbox read --id <id> --links` | Extract links from email | List of URLs with optional link text |
-| `inbox read --id <id> --links --json` | Extract links as JSON | `{id, subject, from, linkCount, links}` |
-| `inbox search -q "query"` | Search using Gmail query syntax | JSON array of matching emails |
-| `inbox accounts` | List configured accounts | Account names and emails |
+| `inboxd summary --json` | Quick inbox overview | `{accounts: [{name, email, unreadCount}], totalUnread}` |
+| `inboxd analyze --count 50` | Get email data for analysis | JSON array of email objects |
+| `inboxd analyze --count 50 --all` | Include read emails | JSON array (read + unread) |
+| `inboxd analyze --since 7d` | Only emails from last 7 days | JSON array (filtered by date) |
+| `inboxd analyze --older-than 30d` | Only emails older than 30 days | JSON array (server-side filtered) |
+| `inboxd analyze --group-by sender` | Group emails by sender domain | `{groups: [{sender, count, emails}], totalCount}` |
+| `inboxd read --id <id>` | Read full email content | Email headers + body |
+| `inboxd read --id <id> --links` | Extract links from email | List of URLs with optional link text |
+| `inboxd read --id <id> --links --json` | Extract links as JSON | `{id, subject, from, linkCount, links}` |
+| `inboxd search -q "query"` | Search using Gmail query syntax | JSON array of matching emails |
+| `inboxd accounts` | List configured accounts | Account names and emails |
 
 ### Actions
 
 | Command | Description |
 |---------|-------------|
-| `inbox delete --ids "id1,id2,id3" --confirm` | Move emails to trash by ID |
-| `inbox delete --sender "pattern" --dry-run` | Preview deletion by sender filter |
-| `inbox delete --match "pattern" --dry-run` | Preview deletion by subject filter |
-| `inbox delete --sender "X" --match "Y" --confirm` | Delete by combined filters (AND) |
-| `inbox delete --sender "X" --limit 100 --confirm` | Override 50-email safety limit |
-| `inbox delete --sender "ab" --force --confirm` | Override short-pattern warning |
-| `inbox restore --last N` | Restore last N deleted emails |
-| `inbox restore --ids "id1,id2"` | Restore specific emails |
-| `inbox mark-read --ids "id1,id2"` | Mark emails as read (remove UNREAD label) |
-| `inbox mark-unread --ids "id1,id2"` | Mark emails as unread (add UNREAD label) |
-| `inbox archive --ids "id1,id2" --confirm` | Archive emails (remove from inbox, keep in All Mail) |
-| `inbox unarchive --last N` | Undo last N archived emails |
-| `inbox unarchive --ids "id1,id2"` | Unarchive specific emails |
-| `inbox stats` | Show email activity dashboard (deletions, sent counts) |
-| `inbox stats --days 7 --json` | Get stats as JSON for custom period |
-| `inbox cleanup-suggest` | Get smart cleanup suggestions based on deletion patterns |
-| `inbox deletion-log` | View recent deletions |
-| `inbox deletion-log --json` | Get deletion log as JSON |
-| `inbox accounts --json` | List accounts as JSON |
-| `inbox delete --dry-run --json` | Preview deletion as structured JSON |
-| `inbox restore --json` | Get restore results as JSON |
+| `inboxd delete --ids "id1,id2,id3" --confirm` | Move emails to trash by ID |
+| `inboxd delete --sender "pattern" --dry-run` | Preview deletion by sender filter |
+| `inboxd delete --match "pattern" --dry-run` | Preview deletion by subject filter |
+| `inboxd delete --sender "X" --match "Y" --confirm` | Delete by combined filters (AND) |
+| `inboxd delete --sender "X" --limit 100 --confirm` | Override 50-email safety limit |
+| `inboxd delete --sender "ab" --force --confirm` | Override short-pattern warning |
+| `inboxd restore --last N` | Restore last N deleted emails |
+| `inboxd restore --ids "id1,id2"` | Restore specific emails |
+| `inboxd mark-read --ids "id1,id2"` | Mark emails as read (remove UNREAD label) |
+| `inboxd mark-unread --ids "id1,id2"` | Mark emails as unread (add UNREAD label) |
+| `inboxd archive --ids "id1,id2" --confirm` | Archive emails (remove from inbox, keep in All Mail) |
+| `inboxd unarchive --last N` | Undo last N archived emails |
+| `inboxd unarchive --ids "id1,id2"` | Unarchive specific emails |
+| `inboxd stats` | Show email activity dashboard (deletions, sent counts) |
+| `inboxd stats --days 7 --json` | Get stats as JSON for custom period |
+| `inboxd cleanup-suggest` | Get smart cleanup suggestions based on deletion patterns |
+| `inboxd deletion-log` | View recent deletions |
+| `inboxd deletion-log --json` | Get deletion log as JSON |
+| `inboxd accounts --json` | List accounts as JSON |
+| `inboxd delete --dry-run --json` | Preview deletion as structured JSON |
+| `inboxd restore --json` | Get restore results as JSON |
 
 ### Smart Filtering Options
 
@@ -405,7 +405,7 @@ You have 5 emails from LinkedIn. Delete them all?
 
 ### 1. Check Inbox Status
 ```bash
-inbox summary --json
+inboxd summary --json
 ```
 Report the total unread count and per-account breakdown.
 
@@ -443,7 +443,7 @@ Want me to triage that first?
 
 ### 3. Fetch Emails for Analysis
 ```bash
-inbox analyze --count 50 --account <name>
+inboxd analyze --count 50 --account <name>
 ```
 Parse the JSON output and classify each email.
 
@@ -545,7 +545,7 @@ Confirm deletion? (y/n)
 
 Only after explicit user confirmation:
 ```bash
-inbox delete --ids "id1,id2,id3,..." --account <name> --confirm
+inboxd delete --ids "id1,id2,id3,..." --account <name> --confirm
 ```
 
 ### 8. Confirm & Remind About Undo
@@ -554,7 +554,7 @@ After deletion:
 ```
 Deleted 8 emails.
 
-To undo: `inbox restore --last 8`
+To undo: `inboxd restore --last 8`
 ```
 
 ---
@@ -598,14 +598,14 @@ When user has job-related emails (LinkedIn, Indeed, recruiters) and wants to eva
 | "Delete all from [sender]" | Bulk sender cleanup | `--sender "X" --dry-run` → confirm → `--ids` |
 | "Delete [sender]'s emails" | Bulk sender cleanup | Two-step pattern with `--sender` filter |
 | "Delete the security emails" | Subject-based cleanup | `--match "security" --dry-run` → confirm → `--ids` |
-| "What senders have the most emails?" | Inbox analysis | `inbox analyze --group-by sender` |
-| "Show my email stats" | Activity summary | `inbox stats` |
-| "What should I clean up?" | Pattern analysis | `inbox cleanup-suggest` |
-| "What links are in this email?" | Extract URLs | `inbox read --id <id> --links` |
-| "Find my old emails" / "Clean up old stuff" | Stale email review | `inbox analyze --older-than 30d` |
+| "What senders have the most emails?" | Inbox analysis | `inboxd analyze --group-by sender` |
+| "Show my email stats" | Activity summary | `inboxd stats` |
+| "What should I clean up?" | Pattern analysis | `inboxd cleanup-suggest` |
+| "What links are in this email?" | Extract URLs | `inboxd read --id <id> --links` |
+| "Find my old emails" / "Clean up old stuff" | Stale email review | `inboxd analyze --older-than 30d` |
 | "I keep getting these" | Recurring annoyance | Suggest unsubscribe/filter, then delete batch |
 | "Check [specific account]" | Single-account focus | Skip other accounts entirely |
-| "Undo" / "Restore" | Recover deleted emails | `inbox restore --last N` |
+| "Undo" / "Restore" | Recover deleted emails | `inboxd restore --last N` |
 | "What are these companies?" | Research job/opportunity emails | Fetch websites, assess legitimacy |
 | "Research these job opportunities" | Job alert evaluation | Job Research workflow (see below) |
 
@@ -620,11 +620,11 @@ When user has job-related emails (LinkedIn, Indeed, recruiters) and wants to eva
 1. **NEVER auto-delete** - Always confirm before deletion, but adapt confirmation style to batch size
 2. **NEVER delete Action Required emails** - Surface them, let user decide
 3. **NEVER delete without --confirm flag** - Command will hang otherwise
-4. **Always remind about undo** - After every deletion, mention `inbox restore --last N`
+4. **Always remind about undo** - After every deletion, mention `inboxd restore --last N`
 
 ### State Change Safety
 5. **Confirm before mark-read** - Marking as read can hide important emails. Confirm batch operations (3+ emails)
-6. **Remind about mark-unread undo** - After mark-read, mention: "To undo: `inbox mark-unread --ids \"id1,id2\"`"
+6. **Remind about mark-unread undo** - After mark-read, mention: "To undo: `inboxd mark-unread --ids \"id1,id2\"`"
 7. **Confirm before archive** - Archiving removes emails from inbox view. Always use `--confirm` flag
 8. **Never batch mark-read silently** - Show what will be marked read before executing
 
@@ -636,9 +636,9 @@ When user has job-related emails (LinkedIn, Indeed, recruiters) and wants to eva
 ### Undo Commands Reference
 | Action | Undo Command |
 |--------|--------------|
-| Deleted emails | `inbox restore --last N` |
-| Marked as read | `inbox mark-unread --ids "id1,id2,..."` |
-| Archived | `inbox unarchive --last N` |
+| Deleted emails | `inboxd restore --last N` |
+| Marked as read | `inboxd mark-unread --ids "id1,id2,..."` |
+| Archived | `inboxd unarchive --last N` |
 
 ---
 
@@ -647,13 +647,13 @@ When user has job-related emails (LinkedIn, Indeed, recruiters) and wants to eva
 > [!IMPORTANT]
 > **ALWAYS use this pattern for filter-based deletions.** Filters are for DISCOVERY. IDs are for EXECUTION.
 
-This pattern prevents accidental mass deletion. When user says "delete LinkedIn emails", never run `inbox delete --sender "linkedin" --confirm` directly—it could delete hundreds of emails.
+This pattern prevents accidental mass deletion. When user says "delete LinkedIn emails", never run `inboxd delete --sender "linkedin" --confirm` directly—it could delete hundreds of emails.
 
 ### The Pattern
 
 1. **Discover** - Find what matches the filter
    ```bash
-   inbox delete --sender "linkedin" --dry-run
+   inboxd delete --sender "linkedin" --dry-run
    ```
    Output shows emails that would be deleted, plus IDs for programmatic use.
 
@@ -670,7 +670,7 @@ This pattern prevents accidental mass deletion. When user says "delete LinkedIn
 
 3. **Execute** - Delete with explicit IDs (from dry-run output)
    ```bash
-   inbox delete --ids "id1,id2,id3,id4,id5" --confirm
+   inboxd delete --ids "id1,id2,id3,id4,id5" --confirm
    ```
 
 ### When to Use Each Approach
@@ -694,20 +694,20 @@ This pattern prevents accidental mass deletion. When user says "delete LinkedIn
 
 ❌ **Bad agent behavior:**
 ```bash
-inbox delete --sender "linkedin" --confirm  # Deletes ALL LinkedIn emails!
+inboxd delete --sender "linkedin" --confirm  # Deletes ALL LinkedIn emails!
 ```
 
 ✅ **Good agent behavior:**
 ```bash
 # Step 1: Find LinkedIn emails
-inbox analyze --count 20
+inboxd analyze --count 20
 # Sees: 3 LinkedIn emails - job alert, connection request, message
 
 # Step 2: Identify the specific one by subject
 # (job alert has subject containing "jobs for you")
 
 # Step 3: Delete precisely
-inbox delete --ids "18e9abc" --confirm  # Just the job alert
+inboxd delete --ids "18e9abc" --confirm  # Just the job alert
 ```
 
 ### Ambiguity Handling
@@ -751,7 +751,7 @@ I've classified your emails. Here's the breakdown:
 - 8 LinkedIn alerts (deleted)
 - 27 remaining
 
-Done! To undo deletions: inbox restore --last 8
+Done! To undo deletions: inboxd restore --last 8
 ```
 
 **Good (plan-first approach):**
@@ -819,7 +819,7 @@ If the user encounters a bug, friction point, or suggests a feature:
 | Listing 50 emails individually | Overwhelming, wastes time | Summarize by category for large batches |
 | Suggesting deletion of "Re:" emails | Often important replies | Classify as Action Required |
 | Batching >20 emails without summary | Hard to verify what's being deleted | Show category breakdown |
-| Skipping pre-flight check | Tool may not be installed | Always run `inbox --version` first |
+| Skipping pre-flight check | Tool may not be installed | Always run `inboxd --version` first |
 | Forgetting `--account` flag | Ambiguity errors with multi-account | Always specify account |
 | Being passive after actions | User has to drive every step | Proactively suggest next step |
 | Executing mark-read on batch without confirmation | User loses unread status on important emails | Confirm 3+ emails, always mention undo |
@@ -845,10 +845,10 @@ If the user encounters a bug, friction point, or suggests a feature:
 
 | Problem | Solution |
 |---------|----------|
-| `command not found: inbox` | Run: `npm install -g inboxd` |
-| "No accounts configured" | Run: `inbox setup` |
-| Token expired / auth errors | Delete token and re-auth: `rm ~/.config/inboxd/token-<account>.json && inbox auth -a <account>` |
-| Permission errors on delete | Re-authenticate: `inbox logout -a <account> && inbox auth -a <account>` |
+| `command not found: inboxd` | Run: `npm install -g inboxd` |
+| "No accounts configured" | Run: `inboxd setup` |
+| Token expired / auth errors | Delete token and re-auth: `rm ~/.config/inboxd/token-<account>.json && inboxd auth -a <account>` |
+| Permission errors on delete | Re-authenticate: `inboxd logout -a <account> && inboxd auth -a <account>` |
 
 ---
 

package/CLAUDE.md

@@ -7,11 +7,11 @@ CLI tool for Gmail monitoring with multi-account support and macOS notifications
 ```bash
 npm test                    # Run tests
 npm run test:watch          # Watch mode
-inbox setup                 # First-time setup wizard
-inbox auth -a <name>        # Add account
-inbox summary               # Check all inboxes
-inbox check -q              # Background check
-inbox install-service       # Install background service (macOS/Linux)
+inboxd setup                 # First-time setup wizard
+inboxd auth -a <name>        # Add account
+inboxd summary               # Check all inboxes
+inboxd check -q              # Background check
+inboxd install-service       # Install background service (macOS/Linux)
 ```
 
 ## Architecture
@@ -68,13 +68,13 @@ All user data lives in `~/.config/inboxd/`:
 
 ## Key Behaviors
 
-- `inbox setup` guides first-time users through credentials and auth
-- `inbox check` marks emails as seen after notifying
-- `inbox delete` logs to `deletion-log.json` before trashing
-- `inbox restore` moves from Trash to Inbox, removes log entry
-- `inbox archive` logs to `archive-log.json` before archiving
-- `inbox unarchive` moves archived emails back to Inbox, removes log entry
-- `inbox send/reply` prompts for interactive confirmation (or use `--confirm` to skip)
+- `inboxd setup` guides first-time users through credentials and auth
+- `inboxd check` marks emails as seen after notifying
+- `inboxd delete` logs to `deletion-log.json` before trashing
+- `inboxd restore` moves from Trash to Inbox, removes log entry
+- `inboxd archive` logs to `archive-log.json` before archiving
+- `inboxd unarchive` moves archived emails back to Inbox, removes log entry
+- `inboxd send/reply` prompts for interactive confirmation (or use `--confirm` to skip)
 - `install-service` creates and enables launchd (macOS) or systemd (Linux) service
 
 ## OAuth Notes
@@ -121,11 +121,11 @@ Traditional CLIs are for humans. Agent-ready CLIs add:
 The skill can be installed globally for all Claude Code sessions:
 
 ```bash
-inbox install-skill      # Install to ~/.claude/skills/
-inbox install-skill --uninstall  # Remove
+inboxd install-skill      # Install to ~/.claude/skills/
+inboxd install-skill --uninstall  # Remove
 ```
 
-The `inbox setup` wizard also offers to install the skill automatically.
+The `inboxd setup` wizard also offers to install the skill automatically.
 
 ### Skill Location & Update Detection
 
@@ -136,7 +136,7 @@ The `inbox setup` wizard also offers to install the skill automatically.
 
 The skill uses content-hash detection (no version field). Updates are detected automatically:
 - On `npm install`: Auto-updates if skill already installed
-- Manual: Run `inbox install-skill` to update
+- Manual: Run `inboxd install-skill` to update
 
 Safety features:
 - `source: inboxd` marker identifies ownership (won't overwrite user's own skills)
@@ -159,31 +159,31 @@ scripts/postinstall.js    # npm postinstall hint about install-skill
 ### Key Commands for AI Use
 | Command | Purpose |
 |---------|---------|
-| `inbox summary --json` | Quick status check (unread counts) |
-| `inbox analyze --count 50` | Get email data as JSON for classification |
-| `inbox analyze --group-by sender` | Group emails by sender domain |
-| `inbox analyze --older-than 30d` | Find emails older than 30 days (server-side filtering) |
-| `inbox delete --ids "id1,id2" --confirm` | Delete specific emails by ID |
-| `inbox delete --sender "pattern" --dry-run` | Preview deletion by sender filter |
-| `inbox delete --match "pattern" --dry-run` | Preview deletion by subject filter |
-| `inbox restore --last N` | Undo last N deletions |
-| `inbox read --id <id>` | Read full email content |
-| `inbox read --id <id> --links` | Extract links from email |
-| `inbox search -q <query>` | Search using Gmail query syntax |
-| `inbox send -t <to> -s <subj> -b <body> --confirm` | Send email (requires --confirm) |
-| `inbox reply --id <id> -b <body> --confirm` | Reply to email (requires --confirm) |
-| `inbox mark-read --ids "id1,id2"` | Mark emails as read |
-| `inbox mark-unread --ids "id1,id2"` | Mark emails as unread (undo mark-read) |
-| `inbox archive --ids "id1,id2" --confirm` | Archive emails (remove from inbox) |
-| `inbox unarchive --last N` | Undo last N archives |
-| `inbox stats` | Show email activity dashboard (deletions, sent) |
-| `inbox stats --json` | Get stats as JSON |
-| `inbox cleanup-suggest` | Get smart cleanup suggestions based on patterns |
-| `inbox accounts --json` | List accounts as JSON |
-| `inbox deletion-log --json` | Get deletion log as JSON |
-| `inbox delete --dry-run --json` | Preview deletion as JSON |
-| `inbox install-skill` | Install/update the Claude Code skill |
-| `inbox install-service --uninstall` | Remove background service |
+| `inboxd summary --json` | Quick status check (unread counts) |
+| `inboxd analyze --count 50` | Get email data as JSON for classification |
+| `inboxd analyze --group-by sender` | Group emails by sender domain |
+| `inboxd analyze --older-than 30d` | Find emails older than 30 days (server-side filtering) |
+| `inboxd delete --ids "id1,id2" --confirm` | Delete specific emails by ID |
+| `inboxd delete --sender "pattern" --dry-run` | Preview deletion by sender filter |
+| `inboxd delete --match "pattern" --dry-run` | Preview deletion by subject filter |
+| `inboxd restore --last N` | Undo last N deletions |
+| `inboxd read --id <id>` | Read full email content |
+| `inboxd read --id <id> --links` | Extract links from email |
+| `inboxd search -q <query>` | Search using Gmail query syntax |
+| `inboxd send -t <to> -s <subj> -b <body> --confirm` | Send email (requires --confirm) |
+| `inboxd reply --id <id> -b <body> --confirm` | Reply to email (requires --confirm) |
+| `inboxd mark-read --ids "id1,id2"` | Mark emails as read |
+| `inboxd mark-unread --ids "id1,id2"` | Mark emails as unread (undo mark-read) |
+| `inboxd archive --ids "id1,id2" --confirm` | Archive emails (remove from inbox) |
+| `inboxd unarchive --last N` | Undo last N archives |
+| `inboxd stats` | Show email activity dashboard (deletions, sent) |
+| `inboxd stats --json` | Get stats as JSON |
+| `inboxd cleanup-suggest` | Get smart cleanup suggestions based on patterns |
+| `inboxd accounts --json` | List accounts as JSON |
+| `inboxd deletion-log --json` | Get deletion log as JSON |
+| `inboxd delete --dry-run --json` | Preview deletion as JSON |
+| `inboxd install-skill` | Install/update the Claude Code skill |
+| `inboxd install-service --uninstall` | Remove background service |
 
 ### Smart Filtering Options
 | Option | Description |

package/README.md

@@ -30,7 +30,7 @@ npm install -g inboxd
 Run the interactive setup wizard:
 
 ```bash
-inbox setup
+inboxd setup
 ```
 
 The wizard will guide you through:
@@ -60,33 +60,33 @@ mv ~/Downloads/client_secret_*.json ~/.config/inboxd/credentials.json
 ### 2. Authenticate
 
 ```bash
-inbox auth --account personal
+inboxd auth --account personal
 ```
 
 ### 3. Check Your Inbox
 
 ```bash
-inbox summary
+inboxd summary
 ```
 
 ## Commands
 
 | Command | Description |
 |---------|-------------|
-| `inbox setup` | Interactive setup wizard |
-| `inbox auth -a <name>` | Authenticate a Gmail account |
-| `inbox accounts` | List configured accounts |
-| `inbox summary` | Show inbox summary for all accounts |
-| `inbox check` | Check for new emails + send notifications |
-| `inbox check -q` | Silent check (for background use) |
-| `inbox delete --ids <ids>` | Move emails to trash |
-| `inbox delete --sender <pattern>` | Delete by sender (with confirmation) |
-| `inbox delete --match <pattern>` | Delete by subject (with confirmation) |
-| `inbox restore --last 1` | Restore last deleted email |
-| `inbox deletion-log` | View deletion history |
-| `inbox logout --all` | Remove all accounts |
-| `inbox install-service` | Install background monitoring (macOS) |
-| `inbox install-skill` | Install Claude Code skill for AI agents |
+| `inboxd setup` | Interactive setup wizard |
+| `inboxd auth -a <name>` | Authenticate a Gmail account |
+| `inboxd accounts` | List configured accounts |
+| `inboxd summary` | Show inboxd summary for all accounts |
+| `inboxd check` | Check for new emails + send notifications |
+| `inboxd check -q` | Silent check (for background use) |
+| `inboxd delete --ids <ids>` | Move emails to trash |
+| `inboxd delete --sender <pattern>` | Delete by sender (with confirmation) |
+| `inboxd delete --match <pattern>` | Delete by subject (with confirmation) |
+| `inboxd restore --last 1` | Restore last deleted email |
+| `inboxd deletion-log` | View deletion history |
+| `inboxd logout --all` | Remove all accounts |
+| `inboxd install-service` | Install background monitoring (macOS) |
+| `inboxd install-skill` | Install Claude Code skill for AI agents |
 
 ## Configuration
 
@@ -106,10 +106,10 @@ Install as a macOS launchd service to check for new emails periodically:
 
 ```bash
 # Install and start with default 5-minute interval
-inbox install-service
+inboxd install-service
 
 # Or customize the interval
-inbox install-service --interval 10
+inboxd install-service --interval 10
 ```
 
 The service starts automatically after installation. Manage it with:
@@ -127,7 +127,7 @@ launchctl unload ~/Library/LaunchAgents/com.danielparedes.inboxd.plist
 
 **Note:** `install-service` is macOS-only. For Linux, use cron:
 ```bash
-*/5 * * * * /path/to/node /path/to/inbox check --quiet
+*/5 * * * * /path/to/node /path/to/inboxd check --quiet
 ```
 
 ## JSON Output
@@ -135,13 +135,13 @@ launchctl unload ~/Library/LaunchAgents/com.danielparedes.inboxd.plist
 For AI agent integration, use the `--json` flag:
 
 ```bash
-inbox summary --json
+inboxd summary --json
 ```
 
 Or use the `analyze` command for structured output:
 
 ```bash
-inbox analyze --count 20
+inboxd analyze --count 20
 ```
 
 ## AI Agent Integration
@@ -163,12 +163,12 @@ This package includes a **skill** that can be installed globally, enabling any C
 After installing inboxd, run:
 
 ```bash
-inbox install-skill
+inboxd install-skill
 ```
 
 This copies the inbox-assistant skill to `~/.claude/skills/`, making it available in all your Claude Code sessions.
 
-The setup wizard (`inbox setup`) also offers to install the skill automatically.
+The setup wizard (`inboxd setup`) also offers to install the skill automatically.
 
 ### What the Skill Enables
 
@@ -194,13 +194,13 @@ The skill auto-updates when you update inboxd (if already installed). You can al
 
 ```bash
 npm update -g inboxd
-inbox install-skill
+inboxd install-skill
 ```
 
 Safety features:
 - Won't overwrite skills not created by inboxd (uses `source: inboxd` marker)
 - Creates `SKILL.md.backup` before replacing if you've modified the skill
-- Use `inbox install-skill --force` to override ownership check
+- Use `inboxd install-skill --force` to override ownership check
 
 ### CLI vs MCP
 
@@ -208,9 +208,9 @@ Unlike an MCP server that exposes raw Gmail API primitives, `inboxd` provides **
 
 | inboxd CLI | Raw Gmail MCP |
 |------------|---------------|
-| `inbox delete` logs before trashing | Just trashes |
-| `inbox restore` removes from log | Just untrashes |
-| `inbox analyze` formats for AI consumption | Raw API response |
+| `inboxd delete` logs before trashing | Just trashes |
+| `inboxd restore` removes from log | Just untrashes |
+| `inboxd analyze` formats for AI consumption | Raw API response |
 
 The skill layer adds expert workflow guidance on top of these commands.
 
@@ -225,7 +225,7 @@ npm uninstall -g inboxd
 To also remove all account data and tokens:
 
 ```bash
-inbox logout --all
+inboxd logout --all
 ```
 
 To completely remove all data including credentials:
@@ -239,13 +239,13 @@ rm -rf ~/.config/inboxd
 ## Troubleshooting
 
 **"credentials.json not found"**
-Run `inbox setup` or manually download OAuth credentials from Google Cloud Console and save to `~/.config/inboxd/credentials.json`.
+Run `inboxd setup` or manually download OAuth credentials from Google Cloud Console and save to `~/.config/inboxd/credentials.json`.
 
 **"Token expired"**
 Delete the token file and re-authenticate:
 ```bash
 rm ~/.config/inboxd/token-<account>.json
-inbox auth -a <account>
+inboxd auth -a <account>
 ```
 
 **No notifications appearing**

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "inboxd",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "CLI assistant for Gmail monitoring with multi-account support and AI-ready JSON output",
   "main": "src/cli.js",
   "bin": {
-    "inbox": "src/cli.js"
+    "inboxd": "src/cli.js"
   },
   "repository": {
     "type": "git",
@@ -21,7 +21,7 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "eslint src tests",
-    "inbox": "node src/cli.js",
+    "inboxd": "node src/cli.js",
     "postinstall": "node scripts/postinstall.js || true"
   },
   "keywords": [

package/scripts/postinstall.js

@@ -21,10 +21,10 @@ function showInstallHint() {
 │  inboxd installed successfully!                             │
 │                                                             │
 │  Quick start:                                               │
-│    inbox setup              # First-time configuration      │
+│    inboxd setup             # First-time configuration      │
 │                                                             │
 │  AI Agent Integration:                                      │
-│    inbox install-skill      # Enable Claude Code skill      │
+│    inboxd install-skill     # Enable Claude Code skill      │
 │                                                             │
 │  This lets AI agents manage your inbox with expert triage.  │
 │                                                             │
@@ -50,7 +50,7 @@ function handleSkillUpdate() {
       // Someone else's skill with same name → don't touch, warn
       console.log(`\n⚠️  ~/.claude/skills/inbox-assistant exists but isn't from inboxd`);
       console.log(`   The existing skill has source: "${status.source || 'none'}"`);
-      console.log(`   Run 'inbox install-skill --force' to replace it\n`);
+      console.log(`   Run 'inboxd install-skill --force' to replace it\n`);
       return;
     }
 
@@ -69,13 +69,13 @@ function handleSkillUpdate() {
         }
       } else if (result.reason === 'backup_failed') {
         console.log(`\n⚠️  Could not backup existing skill - update skipped`);
-        console.log(`   Run 'inbox install-skill' manually to update\n`);
+        console.log(`   Run 'inboxd install-skill' manually to update\n`);
       }
     }
     // Up-to-date → silent (no message)
   } catch (err) {
     // Fail silently - postinstall should not break npm install
-    // User can always run 'inbox install-skill' manually
+    // User can always run 'inboxd install-skill' manually
   }
 }
 

package/src/cli.js

@@ -128,7 +128,7 @@ async function main() {
   updateNotifier({ pkg }).notify();
 
   program
-    .name('inbox')
+    .name('inboxd')
     .description('Gmail monitoring CLI with multi-account support')
     .version(pkg.version);
 
@@ -167,7 +167,7 @@ async function main() {
             console.log('');
             const answer = await prompt(rl, chalk.white('Do you want to add another account? (y/N): '));
             if (answer.toLowerCase() !== 'y' && answer.toLowerCase() !== 'yes') {
-              console.log(chalk.gray('\nSetup cancelled. Run "inbox summary" to check your inbox.\n'));
+              console.log(chalk.gray('\nSetup cancelled. Run "inboxd summary" to check your inbox.\n'));
               rl.close();
               return;
             }
@@ -192,7 +192,7 @@ async function main() {
               addAccount(accountName, email);
               console.log(chalk.green(`\n   ✓ Authenticated as ${email}\n`));
             }
-            console.log(chalk.bold.green('🎉 Setup complete! Try: inbox summary\n'));
+            console.log(chalk.bold.green('🎉 Setup complete! Try: inboxd summary\n'));
             return;
           }
         }
@@ -291,10 +291,10 @@ async function main() {
         // Success
         console.log(chalk.bold.green('🎉 You\'re all set!\n'));
         console.log(chalk.white('   Try these commands:'));
-        console.log(chalk.cyan('     inbox summary') + chalk.gray('        - View your inbox'));
-        console.log(chalk.cyan('     inbox check') + chalk.gray('          - Check for new emails'));
-        console.log(chalk.cyan('     inbox auth -a work') + chalk.gray('   - Add another account'));
-        console.log(chalk.cyan('     inbox install-service') + chalk.gray(' - Enable background monitoring'));
+        console.log(chalk.cyan('     inboxd summary') + chalk.gray('        - View your inbox'));
+        console.log(chalk.cyan('     inboxd check') + chalk.gray('          - Check for new emails'));
+        console.log(chalk.cyan('     inboxd auth -a work') + chalk.gray('   - Add another account'));
+        console.log(chalk.cyan('     inboxd install-service') + chalk.gray(' - Enable background monitoring'));
         console.log('');
 
         // Offer to install Claude Code skill
@@ -314,10 +314,10 @@ async function main() {
             console.log(chalk.gray('     In Claude Code, ask: "check my emails" or "clean up my inbox"\n'));
           } catch (skillError) {
             console.log(chalk.yellow(`\n   Could not install skill: ${skillError.message}`));
-            console.log(chalk.gray('     You can install it later with: inbox install-skill\n'));
+            console.log(chalk.gray('     You can install it later with: inboxd install-skill\n'));
           }
         } else {
-          console.log(chalk.gray('\n   Skipped. Install later with: inbox install-skill\n'));
+          console.log(chalk.gray('\n   Skipped. Install later with: inboxd install-skill\n'));
         }
 
       } catch (error) {
@@ -389,7 +389,7 @@ async function main() {
       }
 
       if (accounts.length === 0) {
-        console.log(chalk.gray('No accounts configured. Run: inbox setup'));
+        console.log(chalk.gray('No accounts configured. Run: inboxd setup'));
         return;
       }
 
@@ -398,7 +398,7 @@ async function main() {
         console.log(`  ${chalk.cyan(acc.name)} - ${acc.email || 'unknown email'}`);
       }
       console.log('');
-      console.log(chalk.gray('To add another account: inbox auth -a <name>'));
+      console.log(chalk.gray('To add another account: inboxd auth -a <name>'));
       console.log('');
     });
 
@@ -426,7 +426,7 @@ async function main() {
         removeAccount(options.account);
         console.log(chalk.green(`Removed account "${options.account}"`));
       } else {
-        console.log(chalk.gray('Usage: inbox logout --account <name> or inbox logout --all'));
+        console.log(chalk.gray('Usage: inboxd logout --account <name> or inboxd logout --all'));
       }
     });
 
@@ -1055,9 +1055,9 @@ async function main() {
         else {
           console.log(chalk.red('Error: Must specify --ids or filter flags (--sender, --match)'));
           console.log(chalk.gray('Examples:'));
-          console.log(chalk.gray('  inbox delete --ids "id1,id2" --confirm'));
-          console.log(chalk.gray('  inbox delete --sender "linkedin" --dry-run'));
-          console.log(chalk.gray('  inbox delete --sender "newsletter" --match "weekly" --confirm'));
+          console.log(chalk.gray('  inboxd delete --ids "id1,id2" --confirm'));
+          console.log(chalk.gray('  inboxd delete --sender "linkedin" --dry-run'));
+          console.log(chalk.gray('  inboxd delete --sender "newsletter" --match "weekly" --confirm'));
           return;
         }
 
@@ -1160,7 +1160,7 @@ async function main() {
 
         if (totalSucceeded > 0) {
           console.log(chalk.green(`\nMoved ${totalSucceeded} email(s) to trash.`));
-          console.log(chalk.gray(`Tip: Use 'inbox restore --last ${totalSucceeded}' to undo.`));
+          console.log(chalk.gray(`Tip: Use 'inboxd restore --last ${totalSucceeded}' to undo.`));
         }
         if (totalFailed > 0) {
           console.log(chalk.red(`Failed to delete ${totalFailed} email(s).`));
@@ -1341,8 +1341,8 @@ async function main() {
 
       // Helpful tip
       console.log(chalk.gray('Tip: Use these commands to act on suggestions:'));
-      console.log(chalk.gray('  inbox delete --sender "domain.com" --dry-run'));
-      console.log(chalk.gray('  inbox search -q "from:sender@domain.com"\n'));
+      console.log(chalk.gray('  inboxd delete --sender "domain.com" --dry-run'));
+      console.log(chalk.gray('  inboxd search -q "from:sender@domain.com"\n'));
     });
 
   program
@@ -1382,8 +1382,8 @@ async function main() {
         } else {
           console.log(chalk.red('Error: Must specify either --ids or --last'));
           console.log(chalk.gray('Examples:'));
-          console.log(chalk.gray('  inbox restore --last 1'));
-          console.log(chalk.gray('  inbox restore --ids 12345,67890'));
+          console.log(chalk.gray('  inboxd restore --last 1'));
+          console.log(chalk.gray('  inboxd restore --ids 12345,67890'));
           return;
         }
 
@@ -1518,7 +1518,7 @@ async function main() {
       } catch (error) {
         if (error.message.includes('403') || error.code === 403) {
           console.error(chalk.red('Permission denied. You may need to re-authenticate with updated scopes.'));
-          console.error(chalk.yellow('Run: inbox auth -a <account>'));
+          console.error(chalk.yellow('Run: inboxd auth -a <account>'));
         } else {
           console.error(chalk.red('Error marking emails as read:'), error.message);
         }
@@ -1576,7 +1576,7 @@ async function main() {
       } catch (error) {
         if (error.message.includes('403') || error.code === 403) {
           console.error(chalk.red('Permission denied. You may need to re-authenticate with updated scopes.'));
-          console.error(chalk.yellow('Run: inbox auth -a <account>'));
+          console.error(chalk.yellow('Run: inboxd auth -a <account>'));
         } else {
           console.error(chalk.red('Error marking emails as unread:'), error.message);
         }
@@ -1659,7 +1659,7 @@ async function main() {
 
         if (succeeded > 0) {
           console.log(chalk.green(`\nArchived ${succeeded} email(s).`));
-          console.log(chalk.gray(`Tip: Use 'inbox unarchive --last ${succeeded}' to undo.`));
+          console.log(chalk.gray(`Tip: Use 'inboxd unarchive --last ${succeeded}' to undo.`));
         }
         if (failed > 0) {
           console.log(chalk.red(`Failed to archive ${failed} email(s).`));
@@ -1671,7 +1671,7 @@ async function main() {
       } catch (error) {
         if (error.message.includes('403') || error.code === 403) {
           console.error(chalk.red('Permission denied. You may need to re-authenticate with updated scopes.'));
-          console.error(chalk.yellow('Run: inbox auth -a <account>'));
+          console.error(chalk.yellow('Run: inboxd auth -a <account>'));
         } else {
           console.error(chalk.red('Error archiving emails:'), error.message);
         }
@@ -1721,8 +1721,8 @@ async function main() {
           } else {
             console.log(chalk.red('Error: Must specify either --ids or --last'));
             console.log(chalk.gray('Examples:'));
-            console.log(chalk.gray('  inbox unarchive --last 1'));
-            console.log(chalk.gray('  inbox unarchive --ids 12345,67890'));
+            console.log(chalk.gray('  inboxd unarchive --last 1'));
+            console.log(chalk.gray('  inboxd unarchive --ids 12345,67890'));
           }
           return;
         }
@@ -1923,7 +1923,7 @@ WantedBy=timers.target
           console.log(chalk.white('Useful commands:'));
           console.log(chalk.cyan('  systemctl --user status inboxd.timer') + chalk.gray(' # Check status'));
           console.log(chalk.cyan('  journalctl --user -u inboxd') + chalk.gray(' # View logs'));
-          console.log(chalk.cyan('  inbox install-service --uninstall') + chalk.gray(' # Remove service\n'));
+          console.log(chalk.cyan('  inboxd install-service --uninstall') + chalk.gray(' # Remove service\n'));
         } catch (error) {
           console.error(chalk.red('Error installing service:'), error.message);
           console.log(chalk.yellow('\nThe config files may have been created but could not be enabled.'));
@@ -1951,7 +1951,6 @@ WantedBy=timers.target
       const scriptPath = path.resolve(__dirname, 'cli.js');
       const workingDir = path.resolve(__dirname, '..');
       const plistName = 'com.danielparedes.inboxd.plist';
-      const homeDir = os.homedir();
       const launchAgentsDir = path.join(homeDir, 'Library/LaunchAgents');
       const plistPath = path.join(launchAgentsDir, plistName);
 
@@ -2061,7 +2060,7 @@ WantedBy=timers.target
         console.log(chalk.yellow(`\n⚠️  A skill with the same name already exists but isn't from ${SOURCE_MARKER}.`));
         console.log(chalk.gray(`  Current source: "${status.source || 'none'}"`));
         console.log(chalk.gray(`  Location: ${SKILL_DEST_DIR}\n`));
-        console.log(chalk.white(`To replace it, run: inbox install-skill --force\n`));
+        console.log(chalk.white(`To replace it, run: inboxd install-skill --force\n`));
         return;
       }
 
@@ -2121,7 +2120,7 @@ WantedBy=timers.target
   if (process.argv.length === 2) {
     if (!isConfigured()) {
       console.log(chalk.cyan('\nWelcome to inboxd!'));
-      console.log(chalk.white('Run ') + chalk.bold('inbox setup') + chalk.white(' to get started.\n'));
+      console.log(chalk.white('Run ') + chalk.bold('inboxd setup') + chalk.white(' to get started.\n'));
       return;
     }
   }

package/src/gmail-auth.js

@@ -226,7 +226,7 @@ async function authorize(account = 'default') {
   } catch (_err) {
     throw new Error(
       `credentials.json not found at ${credentialsPath}\n\n` +
-      `Run 'inbox setup' to configure Gmail API access, or manually:\n` +
+      `Run 'inboxd setup' to configure Gmail API access, or manually:\n` +
       `1. Go to https://console.cloud.google.com/\n` +
       `2. Create a project and enable the Gmail API\n` +
       `3. Configure OAuth consent screen (add yourself as test user)\n` +

package/tests/filter.test.js

@@ -1,6 +1,6 @@
 import { describe, it, expect } from 'vitest';
 
-// Test the email filtering logic used in inbox delete command
+// Test the email filtering logic used in inboxd delete command
 // We test the logic patterns without importing the actual module
 
 describe('Email Filtering Logic', () => {

package/tests/json-output.test.js

@@ -4,7 +4,7 @@ import { describe, it, expect } from 'vitest';
 // Validates the output format for AI agent consumption
 
 describe('JSON Output Formats', () => {
-  describe('inbox accounts --json', () => {
+  describe('inboxd accounts --json', () => {
     it('should output account list structure', () => {
       const jsonOutput = {
         accounts: [
@@ -28,7 +28,7 @@ describe('JSON Output Formats', () => {
     });
   });
 
-  describe('inbox deletion-log --json', () => {
+  describe('inboxd deletion-log --json', () => {
     it('should output deletion log structure', () => {
       const jsonOutput = {
         days: 30,
@@ -75,7 +75,7 @@ describe('JSON Output Formats', () => {
     });
   });
 
-  describe('inbox delete --dry-run --json', () => {
+  describe('inboxd delete --dry-run --json', () => {
     it('should output preview structure', () => {
       const jsonOutput = {
         dryRun: true,
@@ -126,7 +126,7 @@ describe('JSON Output Formats', () => {
     });
   });
 
-  describe('inbox restore --json', () => {
+  describe('inboxd restore --json', () => {
     it('should output restore results structure', () => {
       const jsonOutput = {
         restored: 3,

package/tests/older-than.test.js

@@ -1,6 +1,6 @@
 import { describe, it, expect } from 'vitest';
 
-// Test the older-than parsing logic used in inbox analyze command
+// Test the older-than parsing logic used in inboxd analyze command
 // We test the logic patterns directly since the function is not exported
 
 describe('Older Than Duration Parsing', () => {

package/tests/setup.test.js

@@ -206,7 +206,7 @@ describe('Platform Detection', () => {
 
     if (!isMacOS) {
       // Should suggest cron as alternative
-      const cronExample = '*/5 * * * * /path/to/node /path/to/inbox check --quiet';
+      const cronExample = '*/5 * * * * /path/to/node /path/to/inboxd check --quiet';
       expect(cronExample).toContain('* * *');
       expect(cronExample).toContain('check --quiet');
     }