linkedin-inbox

# LinkedIn Inbox Manager Automated LinkedIn inbox monitoring with human-in-the-loop approval for responses. Uses Peekaboo for UI automation (no API rate limits, works with any LinkedIn account). ## Requirements - macOS with Peekaboo CLI installed (`brew install steipete/tap/peekaboo`) - Screen Recording + Accessibility permissions granted - LinkedIn logged in via browser (Chrome recommended) - Clawdbot with browser capability ## Quick Start ### 1. One-time Setup ```bash # Grant Peekaboo permissions peekaboo permissions # Verify LinkedIn is accessible peekaboo app launch "Google Chrome" peekaboo see --app "Google Chrome" --annotate --path /tmp/linkedin-check.png ``` ### 2. Configure User Style Create `linkedin-inbox-config.json` in your workspace: ```json { "scan": { "intervalMinutes": 60, "activeHours": { "start": 9, "end": 18, "timezone": "America/Los_Angeles" }, "skipWeekends": true }, "drafting": { "styleProfile": "USER.md", "templates": { "decline": "Thanks for reaching out. Not a fit for us right now, but best of luck.", "interested": "This looks interesting. Happy to chat more. What's your availability?", "referral": "I might know someone. Let me check and get back to you." } }, "notifications": { "channel": "discord", "target": "#linkedin" } } ``` ### 3. Start Monitoring Tell your agent: "Start LinkedIn inbox monitoring" or add to HEARTBEAT.md: ```markdown - Check LinkedIn inbox if last scan >1 hour ago ``` ## Core Workflow ### Scan Inbox ```bash # Navigate to LinkedIn messaging peekaboo app launch "Google Chrome" peekaboo menu click --app "Google Chrome" --item "New Tab" peekaboo type "https://www.linkedin.com/messaging/" --return sleep 3 # Capture inbox state peekaboo see --app "Google Chrome" --window-title "Messaging" --annotate --path /tmp/linkedin-inbox.png ``` The agent reads the annotated screenshot to identify: - Unread messages (bold names, blue dots) - Message previews - Sender names and titles ### Draft Responses For each unread message: 1. Agent reads the conversation 2. Classifies intent (pitch, networking, job inquiry, spam) 3. Drafts response matching user's communication style 4. Posts draft to notification channel for approval Example notification: ``` 💼 LinkedIn: New message from **Alex M.** (Founder @ SomeCompany) Preview: "Hi, I noticed you're growing and wondered if..." **My read:** Services pitch. Doesn't fit current needs. **Draft reply:** > Thanks for reaching out. We're set on that side for now, but I'll keep you in mind if that changes. React ✅ to send, ❌ to skip, or reply with edits. ``` ### Send Approved Messages On approval: ```bash # Click into conversation peekaboo click --on [message-element-id] --app "Google Chrome" sleep 1 # Type response peekaboo type "Your approved message here" --app "Google Chrome" # Send (Enter or click Send button) peekaboo press return --app "Google Chrome" ``` ## Communication Style Matching The skill reads `USER.md` (or configured style file) to match the user's tone: **Extract these signals:** - Formality level (casual vs professional) - Typical greeting style - Sign-off patterns - Sentence length preference - Banned words/phrases - Response length norms **Apply to drafts:** - Mirror detected patterns - Use user's vocabulary - Match their directness level - Respect their guardrails (no "excited", no hype, etc.) See `references/style-extraction.md` for detailed guidance. ## Morning Ping Integration Add LinkedIn summary to your morning ping: ```markdown 📣 The Morning Ping — Monday, Jan 27 **LinkedIn:** • 💚 Sarah Chen replied — "That sounds great, let's do Thursday" → Draft ready • 💚 Mike R. replied — "Not interested right now" → No action needed • 📩 3 new connection requests (2 sales pitches, 1 relevant) • 📩 1 unread message from Alex (job inquiry) → Draft ready Reply "send sarah" to approve, "skip mike" to archive. ``` ## Approval Commands Users can respond with: - `send [name]` - Send the drafted reply - `send all` - Send all pending drafts - `skip [name]` - Archive without replying - `edit [name]: [new message]` - Replace draft and send - `show [name]` - Show full conversation ## Scheduled Scanning ### Via Cron (Recommended) ```json { "schedule": "0 */2 9-18 * * 1-5", "text": "Scan LinkedIn inbox and post any new messages to #linkedin with draft replies" } ``` ### Via Heartbeat In HEARTBEAT.md: ```markdown - If 9am-6pm PT and last LinkedIn scan >60min: scan inbox, draft replies, post to #linkedin ``` ## Safety Rules 1. **Never send without explicit approval** - Always wait for user confirmation 2. **Rate limit actions** - Max 20 LinkedIn actions per hour 3. **Respect quiet hours** - Don't scan outside configured activeHours 4. **Log everything** - Record all actions in daily memory file 5. **Preserve originals** - Never delete messages, only archive ## Troubleshooting ### "Can't find messaging UI" - Ensure Chrome is open with LinkedIn logged in - Check window title matches (may vary by language) - Use `peekaboo list windows --app "Google Chrome" --json` to debug ### "Session expired" - LinkedIn sessions expire periodically - Re-authenticate manually in browser - Skill will detect login page and notify user ### "Peekaboo permissions denied" ```bash peekaboo permissions # Check status # Grant via System Preferences > Privacy & Security > Screen Recording + Accessibility ``` ## Files - `scripts/scan_inbox.sh` - Peekaboo commands for inbox capture - `scripts/send_message.sh` - Peekaboo commands for sending - `references/style-extraction.md` - Guide for communication style matching