# cclight

**Repository Path**: shxsun/cclight

## Basic Information

- **Project Name**: cclight
- **Description**: 方便国内用户安装
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-29
- **Last Updated**: 2026-07-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CCLight Status Indicator Plugin

> 通过 ESP32 LED 灯光显示 Claude Code / Codex CLI 的工作状态

## 准备硬件

- 硬件代码在 src/esp32-program中可以找到。找台ESP32-C3的板子，刷micropython，然后将main.py刷到板子上。 LED灯负极接GND，正极接Pin(3)
- 电脑通过USB先直连ESP32-C3的板子

## 软件安装

### 1: 安装LED控制程序

```bash
# 使用 pip 或 pipx, 需要Python版本大于3.8
pip install cclight
# pipx install cclight
```

### 2：安装插件到Claude Code

```bash
# 国内
claude plugin marketplace add git@gitee.com:shxsun/cclight.git
claude plugin install cclight@cclight-marketplace

# 国外
claude plugin marketplace add codeskyblue/cclight
claude plugin install cclight@cclight-marketplace
```

### 3：安装插件到 Codex CLI

```bash
# 国内
codex plugin marketplace add git@gitee.com:shxsun/cclight.git
codex plugin add cclight-codex@cclight-marketplace

# 国外
codex plugin marketplace add codeskyblue/cclight
codex plugin add cclight-codex@cclight-marketplace

# 或者从本地仓库安装
codex plugin marketplace add .
codex plugin add cclight-codex@cclight-marketplace
```

Codex 这里不能直接用 `codex plugin add ./plugins/...` 安装本地目录；要先把仓库作为 marketplace 加进去，再按 `插件名@marketplace名` 安装。

## 测试

安装后 `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