yzhao062

Vibesignal — AI skill for Claude Code

AI community

Physical status light for AI coding agents (Claude Code / Codex).

How to install Vibesignal

This entry records only its repository, not the path inside it, so there is no exact command to give. Open yzhao062/vibesignal and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Vibesignal does

Physical status light for AI coding agents (Claude Code / Codex).

Alternatives in AI

  • Ccstatusline — by sirmalloc - A highly customizable status line formatter for Claude Code CLI that displays model info, git b 5.5k ★
  • CodeIsland — Real-time AI coding agent status panel in your MacBook notch — live status, approvals & replies for 13 AI tool 2.3k ★
  • PRD: Agent Builder — Create Your Own Sub-Agent — Your ecosystem, your rules 1.9k ★

README

VibeSignal

**A physical USB status light for AI coding agents (Claude Code, Codex)**

[![PyPI](https://img.shields.io/pypi/v/vibesignal.svg)](https://pypi.org/project/vibesignal/) [![License: BSD-2-Clause](https://img.shields.io/badge/License-BSD%202--Clause-blue.svg)](LICENSE) [![Python](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org) [![Status: alpha](https://img.shields.io/badge/status-alpha-orange.svg)](#whats-next) [![GitHub Stars](https://img.shields.io/github/stars/yzhao062/vibesignal?style=social)](https://github.com/yzhao062/vibesignal)

[Install](#install) · [Quickstart](#quickstart) · [How It Works](#how-it-works) · [Three Renderers](#three-renderers) · [Configure Agents](#configure-agents) · [What's Next](#whats-next)

[!NOTE] **The light is the point.** When Claude Code or Codex needs your reply, a USB light on your desk turns amber. When an agent finishes its turn, it turns blue. While an agent is working, green. A light on the desk is harder to miss than one more notification in the corner of a screen you are already ignoring.

No light on your desk yet? The same signal renders on screen, so you can run VibeSignal today and add the hardware later. The always-on-top widget below stays calm grey while agents work, and turns red the moment a session blocks for your input.

The VibeSignal widget mirrors the desk light on screen: a calm grey panel while agents work, turning red when a session blocks for your input

What You Get

  • 🟢 Solid colors, daemon-free: the state persists in the hardware after the hook exits; no service to keep alive
  • 🪝 Hook-driven: UserPromptSubmit, PostToolUse, Notification, Stop, SessionEnd all wire in via JSON
  • 🤖 Cross-agent: the same store covers Claude Code and Codex; one light tracks both
  • 📺 **T