flavio87

flavio87 / tap-to-tmux

Public

Phone notifications when Claude Code or other agents needs attention on remote servers or your local laptop

ai-agents claude-code notifications ntfy remote-development
16
1
100% credibility
Found Mar 20, 2026 at 16 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Shell
AI Summary

Sends push notifications to your phone about events in AI coding sessions running on a remote computer, with one-tap deep links to connect directly to the relevant workspace section.

How It Works

1
🔍 Discover the helper

You hear about a handy tool that alerts your phone when your AI coding buddies on the computer need your help, letting you tap right back into your work.

2
📥 Get it set up

You download and run the easy installer on your computer, placing everything in the right spots.

3
⚙️ Tell it your details

You open the settings file and add your phone alert channel name and quick-connect info for your computer.

4
🚀 Start your AI sessions

You launch your AI coding projects inside organized workspaces on the computer.

5
📱 Phone buzzes with alert

When an AI finishes a task, hits a snag, or waits for you, a smart notification pops on your phone with details about what's happening.

6
👆 Tap to connect

You tap the notification button, and your phone app instantly links you straight to the exact spot in your work session.

✅ Back in action

You're now viewing and controlling your AI project perfectly sized for your phone, ready to guide it along without missing a beat.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 16 to 16 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is tap-to-tmux?

tap-to-tmux sends push notifications to your phone via ntfy when AI agents like Claude Code or Codex need attention in tmux sessions on remote servers or local laptops. Tap the notification for a deep link that opens Blink Shell, SSHes to the machine, and attaches to the exact tmux pane—complete with a phone-optimized viewport and pane zoom. Built in shell scripts, it hooks into agent lifecycles, extracts task context, and supports any tmux-based workflow.

Why is it gaining traction?

It beats polling web UIs or manual SSH by delivering rich, deduplicated alerts with one-tap connects, solving phone notifications not working or not showing on Apple Watch, Fitbit, or Garmin—reliable on iPhone, Mac, with sounds. Extensible hooks pipe to Slack, Discord, or email; optional NTM dashboard gives agent status overview. Self-hosted ntfy option keeps data private, and Tailscale enables laptop access without port forwarding.

Who should use this?

AI agent runners in tmux—Claude Code users on VPS, multi-agent setups with Codex/Gemini CLI via NTM, or remote devs checking agents from phone. Ideal for those tired of missing agent attention signals, needing quick mobile intervention without full desktop access.

Verdict

Grab it if tmux + AI agents are your flow: install in minutes, docs cover macOS quirks and self-hosting. At 16 stars and 1.0% credibility, it's early but battle-tested for personal use—MIT licensed, thorough troubleshooting. Test with the health check before production agents.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.