| name | track-campaigns |
| description | Poll Unipile / Instantly for the status of running campaigns, advance sequence steps that are due, and sync results to Notion. Run this on a cadence (cron / launchd) or manually after staging a campaign. Use when the user says 'track campaigns', 'advance the sequences', 'check campaign progress', 'poll for replies', or 'sync replies to Notion'. Side-effecting — calls Unipile/Instantly, writes to SQLite + Notion. |
| version | 1.0.0 |
Track Campaigns
I'll wrap campaign:track. Run the polling cycle, advance any sequence steps that are due, and surface the per-campaign status delta.
When This Skill Applies
- "track campaigns"
- "advance the sequences"
- "check campaign progress"
- "poll for replies"
- "sync campaign status to Notion"
NOT this skill (use launch-linkedin-campaign instead):
- "launch a campaign" — that's the create+stage flow.
NOT this skill (use answer-linkedin-comments instead):
- "reply to LinkedIn comments" — that's per-thread engagement, not campaign-level tracking.
Workflow
Step 0 — No input needed (or ask for --campaign-id <id> if user wants a single campaign)
Step 1 — Shell out
cd ~/Desktop/gtm-os && set -a && source .env.local && set +a && \
npx tsx src/cli/index.ts campaign:track
Optional: --campaign-id <id> to scope to one campaign.
Step 2 — Parse output
CLI emits per-campaign status delta: messages sent, replies detected, sequence steps advanced, errors.
Step 3 — Render
Step 4 — Offer follow-ups
"Want me to (a) personalize follow-ups for hot replies via personalize-message, (b) generate the weekly campaign report via campaign:report?"
Notes
- Best run on cron: every 15 min during business hours.
- Replies appear in Notion within ~2 min of posting (Unipile webhook latency).
- The CLI is idempotent — running it twice in quick succession is safe (advances nothing if no time has elapsed).
