-
Notifications
You must be signed in to change notification settings - Fork 1.8k
Description
Display Name
TinMan
Category
Tooling
Sub-Category
Tooling: Orchestrators
Primary Link
https://github.com/andyuninvited/tinman_for_claudecode
Author Name
Andy Rosic
Author Link
https://github.com/andyuninvited
License
GPL-3.0
Other License
No response
Description
Adds scheduled heartbeat monitoring to Claude Code. Runs a customizable HEARTBEAT.md checklist on a timer via launchd/cron, logs results, and optionally forwards alerts to Telegram via C3Poh. Ships with three security presets (sane/paranoid/chaos) and enforces notify-only mode by default. Zero external dependencies beyond Python and Claude CLI.
Validate Claims
Install via pip, run tinman init to create a HEARTBEAT.md, then tinman run --once to see Claude analyze your project and report what needs attention.
Specific Task(s)
After installation, ask Claude to check for uncommitted git changes older than 24 hours and report disk space usage.
Specific Prompt(s)
Run tinman run --once after setting up your HEARTBEAT.md. The output shows Claude's analysis of whatever checks you defined.
Additional Comments
Inspired by OpenClaw's heartbeat feature. Pairs with C3Poh for mobile notifications. Part of my Claude Code toolkit that includes heartbeat-templates and agent-blueprints.
Recommendation Checklist
- I have checked that this resource hasn't already been submitted
- It has been over one week since the first public commit to the repo I am recommending
- All provided links are working and publicly accessible
- I do NOT have any other open issues in this repository
- I am primarily composed of human-y stuff and not electrical circuits