# AI use cases for Vibewatch (GOROman/vibewatch)

Repo: [GOROman/vibewatch](https://github.com/GOROman/vibewatch) | Use cases: 5 | Page: https://dedupedai.com/use-cases/goroman-vibewatch/

Vibe Watch is MIT-licensed C++ firmware that turns an M5Stack StopWatch into a wireless, wearable controller for approving, rejecting, and speaking to AI coding agents.

This file holds every use case of this repo. Each one starts with a "## " heading and ends with its URL.

- Build Vibe Watch firmware and pair it with a Mac: https://dedupedai.com/use-cases/goroman-vibewatch/build-and-pair-vibe-watch/
- Approve or reject agent actions with physical buttons: https://dedupedai.com/use-cases/goroman-vibewatch/approve-or-reject-agent-decisions-on-wrist/
- Watch six parallel agent sessions at a glance: https://dedupedai.com/use-cases/goroman-vibewatch/glance-at-six-parallel-agent-sessions/
- Dictate the next prompt with hold-to-talk on the watch: https://dedupedai.com/use-cases/goroman-vibewatch/speak-prompts-with-push-to-talk/
- Convert the StopWatch into a wrist-worn controller: https://dedupedai.com/use-cases/goroman-vibewatch/wrist-mount-stopwatch-for-mobile-use/

## How to build Vibe Watch firmware and pair it with a Mac with Vibewatch

Repo: [GOROman/vibewatch](https://github.com/GOROman/vibewatch) | Difficulty: Intermediate | Time: 60 minutes | Basis: From the README

Compile the open-source firmware for the StopWatch, flash it, and pair the device over Bluetooth to your Mac.

**Who it is for:** A developer with an M5Stack StopWatch who wants to start using Vibe Watch with their AI coding host on macOS.

**The problem:** The StopWatch ships without this firmware, so it cannot act as an AI coding controller until it is built, flashed, and paired.

**The outcome:** The StopWatch runs Vibe Watch firmware and appears as a paired Bluetooth device named Vibe Watch with a slot number.

### Steps

1. Install PlatformIO Core by following the official installation guide linked in the README.
2. Run `git clone https://github.com/GOROman/vibewatch.git` and then `cd vibewatch`.
3. Run `python3 -m platformio run -e m5stack-stopwatch` to build the firmware.
4. Connect the StopWatch by USB and run `python3 -m platformio run -e m5stack-stopwatch --target upload`.
5. On the watch, open Settings, select one of the three device slots, tap PAIR, then connect to Vibe Watch #n from macOS Bluetooth settings.

### Prompt to paste into your agent

```text
Using the GOROman/vibewatch repo, run the PlatformIO build for the m5stack-stopwatch environment in <project folder> and report the final build status. Verify that the output ends with a success line and no errors before reporting.
```

### Caveat

The README describes the setup only for macOS Bluetooth settings, so other operating systems are not covered by the documented pairing steps.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/goroman-vibewatch/build-and-pair-vibe-watch/

## How to approve or reject agent actions with physical buttons with Vibewatch

Repo: [GOROman/vibewatch](https://github.com/GOROman/vibewatch) | Difficulty: Intermediate | Time: 60 minutes | Basis: From the README

Use the orange NG and blue OK buttons on the watch to answer agent decisions without touching the keyboard.

**Who it is for:** A developer whose AI coding agent is waiting for a yes or no decision while they are away from the desk.

**The problem:** Switching windows to answer a single approval prompt interrupts focus and wastes time when the agent is idle.

**The outcome:** The developer presses the OK or NG button and gets distinct sound and haptic feedback confirming the decision.

### Steps

1. Pair the StopWatch with the Mac as described in the build and pair steps.
2. Press both hardware buttons together to enter the Action layer.
3. Press the blue right button for OK to approve, or the orange left button for NG to reject.
4. Listen for the rising square-wave phrase for OK or the falling phrase for NG and feel the haptic response to confirm the choice.

### Prompt to paste into your agent

```text
Using the GOROman/vibewatch repo as the wrist controller, confirm the pending agent approval in <agent session> by pressing OK on the watch. Report whether the agent continued to its next step. Verify the agent output shows the approval was received.
```

### Caveat

The README does not say which AI agents receive OK or NG presses, so confirm your agent host accepts this input before relying on it.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/goroman-vibewatch/approve-or-reject-agent-decisions-on-wrist/

## How to watch six parallel agent sessions at a glance with Vibewatch

Repo: [GOROman/vibewatch](https://github.com/GOROman/vibewatch) | Difficulty: Intermediate | Time: 60 minutes | Basis: From the README

Keep live status for up to six agent sessions on a round screen and pick the one that needs attention.

**Who it is for:** A developer running several AI coding agent sessions in parallel who needs to know when a task finishes.

**The problem:** Checking each session window to see which task completed wastes attention and breaks the coding flow.

**The outcome:** The developer sees six agent indicators with color, brightness, and animation, and selects the session that finished.

### Steps

1. Pair the StopWatch with the Mac and confirm the watch shows the Agent layer.
2. Look at the six agent indicators around the round screen to read each session's state.
3. Move the selection ring to the agent you want by using the touchscreen or buttons.
4. Feel the adjustable state-change haptics to notice updates without looking at the screen.

### Prompt to paste into your agent

```text
Using the GOROman/vibewatch repo, check that the six agent indicators on the watch reflect the state of <number of active sessions> sessions. Report which session is selected and its visible state. Verify the reported states match the sessions shown in the host app.
```

### Caveat

The README describes six agent slots but does not explain how the host sends each agent state, so set up the host side separately before expecting live updates.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/goroman-vibewatch/glance-at-six-parallel-agent-sessions/

## How to dictate the next prompt with hold-to-talk on the watch with Vibewatch

Repo: [GOROman/vibewatch](https://github.com/GOROman/vibewatch) | Difficulty: Intermediate | Time: 60 minutes | Basis: From the README

Hold the center microphone on the StopWatch to speak the next prompt to your AI assistant hands-free.

**Who it is for:** A developer away from the keyboard who wants to give an AI coding agent its next instruction by voice.

**The problem:** Returning to the keyboard just to type a short follow-up prompt slows the work and interrupts other tasks.

**The outcome:** The developer speaks a prompt into the watch while holding the center microphone and the assistant receives the spoken request.

### Steps

1. Pair the StopWatch with the Mac as described in the build and pair steps.
2. Press both hardware buttons to enter the Action layer.
3. Press and hold the center microphone control to talk.
4. Speak the prompt, then release the microphone to finish the request.

### Prompt to paste into your agent

```text
Using the GOROman/vibewatch repo, send a spoken prompt from the watch to the assistant by holding the center microphone while saying <prompt text>. Report the text the assistant received. Verify the assistant response matches the spoken request.
```

### Caveat

The README mentions voice input and push-to-talk but does not describe speech recognition or which assistant receives the audio, so test one spoken prompt before relying on it.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/goroman-vibewatch/speak-prompts-with-push-to-talk/

## How to convert the StopWatch into a wrist-worn controller with Vibewatch

Repo: [GOROman/vibewatch](https://github.com/GOROman/vibewatch) | Difficulty: Advanced | Time: 120 minutes | Basis: From the README

Modify the official M5Stick watch mount so the round StopWatch can be worn on the wrist while moving around.

**Who it is for:** A developer who wants the AI controller available while standing, walking, or working away from a desk.

**The problem:** The StopWatch has no wrist mount of its own, and the official kit is built for rectangular M5Stick devices.

**The outcome:** The StopWatch is bonded to a modified mount and nylon strap that passed a firm pull test, ready to wear.

### Steps

1. Remove the plastic mount from the device and strap, then use flush cutters or small nippers to cut away the raised M5Stick retaining hooks a little at a time.
2. Trim burrs and sharp edges until the mount has a flat bonding surface, then clean and fully dry both surfaces.
3. Cut high-strength double-sided tape to fit inside the mount footprint, keeping buttons, connectors, and openings clear.
4. Center the mount on the back of the StopWatch, press firmly, and let the adhesive reach its specified bond strength.
5. Refit the nylon strap and perform a firm pull test before wearing the device.

### Prompt to paste into your agent

```text
Using the GOROman/vibewatch repo's wrist-mount steps, list the tools and parts needed to convert an M5Stack StopWatch into a wrist-worn controller. Report the checklist in order. Verify that every step includes the instruction to pull-test the mount before wearing.
```

### Caveat

The conversion requires cutting plastic and bonding the mount with adhesive, and the README asks for eye protection and a firm pull test before wearing.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/goroman-vibewatch/wrist-mount-stopwatch-for-mobile-use/
