inboxd 1.0.13 → 1.1.0

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

@@ -281,22 +281,22 @@ This will guide you through:
 
 ### Optional: Automatic Background Monitoring
 
-Users can enable automatic inbox checking with macOS notifications:
+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
 ```
 
 This installs and starts a background service that:
 - Checks for new emails automatically
-- Sends macOS notifications when new emails arrive
+- Sends desktop notifications when new emails arrive
 - Starts on login
 
-To stop: `launchctl unload ~/Library/LaunchAgents/com.yourname.inboxd.plist`
+**macOS:** Uses launchd. To stop: `launchctl unload ~/Library/LaunchAgents/com.danielparedes.inboxd.plist`
 
-> [!NOTE]
-> This is macOS-only. Linux users can set up a cron job instead.
+**Linux:** Uses systemd. To stop: `systemctl --user stop inboxd.timer`
 
 ## Command Reference
 
@@ -331,7 +331,16 @@ To stop: `launchctl unload ~/Library/LaunchAgents/com.yourname.inboxd.plist`
 | `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 |
 
 ### Smart Filtering Options
 
@@ -590,6 +599,8 @@ When user has job-related emails (LinkedIn, Indeed, recruiters) and wants to eva
 | "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` |
 | "I keep getting these" | Recurring annoyance | Suggest unsubscribe/filter, then delete batch |
@@ -627,7 +638,7 @@ When user has job-related emails (LinkedIn, Indeed, recruiters) and wants to eva
 |--------|--------------|
 | Deleted emails | `inbox restore --last N` |
 | Marked as read | `inbox mark-unread --ids "id1,id2,..."` |
-| Archived | No CLI undo - must use Gmail web |
+| Archived | `inbox unarchive --last N` |
 
 ---
 

package/CLAUDE.md

@@ -11,7 +11,7 @@ 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 launchd service (macOS only)
+inbox install-service       # Install background service (macOS/Linux)
 ```
 
 ## Architecture
@@ -20,9 +20,10 @@ inbox install-service       # Install launchd service (macOS only)
 src/
 ├── cli.js            # Entry point, command definitions (commander)
 ├── gmail-auth.js     # OAuth2 flow, token storage, multi-account management
-├── gmail-monitor.js  # Gmail API: fetch, count, trash, restore
+├── gmail-monitor.js  # Gmail API: fetch, count, trash, restore, archive
 ├── state.js          # Tracks seen emails per account
 ├── deletion-log.js   # Logs deleted emails for restore capability
+├── archive-log.js    # Logs archived emails for unarchive capability
 ├── sent-log.js       # Logs sent emails for audit trail
 ├── notifier.js       # macOS notifications (node-notifier)
 └── skill-installer.js # Copies skill to ~/.claude/skills/
@@ -54,6 +55,7 @@ All user data lives in `~/.config/inboxd/`:
 | `token-<name>.json` | OAuth refresh/access tokens |
 | `state-<name>.json` | `{ seenEmailIds, lastCheck, lastNotifiedAt }` |
 | `deletion-log.json` | Audit log for deleted emails |
+| `archive-log.json` | Audit log for archived emails |
 | `sent-log.json` | Audit log for sent emails |
 
 ## Code Patterns
@@ -70,7 +72,10 @@ All user data lives in `~/.config/inboxd/`:
 - `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
-- `install-service` creates and automatically enables launchd service (macOS only, warns on other platforms)
+- `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)
+- `install-service` creates and enables launchd (macOS) or systemd (Linux) service
 
 ## OAuth Notes
 
@@ -169,7 +174,16 @@ scripts/postinstall.js    # npm postinstall hint about install-skill
 | `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 |
 
 ### Smart Filtering Options
 | Option | Description |
@@ -182,8 +196,9 @@ scripts/postinstall.js    # npm postinstall hint about install-skill
 
 ### Send/Reply Safety
 The `send` and `reply` commands have built-in safety features:
+- **Interactive confirmation**: Prompts "Send this email? (y/N)" when no flags provided
 - **`--dry-run`**: Preview the email without sending
-- **`--confirm`**: Required flag to actually send (prevents accidental sends)
+- **`--confirm`**: Skip the interactive prompt (for automation/scripts)
 - **Audit logging**: All sent emails are logged to `~/.config/inboxd/sent-log.json`
 - **Account resolution**: Prompts for account selection when multiple accounts exist
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "inboxd",
-  "version": "1.0.13",
+  "version": "1.1.0",
   "description": "CLI assistant for Gmail monitoring with multi-account support and AI-ready JSON output",
   "main": "src/cli.js",
   "bin": {

package/src/archive-log.js

@@ -0,0 +1,104 @@
+const fs = require('fs');
+const path = require('path');
+const { TOKEN_DIR } = require('./gmail-auth');
+const { atomicWriteJsonSync } = require('./utils');
+
+const LOG_DIR = TOKEN_DIR;
+const LOG_FILE = path.join(LOG_DIR, 'archive-log.json');
+
+/**
+ * Ensures the log directory exists
+ */
+function ensureLogDir() {
+  if (!fs.existsSync(LOG_DIR)) {
+    fs.mkdirSync(LOG_DIR, { recursive: true });
+  }
+}
+
+/**
+ * Reads the current archive log
+ * @returns {Array} Array of archive entries
+ */
+function readArchiveLog() {
+  ensureLogDir();
+  if (!fs.existsSync(LOG_FILE)) {
+    return [];
+  }
+  try {
+    const content = fs.readFileSync(LOG_FILE, 'utf8');
+    return JSON.parse(content);
+  } catch (_err) {
+    return [];
+  }
+}
+
+/**
+ * Logs archived emails to the archive log
+ * @param {Array} emails - Array of email objects with id, threadId, account, from, subject, snippet
+ */
+function logArchives(emails) {
+  ensureLogDir();
+  const log = readArchiveLog();
+  const timestamp = new Date().toISOString();
+
+  for (const email of emails) {
+    log.push({
+      archivedAt: timestamp,
+      account: email.account,
+      id: email.id,
+      threadId: email.threadId,
+      from: email.from,
+      subject: email.subject,
+      snippet: email.snippet,
+    });
+  }
+
+  atomicWriteJsonSync(LOG_FILE, log);
+}
+
+/**
+ * Gets recent archives from the log
+ * @param {number} days - Number of days to look back (default: 30)
+ * @returns {Array} Array of archive entries within the time range
+ */
+function getRecentArchives(days = 30) {
+  const log = readArchiveLog();
+  const cutoff = new Date();
+  cutoff.setDate(cutoff.getDate() - days);
+
+  return log.filter((entry) => {
+    const archivedAt = new Date(entry.archivedAt);
+    return archivedAt >= cutoff;
+  });
+}
+
+/**
+ * Gets the path to the log file (for display purposes)
+ * @returns {string} The log file path
+ */
+function getArchiveLogPath() {
+  return LOG_FILE;
+}
+
+/**
+ * Removes entries from the archive log (e.g., after unarchiving)
+ * @param {Array<string>} ids - Array of message IDs to remove
+ */
+function removeArchiveLogEntries(ids) {
+  ensureLogDir();
+  const log = readArchiveLog();
+
+  const newLog = log.filter(entry => !ids.includes(entry.id));
+
+  if (log.length !== newLog.length) {
+    atomicWriteJsonSync(LOG_FILE, newLog);
+  }
+}
+
+module.exports = {
+  logArchives,
+  getRecentArchives,
+  getArchiveLogPath,
+  readArchiveLog,
+  removeArchiveLogEntries,
+};