8000 GitHub - jrnxf/drip: Scriptable notifications from the Mac notch. A CLI for builds, deploys and coding agents like Claude Code, Codex and Gemini CLI. · GitHub
[go: up one dir, main page]

Skip to content
jrnxfPublic

About

Scriptable notifications from the Mac notch. A CLI for builds, deploys and coding agents like Claude Code, Codex and Gemini CLI.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

drip

Notifications that work your way.

drip is a free, open-source macOS CLI that shows scriptable notification cards from the MacBook notch, for builds, deploys and coding agents like Claude Code, Codex and Gemini CLI.

Latest release MIT license macOS 13 or newer Homebrew tap jrnxf/tap/drip

drip cards growing out of the camera notch in turn: Build finished, with make test: 246 passed in 3.2s, then Claude needs you, with Claude needs your permission to use Bash, replaced in place by Deploy failed, with staging: health check timed out after 30s, then the question Deploy to prod?, with Deploy and Cancel buttons, until it times out

Interactive demo · Documentation

Install

brew install jrnxf/tap/drip
drip ok "hello"

Requires macOS 13 or newer. Tested on macOS 15 and 26. Homebrew installs a prebuilt binary for Apple silicon and Intel, with no Xcode needed. No Notifications permission: drip draws its own card. On a Mac without a notch, the card grows out of the top edge of the screen. See installation for source builds and uninstall instructions.

Compose it

Pipe text into a card, give it an action, or use an answer to decide what happens next.

# The first line becomes the title, the rest becomes the detail
git log -1 --format='%s%n%an' | drip ok

# Open a report from the card
drip ok "Report ready" --open ./report.html --button "View report"

# Continue only when you click Deploy
drip warn "Deploy to prod?" --yes Deploy --no Cancel && ./deploy.sh

# Show a command's result and duration, and keep its exit status
drip run make test

See usage for more examples and the contract for exit codes and scripting guarantees.

Coding agents

When the agent needs you, a card comes from the notch. Click it to go back to the agent's terminal.

The fastest way: ask your agent.

Install drip with Homebrew (brew install jrnxf/tap/drip) and add the permission-cards recipe from https://github.com/jrnxf/drip/blob/main/recipes/permission-cards/README.md to my Claude Code settings. Keep my other hooks.

For a shared settings file, use command -v drip >/dev/null && drip hook claude || true as the command, as the team recipe does. It is silent on a machine without drip, so a settings file shared across machines is safe. More recipes, such as a done card for every turn, are in the recipe catalog.

To let your agent send cards itself, add the drip skill: npx skills add jrnxf/drip. Then say "tell me with drip when the tests are done". It adds no hooks.

Make it yours

Set the size, stacking and reusable presets in ~/.config/drip/config.toml. Every key is optional.

size  = "regular"         # compact | regular | large
stack = "chain"           # chain | off

[preset.deploy]
icon  = "paperplane.fill"
color = "#a78bfa"
sound = "Submarine"

Then drip deploy "shipped" uses the preset. Configuration lists every setting and its DRIP_* environment variable.

Clicks can activate an app or run your own command. Cards wait while the screen is locked, and drip history --missed shows missed cards. Use drip pause 30m for a meeting or screen share. Drip does not follow Focus or Do Not Disturb automatically. See click actions, history, and pausing.

Recipes

Recipes are snippets you copy and adapt, such as slow shell commands or a custom click action. See the recipe catalog. To show cards from a Linux machine on your Mac, see remote notifications.

Why not ...

  • terminal-notifier and other Notification Center tools: they need the Notifications permission and follow Focus. drip draws its own card, and drip run wraps a command.
  • Notch apps for coding agents: they set up the hooks for you, so they are the easier choice if agent activity in the notch is all you want. drip is a command, so the same card works for a build, a deploy or a long script, and a script can act on the answer.
  • The agent's own terminal notification: a drip card names the project, goes when you answer in the terminal, and a click brings that terminal back.

See the comparison.

Documentation

Drip collects no analytics. Its only network connection is the SSH connection used by drip follow. See privacy.

License

MIT

About

Scriptable notifications from the Mac notch. A CLI for builds, deploys and coding agents like Claude Code, Codex and Gemini CLI.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0