Ember Mug CLI

Key Features

• •Real-time Temperature: Monitor and adjust your Ember mug's temperature in real-time via Bluetooth. The CLI displays the current temperature and allows you to set a precise target temperature, with immediate feedback from the mug. This feature is essential for maintaining your drink at the perfect temperature without relying on the Ember app.
• •Battery Tracking: Keep track of your Ember mug's battery level with estimated remaining time and charging status displayed in the terminal. This allows you to quickly see when the mug needs to be placed on its charging coaster, ensuring it is always ready for use.
• •Custom Presets: Save up to five of your favorite temperatures as easy-access presets. Switch between presets with a single key command, enabling rapid transitions between different beverages or personal preferences. Presets streamline the experience for users who regularly switch drinks.
• •LED Customization: Personalize your Ember mug's LED indicator with RGB color customization. Control the color via intuitive commands to match your setup or provide visual cues. This adds a layer of personalization and makes the mug more distinctive.
• •Beautiful CLI: The terminal interface is built with React and Ink, offering stunning visual design with real-time updates, progress bars, and color-coded statuses. This makes the tool not only functional but also pleasant to use, elevating the command line experience.
• •Cross-platform: Works on macOS out of the box, on Linux with the BlueZ Bluetooth stack, and on Windows with a compatible Bluetooth adapter. This ensures that developers on any major operating system can control their Ember mug from the terminal.

Use Cases

• •A software developer working on long coding sessions uses Ember Mug CLI to monitor and adjust their coffee temperature in real-time, keeping it at a precise 140°F without leaving the terminal. This eliminates the need to switch to the Ember app, maintaining focus and productivity while ensuring the drink remains at the ideal temperature throughout the session.
• •A system administrator managing remote servers uses SSH to connect to their development machine and check their Ember mug's battery level and temperature via the CLI. They set up a cron job to preheat the mug before morning stand-ups, ensuring hot coffee is ready exactly when needed. This automates a routine task and reduces manual checking.
• •A home office worker frequently switches between coffee and tea throughout the day. Using Ember Mug CLI's custom presets, they save a 'Coffee' preset at 135°F and a 'Tea' preset at 120°F, switching between them with a single keyboard shortcut. They also set the LED to a calming blue for tea and energizing red for coffee, personalizing the experience.
• •A tech enthusiast scripts the mug temperature to decrease to 120°F automatically after 5 PM, conserving battery when not actively drinking. They also set a reminder to place the mug on the charger if battery drops below 20%. This automated workflow saves energy and extends mug battery life without manual intervention.
• •A college student uses Ember Mug CLI on a Windows laptop with a compatible Bluetooth adapter to control their mug during late-night study sessions. They set a preset for warm milk and monitor the battery to ensure it lasts through the night. The CLI's cross-platform support allows them to use it on any device they have.

Who is this for?

The primary target audience for Ember Mug CLI includes software developers and engineers who spend significant time in the terminal and own an Ember smart mug. Additionally, it appeals to DevOps professionals, system administrators, and power users who prefer keyboard-driven tools over graphical interfaces. Tech enthusiasts and early adopters who enjoy open-source projects and automating everyday objects will find it valuable. It is also suitable for any Ember mug owner who wants to control their mug without using the official mobile or desktop app, especially those using Linux or macOS where the app may be less convenient. The tool is designed for individuals comfortable with Node.js and npm, as installation requires running a single npx command.