claude-code-ntfy

claude-code-ntfy

A transparent wrapper for Claude Code that sends a notification when Claude needs your attention.

Features

• 🔔 Single notification when Claude needs attention
• 🔄 Transparent wrapping - preserves all Claude Code functionality
• 💤 Intelligent inactivity detection
• 🖥️ Cross-platform support (Linux/macOS)

Intelligent Inactivity Detection

The backstop timer provides smart notifications when Claude might need your attention:

• While Claude is outputting: Timer is continuously reset
• When Claude stops: A 30-second countdown begins
• If you start typing: Timer is permanently disabled
• If Claude sent a bell: Timer is disabled (you're already notified)
• After 30 seconds of inactivity: ONE notification is sent

This ensures you're notified when Claude needs input, but not when you're actively working.

Installation

Go Install

go install github.com/Veraticus/claude-code-ntfy/cmd/claude-code-ntfy@latest

Build from Source

git clone https://github.com/Veraticus/claude-code-ntfy
cd claude-code-ntfy
make build

NixOS / Nix

Claude Code Ntfy can be installed on NixOS or any system with Nix package manager. This installation method provides a wrapper that automatically intercepts the `claude` command.

Using Nix Flakes

# Run directly without installation
nix run github:Veraticus/claude-code-ntfy -- --help

# Install to user profile (hijacks the claude command)
nix profile install github:Veraticus/claude-code-ntfy

# Or in your flake.nix
{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    claude-code-ntfy.url = "github:Veraticus/claude-code-ntfy";
  };

  outputs = { self, nixpkgs, claude-code-ntfy }: {
    # For NixOS system configuration
    nixosConfigurations.mysystem = nixpkgs.lib.nixosSystem {
      modules = [
        claude-code-ntfy.nixosModules.default
        {
          programs.claude-code-ntfy.enable = true;
        }
      ];

...