GitHub Copilot Physical Notifier

🇯🇵 日本語版はこちら

A physical notification device that shakes a figurine's head and pulses an LED when GitHub Copilot enters a user-question-waiting state (ask_user).
Built with just an Arduino Nano, a servo motor, and an LED — anyone can assemble it with basic soldering skills and a 3D printer.

1. Clone this repository and open it in VS Code or your terminal
2. Launch GitHub Copilot Chat or GitHub Copilot and type "Start building"
3. GitHub Copilot will guide you through the build process

Follow the Build Guide step by step.

GitHub Copilot (preToolUse / postToolUse hook)
  → send_trigger.py (pyserial)
    → Arduino Nano (servo head-shake + LED breathing)

• preToolUse hook detects ask_user → sends serial "1" → animation starts
• postToolUse hook detects ask_user completion → sends serial "0" → animation stops

This project uses GitHub Copilot CLI Hooks. The same hook functionality is also available in VS Code Copilot Chat (Agent Mode) — see the official documentation.

Soldering iron set / Phillips screwdriver / Tweezers / Rubber adhesive

See BOM.md for the complete parts and tools list.

├── README.md              ← This file
├── LICENSE                 ← MIT License
├── docs/
│   ├── BOM.md             … Parts & tools list
│   ├── HARDWARE.md        … Circuit diagram, wiring & assembly
│   ├── BUILD_GUIDE.md     … Step-by-step build guide
│   ├── GHC.md             … PC & GitHub Copilot setup
│   └── images/            … Documentation images
├── firmware/
│   └── firmware.ino       … Arduino firmware
├── models/                … 3D printable STL files
└── script/
    └── send_trigger.py    … Serial trigger script

• Be careful of burns when soldering and work in a well-ventilated area
• Do not look directly at the LED
• This device is powered by USB 5V, so the risk of electric shock is low, but be careful of short circuits

Issues and Pull Requests are welcome.

• 3D Model: octoprints by Martin Woodward — source data for the character figurine
• Libraries: pyserial, Arduino Servo library

This project is licensed under the MIT License.

Note: The character 3D models from octoprints are provided under the CC BY-NC 4.0 license and may not be used for commercial purposes. The MIT license of this repository does not apply to the octoprints model data.