🤖❤️📡

Give Claude Code a heartbeat
and a voice

Claude Code goes silent between sessions. TinMan checks in on a schedule. C3Poh forwards alerts to your phone. Open source, zero dependencies, working in 5 minutes.

⭐ TinMan on GitHub 📡 C3Poh on GitHub
bash — tinman
# Install
$ pip install tinman-for-claudecode c3poh-for-claudecode

# Interactive setup (picks preset, installs scheduler)
$ tinman init
Preset: sane (notify-only, 30 min)
Heartbeat checklist: ./HEARTBEAT.md ✓
Scheduler: launchd installed ✓

# First beat, right now
$ tinman run --once

[TinMan] ✓ 2025-01-15T09:30:00Z (18.3s)
HEARTBEAT_OK

# 30 min later — disk alert forwarded to Telegram
[TinMan] ⚠ 2025-01-15T10:00:00Z
- Disk space: 4.2 GB free (below 5 GB threshold)
- Recommended: clear ~/Downloads or build artifacts
→ Forwarded to Telegram via C3Poh ✓
🤖❤️

TinMan

Scheduled heartbeat for Claude Code. Runs your HEARTBEAT.md checklist through Claude on a timer and tells you when something needs attention.

pip install tinman-for-claudecode GitHub →
📡🤖

C3Poh

Telegram bridge for Claude Code. DM your agent from anywhere, get answers back. Heartbeat alerts from TinMan land on your phone automatically.

pip install c3poh-for-claudecode GitHub →

Security presets

Pick the one that matches your comfort level. You can always change it.

RECOMMENDED
sane
every 30 min
Notify-only. Claude reports, never acts. Best for most people.
TIGHTER
paranoid
every 15 min
Notify-only, more frequent, max logging. For high-stakes projects.
⚠ ACTIVE
chaos
every 5 min
Claude can take actions. You've been warned. You have to opt in explicitly.

How the full stack works

TinMan and C3Poh are independent tools that pair together seamlessly.

launchd / cron
→
tinman run
→
HEARTBEAT.md
→
claude --print
→
C3Poh notify
→
📱 Telegram

📱 You DM bot
→
C3Poh receives
→
claude --print
→
📱 Claude replies

Start in 5 minutes

Both tools. Zero dependencies. Interactive setup. Works on macOS and Linux.

Get TinMan Get C3Poh
📋 HEARTBEAT.md templates 💬 Telegram community 🟠 HN discussion