Does this skill work on Windows or Linux?

Currently, this skill is specifically designed for macOS as it utilizes macOS LaunchAgents and the terminal-notifier utility.

How do I verify if the notification system is running correctly?

You can run the command '/tmux-init --status' within Claude Code to see a detailed breakdown of dependencies, services, and configuration status.

Does this require any external services?

No, it sets up a local webhook service on port 9000 that runs entirely on your machine to handle communication between Claude and the macOS notification system.

How do I uninstall the notification system?

Simply run '/tmux-init --uninstall' to stop the background service and remove the associated configuration files.

What happens when I click a notification?

Clicking the notification triggers a command that automatically focuses your terminal and switches tmux to the exact session, window, and pane where Claude is running.

Tmux Notification System

Name: Tmux Notification System
Author: jpoutrin

byjpoutrin

•

生产力与工作流

Integrates native macOS notifications with Claude Code sessions to alert users when background tasks complete or require input.

The Tmux Notification System is designed for developers who run multiple Claude Code agents or long-running tasks within tmux panes. It eliminates the need to constantly poll terminals for updates by setting up a local webhook service that triggers native macOS notifications. When a notification is clicked, the skill automatically navigates the user back to the specific tmux session, window, and pane where Claude is active, enabling a highly efficient multi-agent development workflow.

主要功能

01Real-time installation and dependency status checking

028 GitHub stars

03Native macOS alerts for Claude 'Stop' and 'Notification' events

04Automated background service setup via macOS LaunchAgents

05Seamless integration with the Forge CLI for notification routing

06Click-to-navigate support that jumps directly to the active tmux pane

使用场景

01Managing multiple concurrent Claude Code agents across different tmux windows

02Reducing downtime by receiving immediate alerts when Claude requires manual intervention

03Enhancing focus by allowing Claude to work in the background while you code in another application

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jpoutrin/product-forge tmux-init

For use in Claude.ai and ChatGPT

Download Skill