notwaldorf/tiny-care-terminal

This is a small terminal dashboard designed to be a friendly companion while you work. It runs in your command-line window and shows a few things at once: tweets from gentle reminder bots about drinking water, taking breaks, and looking away from your screen, a summary of your recent Git commits so you can see all the small things you have actually accomplished even on slow days, and a local weather forecast so you know what to expect outside. The whole dashboard refreshes every 20 minutes. Setting it up requires installing the package through npm, then configuring a handful of environment variables in your shell's configuration file. These variables tell the dashboard which Twitter accounts to follow, which code folders to scan for your commits, what location to use for weather, and whether to show temperatures in Celsius or Fahrenheit. A sample configuration file is included in the repository to show you exactly what to fill in. The Twitter feed feature works best with real API keys from Twitter's developer portal, though the README notes a scraping fallback exists if you prefer not to go through that setup. You can also swap out the ASCII art character shown in the dashboard, choosing from a library of cowsay animals, ANSI art images, or a randomly picked one each time. A built-in Pomodoro timer is also available. Press a key to switch the main box into timer mode, where you can start, pause, stop, and adjust work and break intervals without leaving the terminal. This project is for developers who spend time in the terminal and want a low-key nudge to take care of themselves while working. It requires Node.js version 10.