@wilsong/shiplog
v0.2.0
Published
What did your AI build while you were at the gym? Session reports for vibe-coding developers.
Downloads
182
Maintainers
Readme
ShipLog
What did your AI build while you were at the gym?
Session reports for vibe-coding developers. One beautiful branded email summarizing everything your AI coding assistant shipped — commits, features, fixes, deployments, and what's still pending.
The Problem
You close your laptop. You go to the gym. You come back and:
- 47 individual GitHub commit notifications (noise)
- No idea what state your codebase is in
- Can't tell your team/investors what shipped today
- The AI coded for 3 hours and you have no summary
The Solution
npx shiplog --email [email protected]ShipLog watches your git activity, analyzes what changed, and sends you ONE branded HTML email with:
- Total commits and files changed
- Features shipped vs bugs fixed vs refactors
- Database migrations applied
- Edge functions deployed
- Build status (pass/fail)
- What's still pending
- Shipping velocity over time
Quick Start
npm install -g @wilsong/shiplogOption 1: CLI (run after a session)
shiplog send --email [email protected] --since "4 hours ago"Option 2: Watch mode (auto-send when idle)
shiplog watch --email [email protected] --idle-timeout 30mOption 3: Programmatic (in your AI workflow)
import { ShipLog } from '@wilsong/shiplog';
const log = new ShipLog({
email: '[email protected]',
resendApiKey: process.env.RESEND_API_KEY,
brandName: 'Your Company',
brandColor: '#0077B5',
});
// Analyze recent git activity and send report
await log.analyzeAndSend({ since: '4 hours ago' });What Gets Analyzed
| Signal | Source |
|--------|--------|
| Commits | git log with diff stats |
| Features vs Fixes | Commit message convention detection (feat/fix/refactor) |
| Files Changed | Grouped by directory (components, API routes, DB, etc.) |
| Build Status | Detects next build / npm run build exit codes |
| Migrations | Supabase migration files detected |
| Edge Functions | Supabase edge function deploys detected |
| Test Results | Playwright / Vitest / Jest results if available |
| Dependencies | package.json changes (new deps added) |
Email Template
The email is a branded HTML report that looks professional enough to forward to:
- Your team (daily standup replacement)
- Your investors (weekly shipping updates)
- Your clients (progress reports)
- Yourself (session memory for ADHD developers)
Configuration
Create a .shiplog.json in your project root:
{
"email": "[email protected]",
"cc": ["[email protected]", "[email protected]"],
"resendApiKey": "re_...",
"brandName": "Drivia",
"brandColor": "#0077B5",
"idleTimeout": "30m",
"includeLinkedInDraft": true,
"includeSlackWebhook": "https://hooks.slack.com/...",
"commitConventions": true,
"groupByDirectory": true
}Integrations (Roadmap)
- [x] Email via Resend
- [ ] Slack webhook
- [ ] Discord webhook
- [ ] Linear ticket updates
- [ ] Notion page creation
- [ ] LinkedIn post draft generation
- [ ] GitHub Release auto-creation
- [ ] Investor update template (monthly)
Why This Exists
Built by Wilson Guenther — a founder with ADHD who codes with AI for 6+ hours a day and needed a way to remember what shipped.
The vibe-coding revolution means developers ship more in a day than ever before. But if you can't communicate what you shipped, it doesn't count. ShipLog bridges the gap between building and communicating.
License
MIT
