https://github.com/codeskyblue/cclight
Monitor Claude status using an ESP32-controlled LED light.
https://github.com/codeskyblue/cclight
Last synced: 6 days ago
JSON representation
Monitor Claude status using an ESP32-controlled LED light.
- Host: GitHub
- URL: https://github.com/codeskyblue/cclight
- Owner: codeskyblue
- License: mit
- Created: 2026-05-11T07:55:02.000Z (about 1 month ago)
- Default Branch: master
- Last Pushed: 2026-06-08T06:02:17.000Z (12 days ago)
- Last Synced: 2026-06-08T08:04:59.185Z (12 days ago)
- Language: Python
- Homepage:
- Size: 30.3 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CCLight Status Indicator Plugin
> 通过 ESP32 LED 灯光显示 Claude Code 的工作状态
## 准备硬件
- 硬件代码在 src/esp32-program中可以找到。找台ESP32-C3的板子，刷micropython，然后将main.py刷到板子上。 LED灯负极接GND，正极接Pin(3)
- 电脑通过USB先直连ESP32-C3的板子
## 软件安装
### 1: 安装控制程序
```bash
# 使用 pip 或 pipx
pip install cclight
# pipx install cclight
```
### 2：Claude Code 插件市场
```bash
# 启动 claude code
claude
# 1. 添加 GitHub marketplace
/plugin marketplace add codeskyblue/cclight
# 2. 安装插件
/plugin install cclight@cclight-marketplace
# 3. 重新加载插件
/reload-plugins
# 4. 检查
/plugin list
```
## 测试
安装后 `cclight` 命令即可使用：
```bash
# 启动 daemon（首次使用会自动启动）
cclight state working
cclight state idle
cclight state input
# 手动管理 daemon
cclight daemon start
cclight daemon stop
cclight daemon status
```
> **开发调试？** 查看 [DEVELOP.md](DEVELOP.md) 了解本地开发和调试方法。
# 参考文档
- 创建marketplace: https://code.claude.com/docs/zh-CN/plugin-marketplaces#create-the-marketplace-file
- plugins参考: https://code.claude.com/docs/zh-CN/plugins-reference
- 类似项目: https://github.com/bobek-balinek/claude-lamp