How do I install shelldone?

Install via Homebrew (brew install nareshnavinash/tap/shelldone), APT on Debian/Ubuntu, Scoop on Windows, or clone from GitHub and run ./install.sh. After installation, run shelldone setup to configure shell integration and AI CLI hooks.

What shells and platforms does shelldone support?

shelldone works with bash and zsh on macOS, Linux, WSL, and Windows (Git Bash, MSYS2, Cygwin). It uses platform-native notification tools: osascript on macOS, notify-send on Linux, and BurntToast/PowerShell on Windows.

How do I set up Slack notifications with shelldone?

Create a Slack app at api.slack.com/apps, enable Incoming Webhooks, and set the webhook URL: export SHELLDONE_SLACK_WEBHOOK='https://hooks.slack.com/services/...'. Test with: shelldone webhook test slack.

Does shelldone work with AI coding tools?

Yes. shelldone has native hook integration with Claude Code, Codex CLI, Gemini CLI, GitHub Copilot CLI, and Cursor. Run shelldone setup ai-hooks to install hooks for all detected AI CLIs. You get notified when your AI assistant finishes a task.

Does shelldone slow down my shell?

No. shelldone adds less than 50ms to shell startup time. It uses lazy loading for external notification modules and runs all notification delivery in the background so your shell prompt is never blocked.

shelldone - Terminal notifications for long-running commands

6 Notification Channels

5 AI CLI Integrations

452 Tests Passing

4 Platforms

<50ms Shell Startup Overhead

Auto-Notify

Commands running longer than a configurable threshold trigger notifications automatically. No need to remember to prefix anything.

6 External Channels

Slack, Discord, Telegram, Email, WhatsApp, and generic webhooks. Get notified wherever you already work.

AI CLI Integration

Native hooks for Claude Code, Codex, Gemini CLI, Copilot, and Cursor. Know when your AI agent finishes its task.

Cross-Platform

macOS, Linux, WSL, and Windows via Git Bash, MSYS2, and Cygwin. One tool that works everywhere you have a terminal.

Zero Dependencies

Pure bash. No Python, no Node, no Go, no Rust. Just your shell. Installs in seconds, works immediately.

Notification Control

Mute per channel or globally, toggle individual layers, schedule quiet hours. Full control over when and how you get alerted.

Interactive TUI Setup

Run shelldone setup for a menu-driven interface to configure channels, webhooks, and AI CLI hooks.

$ brew install nareshnavinash/tap/shelldone

$ curl -fsSL https://nareshnavinash.github.io/shelldone/KEY.gpg \
    | sudo gpg --dearmor -o /usr/share/keyrings/shelldone-archive-keyring.gpg

$ echo "deb [signed-by=/usr/share/keyrings/shelldone-archive-keyring.gpg] \
    https://nareshnavinash.github.io/shelldone stable main" \
    | sudo tee /etc/apt/sources.list.d/shelldone.list

$ sudo apt update && sudo apt install shelldone

$ scoop bucket add shelldone https://github.com/nareshnavinash/scoop-bucket
$ scoop install shelldone

# Coming soon - submitted for review
$ choco install shelldone

$ git clone https://github.com/nareshnavinash/shelldone.git
$ cd shelldone && ./install.sh

# Add to your .zshrc or .bashrc
$ eval "$(shelldone init zsh)"   # for zsh
$ eval "$(shelldone init bash)"  # for bash

# Or auto-configure everything
$ shelldone setup

Run with alert

$ alert make build

Wraps any command. Sends a desktop notification when it finishes, with exit code and duration.

AI CLI hooks

$ shelldone setup claude-hook

Installs a hook so Claude Code, Codex, Gemini, Copilot, or Cursor notifies you on task completion.

Test webhooks

$ shelldone webhook test slack

Sends a test notification to your configured Slack channel. Works with Discord, Telegram, and others too.

Feature	shelldone	undistract-me	noti	done (fish)
Auto-notify	Yes	Yes	Partial	Yes
macOS + Linux + WSL + Windows	Yes	No	Yes	No
External channels (6)	Yes	No	Partial	No
Zero dependencies	Yes	Yes	No (Go)	Yes
AI CLI integration (5 tools)	Yes	No	No	No
Sound + TTS	Yes	No	Partial	No
Per-channel mute / schedule / toggle	Yes	No	No	No

PASS macOS (bash + zsh) Extensively tested with Claude Code, Gemini CLI, and Codex CLI

PASS Claude Code Full support: task complete + waiting-for-input alerts

PASS Gemini CLI Task complete + notification hooks. Input-wait timing may vary

EXPECTED Codex CLI, Copilot, Cursor Task complete alerts only. Waiting-for-input not supported by these CLIs

PASS Slack webhook End-to-end tested with real webhook delivery

EXPECTED Discord, Telegram, Email, WhatsApp, Webhook Same HTTP dispatch pattern, not yet validated end-to-end

EXPECTED Linux bash/zsh behave identically - should work out of the box

EXPECTED WSL Same shell layer, Windows notification path untested

EXPECTED Windows (Git Bash) PowerShell notification path untested

shelldone is MIT licensed. If something doesn't work on your platform, we'd love your help. Pull requests are always welcome. The codebase is pure bash with zero dependencies.

Ready to never miss a build?

Install in 30 seconds. No dependencies. Works everywhere you have a terminal.

Get Started View on GitHub

shelldone - Terminal Notifications

Terminal Notification Features

Auto-Notify

6 External Channels

AI CLI Integration

Cross-Platform

Zero Dependencies

Notification Control

Interactive TUI Setup

Up and running in 30 seconds

How to Use shelldone

shelldone vs Alternatives

Tested on macOS. Built for everywhere.

Ready to never miss a build?