@inboxapi/cli 0.2.19 → 0.2.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +40 -0
  2. package/package.json +7 -7
package/README.md CHANGED
@@ -19,6 +19,7 @@ Install the `@inboxapi/cli@latest` npm package globally and then register the `i
19
19
  - [Getting Started](#getting-started)
20
20
  - [Commands](#commands)
21
21
  - [Usage with MCP Clients](#usage-with-mcp-clients)
22
+ - [Skills for Claude Code](#skills-for-claude-code)
22
23
  - [Development](#development)
23
24
  - [FAQ](#faq)
24
25
  - [License](#license)
@@ -147,6 +148,15 @@ Restores credentials from a backup folder. Validates backup integrity and offers
147
148
  inboxapi restore ./my-backup
148
149
  ```
149
150
 
151
+ ### `setup-skills`
152
+
153
+ Installs Claude Code skills (slash commands) and hooks into the current project. Skills add email workflows like `/check-inbox`, `/compose`, and `/email-search` directly into Claude Code. Hooks provide automatic credential checks, email send guardrails, and activity logging.
154
+
155
+ ```bash
156
+ inboxapi setup-skills
157
+ inboxapi setup-skills --force # Overwrite existing skills and hooks
158
+ ```
159
+
150
160
  ## Usage with MCP Clients
151
161
 
152
162
  InboxAPI CLI works as an MCP STDIO transport. Point your MCP client at the `inboxapi` binary:
@@ -211,6 +221,36 @@ When prompted, enter:
211
221
  codex mcp add inboxapi inboxapi
212
222
  ```
213
223
 
224
+ ## Skills for Claude Code
225
+
226
+ InboxAPI includes a set of skills — Claude Code slash commands — that add guided email workflows to your project. Install them with:
227
+
228
+ ```bash
229
+ inboxapi setup-skills
230
+ ```
231
+
232
+ ### Available Skills
233
+
234
+ | Skill | Description |
235
+ |-------|-------------|
236
+ | `/check-inbox` | Fetch and display a summary of recent emails in a formatted table |
237
+ | `/compose` | Compose and send an email with guided prompts, addressbook lookup, and confirmation |
238
+ | `/email-search` | Search emails using natural language queries |
239
+ | `/email-reply` | Reply to an email with full thread context and preview before sending |
240
+ | `/email-digest` | Generate a structured digest of recent email activity grouped by threads |
241
+ | `/email-forward` | Forward an email to another recipient with an optional note |
242
+ | `/setup-inboxapi` | Configure InboxAPI MCP server and install skills into a Claude Code project |
243
+
244
+ ### Hooks
245
+
246
+ The `setup-skills` command also installs three hooks that run automatically:
247
+
248
+ | Hook | Type | Description |
249
+ |------|------|-------------|
250
+ | Credential Check | SessionStart | Verifies InboxAPI credentials on startup and shows authentication status |
251
+ | Email Send Guard | PreToolUse | Reviews outbound emails before sending, warns about self-sends and empty bodies |
252
+ | Activity Logger | PostToolUse | Logs all InboxAPI tool usage to `.claude/inboxapi-activity.log` for audit trails |
253
+
214
254
  ## Development
215
255
 
216
256
  ```bash
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@inboxapi/cli",
3
- "version": "0.2.19",
3
+ "version": "0.2.21",
4
4
  "description": "📧 Email for your AI 🤖",
5
5
  "main": "index.js",
6
6
  "bin": {
@@ -28,13 +28,13 @@
28
28
  "test": "cargo test"
29
29
  },
30
30
  "optionalDependencies": {
31
- "@inboxapi/cli-darwin-arm64": "0.2.19",
32
- "@inboxapi/cli-darwin-x64": "0.2.19",
33
- "@inboxapi/cli-linux-arm64": "0.2.19",
34
- "@inboxapi/cli-linux-x64": "0.2.19",
35
- "@inboxapi/cli-win32-x64": "0.2.19"
31
+ "@inboxapi/cli-darwin-arm64": "0.2.21",
32
+ "@inboxapi/cli-darwin-x64": "0.2.21",
33
+ "@inboxapi/cli-linux-arm64": "0.2.21",
34
+ "@inboxapi/cli-linux-x64": "0.2.21",
35
+ "@inboxapi/cli-win32-x64": "0.2.21"
36
36
  },
37
37
  "dependencies": {
38
- "@inboxapi/cli": "^0.2.19"
38
+ "@inboxapi/cli": "^0.2.21"
39
39
  }
40
40
  }