Skip to content

[Resource]: TinMan - Heartbeat for Claude Code #993

@andyuninvited

Description

@andyuninvited

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    resource-submissionThis Issue submits a new resource to the listvalidation-passedResource has passed initial validation

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions