linkedin-monitor

# LinkedIn Monitor

Reliable LinkedIn inbox monitoring for Clawdbot.

## Features

- **Hourly monitoring** — Checks inbox every hour, 24/7
- **Deterministic state** — No duplicate notifications, ever
- **Progressive autonomy** — Start supervised, graduate to autonomous
- **Health checks** — Alerts when auth expires or things break
- **Your voice** — Drafts replies using your communication style

## Quick Start

```bash
# 1. Setup (interactive)
linkedin-monitor setup

# 2. Verify health
linkedin-monitor health

# 3. Run manually (test)
linkedin-monitor check

# 4. Enable cron (hourly)
linkedin-monitor enable
```

## Autonomy Levels

| Level | Name | Behavior |
|-------|------|----------|
| 0 | Monitor Only | Alerts to new messages only |
| 1 | Draft + Approve | Drafts replies, waits for approval |
| 2 | Auto-Reply Simple | Auto-handles acknowledgments, scheduling |
| 3 | Full Autonomous | Replies as you, books meetings, networks |

**Default: Level 1** — Change with `linkedin-monitor config autonomyLevel 2`

## Commands

```bash
linkedin-monitor setup      # Interactive setup wizard
linkedin-monitor health     # Check auth status
linkedin-monitor check      # Run one check cycle
linkedin-monitor enable     # Enable hourly cron
linkedin-monitor disable    # Disable cron
linkedin-monitor status     # Show current state
linkedin-monitor config     # View/edit configuration
linkedin-monitor logs       # View recent activity
linkedin-monitor reset      # Clear state (start fresh)
```

## Configuration

Location: `~/.clawdbot/linkedin-monitor/config.json`

```json
{
  "autonomyLevel": 1,
  "alertChannel": "discord",
  "alertChannelId": "YOUR_CHANNEL_ID",
  "calendarLink": "cal.com/yourname",
  "communicationStyleFile": "USER.md",
  "timezone": "America/New_York",
  "schedule": "0 * * * *",
  "morningDigest": {
    "enabled": true,
    "hour": 9,
    "timezone": "Asia/Bangkok"
  },
  "safetyLimits": {
    "maxMessagesPerDay": 50,
    "escalationKeywords": ["angry", "legal", "refund"],
    "dailyDigest": true
  }
}
```

## How It Works

### Monitoring Flow

```
1. Health Check
   └── Verify LinkedIn auth (lk CLI)
   
2. Fetch Messages
   └── lk message list --json
   
3. Compare State
   └── Filter: only messages not in state file
   
4. For Each New Message
   ├── Level 0: Alert only
   ├── Level 1: Draft reply → Alert → Wait for approval
   ├── Level 2: Simple = auto-reply, Complex = draft
   └── Level 3: Full autonomous response
   
5. Update State
   └── Record message IDs (prevents duplicates)
```

### State Management

State is managed by scripts, not the LLM. This guarantees:
- No duplicate notifications
- Consistent behavior across sessions
- Visible state for debugging

State files: `~/.clawdbot/linkedin-monitor/state/`

## Sending Approved Messages

When at Level 1, approve drafts with:

```
send [name]           # Send draft to [name]
send all              # Send all pending drafts
edit [name] [text]    # Edit draft before sending
skip [name]           # Discard draft
```

## Troubleshooting

### "Auth expired"
```bash
lk auth login
linkedin-monitor health
```

### "No messages found"
```bash
linkedin-monitor check --debug
```

### Duplicate notifications
```bash
linkedin-monitor reset  # Clear state
linkedin-monitor check  # Fresh start
```

## Dependencies

- `lk` CLI (LinkedIn CLI) — `npm install -g lk`
- `jq` (JSON processor) — `brew install jq`

## Files

```
~/.clawdbot/linkedin-monitor/
├── config.json          # Your configuration
├── state/
│   ├── messages.json    # Seen message IDs
│   ├── lastrun.txt      # Last check timestamp
│   └── drafts.json      # Pending drafts
└── logs/
    └── activity.log     # Activity history
```