postwall

# PostWall Email Skill

PostWall is a security layer between AI agents and email. Use this skill to:
- Read emails that have been approved by the human
- Send emails via draft submission (requires human approval before sending)

## Setup

First, authenticate with your API key (get this from PostWall dashboard):

```bash
postwall auth pw_your_api_key_here
```

## Commands

### Check for New Emails

Returns count of unread approved emails. Ideal for polling.

```bash
postwall check              # Returns: 5
postwall check --json       # Returns: {"count": 5}
```

### List Approved Emails

Shows all unread approved emails.

```bash
postwall inbox              # Human-readable list
postwall inbox --json       # JSON format
postwall inbox --limit 10   # Limit results
```

### Read Specific Email

Reads an email by ID. **This marks the email as read** - it won't appear in future inbox/check calls.

```bash
postwall read <email-id>           # Shows email content
postwall read <email-id> --json    # JSON format
```

### Mark Emails as Read (Without Fetching)

Marks one or more emails as read without fetching their content. Useful for batch processing or when you only need to process email metadata from `inbox`.

```bash
postwall mark-read <id1>                  # Mark single email as read
postwall mark-read <id1> <id2> <id3>      # Mark multiple emails as read
postwall mark-read <id1> <id2> --json     # JSON format
```

**Use cases:**
- Mark emails as processed after using `inbox --json` to get metadata
- Batch mark emails you've already handled
- Skip emails you don't need to read in full

**JSON output:**
```json
{
  "success": true,
  "marked": 3,
  "failed": 0,
  "results": [
    {"id": "abc123", "success": true},
    {"id": "def456", "success": true},
    {"id": "ghi789", "success": true}
  ]
}
```

### Send Email (Submit Draft)

Submits an email draft for human approval. The email is NOT sent until approved in the dashboard.

```bash
postwall draft --to "recipient@ex...