Heartbeat Templates
March 11, 2026 · View on GitHub
Community templates for TinMan — the heartbeat scheduler for Claude Code.
Drop any of these into your project as HEARTBEAT.md and TinMan will run it on a schedule. Edit freely — these are starting points, not rules.
Part of the Claude Code Toolkit
| Tool | Role | Link |
|---|---|---|
| TinMan | The heart — runs these templates on a schedule | tinman_for_claudecode |
| C3Poh | The voice — sends alerts to your phone | c3poh_for_claudecode |
| Agent Blueprints | The brains — starter agent templates | agent-blueprints |
Templates
| # | Template | Best for | Interval |
|---|---|---|---|
| 01 | Solo Dev | Personal projects, side projects | 30 min |
| 02 | Startup Team | Fast-moving team codebases | 30 min |
| 03 | AI Project | Claude/OpenAI/Supabase projects, API key hygiene | 30 min |
| 04 | Content Creator | Writers and newsletter authors, no code jargon | 60 min |
| 05 | OSS Maintainer | Public repos with issues, PRs, CI | 60 min |
| 06 | Security Paranoid | High-stakes projects, PII, payments, auth | 15 min |
| 07 | Mobile App Dev | iOS/Android/Capacitor/React Native | 30 min |
| 08 | Data Pipeline | ETL jobs, batch processing, database workflows | 15 min |
How to use
1. Pick a template and copy it:
curl -o HEARTBEAT.md https://raw.githubusercontent.com/andyuninvited/heartbeat-templates/main/templates/01-solo-dev.md
2. Edit it to match your project — remove checks you don't care about, add ones you do.
3. Run TinMan:
pip install tinman-for-claudecode
tinman init
That's it. TinMan picks up HEARTBEAT.md from your project directory automatically.
4. (Optional) Get alerts on your phone:
pip install c3poh-for-claudecode
c3poh init
Then enable C3Poh notifications in TinMan's config.
The one rule every template follows
Every template here ends with some version of:
Nothing urgent →
HEARTBEAT_OK. Something found → bullets + ask before acting.
This is intentional. Claude reports, never acts unilaterally. If you want Claude to take action, you have to explicitly tell it to in your own HEARTBEAT.md. The templates here won't do it by default.
Contribute a template
Got a workflow that isn't covered? PRs welcome.
Template format:
# Your Template Name
<!--
Template: Short name
Best for: Who this is for
Interval: Recommended interval
Mode: notify-only (default) or active
-->
[Your checklist here]
## Response format:
[How Claude should respond]
## Hard rules:
[What Claude must never do]
One template per file, named NN-descriptive-name.md. Add it to the table in this README.
Related
- TinMan — the heartbeat scheduler these templates run on
- C3Poh — Telegram bridge so heartbeat alerts reach your phone
- Agent Blueprints — starter templates for more complex agents
License
GNU GPLv3
Built by @andyuninvited