I Gave Claude Code a Traffic Light

2026-06-27 · Source: Data Science on Medium · Field: Technology & Digital — Artificial Intelligence & Machine Learning, Software Development & Engineering, Internet of Things (IoT) & Connected Devices · Depth: Intermediate, medium

Summary

A developer created a physical traffic light system to provide ambient status updates for Claude Code, an AI agent. This system, built over an afternoon for \$10-\$15 using an ESP32 dev board, three LEDs, and resistors, visually indicates Claude Code's operational state. The light turns red when a prompt is submitted, yellow when Claude requires user input or permission, and green when a turn is completed or a session starts. The core mechanism involves Claude Code's built-in lifecycle hooks ("UserPromptSubmit", "Notification", "Stop", "SessionStart") executing a shell script ("light.sh"). This script sends HTTP requests to the ESP32, which then controls the LEDs. An alternative "ten-minute version" utilizes an off-the-shelf USB busy light and the `busylight` tool, eliminating the need for hardware assembly. This solution aims to provide glanceable, off-screen feedback for autonomous systems, addressing the challenge of monitoring AI agents without constant screen attention.

Key takeaway

For AI Engineers managing autonomous agents like Claude Code, you should consider implementing ambient physical status indicators. This approach frees you from constant screen monitoring, allowing your peripheral vision to track agent states (working, waiting, done). By utilizing agent lifecycle hooks, you can integrate simple, low-cost hardware like an ESP32 or a USB busy light to provide immediate, glanceable feedback, significantly improving your workflow efficiency and reducing context switching.

Key insights

Ambient physical indicators provide low-bandwidth, glanceable status for autonomous AI agents, reducing screen-based monitoring.

Principles

• Decouple signal from display.
• Use AI lifecycle hooks for state changes.
• Screens are poor for ambient status.

Method

Configure Claude Code hooks ("UserPromptSubmit", "Notification", "Stop") to run a shell script. This script sends HTTP requests to an ESP32-based web server, which controls physical LEDs based on the AI's state.

In practice

• Implement a physical status light for AI agents.
• Use ESP32 or USB busy lights for visual cues.
• Explore AI agent hooks for custom integrations.

Topics

• Claude Code
• AI Agent Monitoring
• ESP32
• Physical UI
• Ambient Computing
• Lifecycle Hooks

Code references

• shahzadarain/claude-code-traffic-light

Best for: AI Engineer, Software Engineer, AI Student

Related on AIssential

• The AI Stack Is Moving From Model Access to Model Operations — The AI stack is evolving from single-model access to multi-model operations, requiring a dedicated management layer for diverse provider complexities.
• Designing Systems for LLM Integration: Why Most Advice Assumes Your Latency Budget Is Infinite — Effective LLM integration demands engineering for actual latency mechanics, not merely hiding delays with streaming or UI tricks.
• Why AI Teams Need Safer Model Rollouts — AI model rollouts require structured, measurable, and reversible processes to prevent subtle regressions and ensure production stability.
• I Used AI Agents for 30 Days. My Job Changed Completely. — AI agents fundamentally shift software engineering focus from coding speed to higher-level decision-making and architecture.
• Enterprise AI Agent Certification | Generative AI Business Workflow Training — The shift to AI agents for business execution necessitates robust governance, systematic integration, and specialized skill development.
• I Built Four Cortex Agents on a Semantic Layer — Here’s Where the Governance Actually Lives — AI agent trustworthiness stems from governed context and explicit instructions, not just model intelligence.

Open in AIssential →

Editorial summary, takeaway, and curation by AIssential. Original article published by Data Science on Medium.