https://github.com/sator-imaging/node-pomodoro

Node.js tool to provide pomodoro-like timer with beep sound playback that helps controlling AI coding agent reporting frequency.
https://github.com/sator-imaging/node-pomodoro

ai coding-agent coding-agents node node-js nodejs npm-package

Last synced: 14 days ago
JSON representation

Node.js tool to provide pomodoro-like timer with beep sound playback that helps controlling AI coding agent reporting frequency.

• Host: GitHub
• URL: https://github.com/sator-imaging/node-pomodoro
• Owner: sator-imaging
• License: mit
• Created: 2025-07-13T01:43:30.000Z (7 months ago)
• Default Branch: main
• Last Pushed: 2025-07-21T11:45:11.000Z (7 months ago)
• Last Synced: 2025-07-21T11:57:44.213Z (7 months ago)
• Topics: ai, coding-agent, coding-agents, node, node-js, nodejs, npm-package
• Language: JavaScript
• Homepage:
• Size: 85.9 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

          
[![npmjs.com](https://img.shields.io/npm/v/pomodoro-beep)](https://www.npmjs.com/package/pomodoro-beep)

 

[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/sator-imaging/node-pomodoro)

# How to Use

```sh

npx pomodoro-beep --at 10  # set timer at the next 10 minutes mark.

```

```sh

npx pomodoro-beep --for 10  # set timer after 10 minutes.

```

Play beep sound at 30 minutes mark every hour.

```sh

npx pomodoro-beep --at 30 --beep 'myBeep.mp3'

```

How to prevent AI agent annoying you by frequent reports.

Of course just ignore pull requests from AI is another solution.

```batch

:LOOP

    :: your coding agent cli command

    my-coding-agent --prompt "solve GitHub open issues."

    :: report every hour, not frequent.

    npx pomodoro-beep --at 30 --beep "myBeep.mp3"

    goto :LOOP

```

# TODO

- Support direct playback of `https` resource.

- Message text internationalization.

# License

MIT License.