heartbeat-cli 0.1.0

A terminal heartbeat for founders, PMs, and anyone who needs a 30-minute pulse on what matters.

heartbeat-cli

A terminal heartbeat for founders, PMs, and anyone who needs a 30-minute pulse on what actually matters.

╭─ heartbeat · pulse @ 14:30 · Tuesday 24 Mar ──────────────────╮
│  ▸ run at 14:30:02  ·  next in 30 min                          │
╰────────────────────────────────────────────────────────────────╯

  🔴 ACTION NEEDED (3)

  ✉  Priya Mehta (Kapoor & Associates)  ·  unanswered 3h 14m
       Re: Q1 Compliance Automation — delivery timeline query

  ⛔  PharmaCo pipeline  ·  document ingestion blocked
       Reported by Rohan · awaiting vendor API credentials

  ⏰  AIC grant report  ·  deadline in 18h
       Assigned to Tanvi · last update 6h ago

  📋 FYI (3)

  ✓  InsureRight portal — v2 search module shipped

  📅  BD call · TechMahindra  ·  starts in 45 min · Google Meet

  💬  #kapoor-proj  ·  4 new messages since last pulse

                       sources: gmail · gcal · slack · notion · 0.8s

Install

pip install heartbeat-cli

Setup

pulse setup

Walks you through connecting Gmail, Google Calendar, Slack, and Notion. All tokens are stored in your OS keychain — never in plaintext.

Usage

# Run once — get your digest now
pulse

# Run as daemon — fires every 30 min while you're active
pulse --watch

# See what's connected
pulse status

# Show config
pulse config

Connectors

Connector	What it surfaces
Gmail	Unanswered client emails > 2h
Google Calendar	Meetings starting < 60 min, deadlines < 24h
Slack	Direct mentions, DMs, watched channel activity
Notion	Blocked tasks, tasks due soon with no recent update

Triage logic

Two tiers only — no LLM on the urgency path:

🔴 Action needed: Client email unanswered > 2h · task blocked · deadline < 24h · Slack mention

📋 FYI: Completed tasks · upcoming meetings · routine updates

Rule-based deliberately. A digest that fires 48 times a day must be fast, cheap, and produce zero false urgency.

Requirements

• Python 3.10+
• macOS / Linux

License

MIT