breaklimit

The CLI to interact with https://breaklimit.vercel.app/.

Enjoy the Break Limit theme song while you get started.

Get Started

$ npm install -g breaklimit

Then choose the first option to sign up:

$ breaklimit

Read all the text carefully and follow the instructions.

Post Sign-Up Menu

You can run the CLI again without any flags to get additional options:

$ breaklimit

This will give you the following options:

❯ 1. Get Remaining Time
  2. Stop Timer
  3. Reset Token
  4. Set Token
  5. Delete User
  6. Update Preferences
  7. Exit

1. Get Remaining Time: Will appear if a timer is active. Since CTRL+C will cancel the CLI but not the timer on the website, this way you can get the progress bar back to visualize the remaining time.

2. Stop Timer: Will appear if a timer is active. It will reset the timer.

3. Reset Token: Will reset the token and send a new token to your email. Use this if you've lost your token.

4. Set Token: Will allow you to set an existing token. Use this if you want to use the CLI on a different device with the same user.

5. Delete User: Will delete your user and all associated data.

6. Update Preferences: Will allow you to update your preferences which will remember your preferences when you start a timer.

Start a timer

Example commands:

$ breaklimit --time 11:55 
$ breaklimit --minutes 0.5 --open
$ breaklimit --seconds 1500 --theme classic
$ breaklimit --minutes 15 --seconds 30

You can always run the following to get an overview of the flags:

$ breaklimit --help

Overview of commands:

| Command | Description | |---------------------|-------------------------------------------------------------------------------------------------| | --open | Opens the timer website in your chosen browser. | | --time <type> | Provide the time until the break ends in the format HH:MM or H:MM. | | --minutes <number>| Provide the length of the break in minutes. | | --seconds <number>| Provide the length of the break in seconds. | | --get-timer | Gets the timer if active and displays it in the terminal. | | --stop-timer | Resets the timer if active. | | --theme <type> | Change the theme of the stopwatch just once. Otherwise, consider changing your preferences. | | --themes | Get a list of available themes. |

Tips for Website Usage

The classic theme contains a QR code for your custom endpoint. It can be clicked to expand it for easy scanning.

Issues and Feature Requests

Feel free to open an issue on the GitHub repository.