loopbrew

loopbrew / codex-lamp

Public

Codex lamp

19
0
89% credibility
Found May 21, 2026 at 19 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

Codex Lamp is a small utility that connects a Moonside smart lamp to Codex, an AI coding assistant. When you interact with Codex, the lamp automatically changes color to show what's happening: blue and animated when the AI is working on your request, purple when it needs your approval, and warm amber when it's idle. The project uses a background program that keeps a Bluetooth connection to the lamp and watches for state changes. It's designed to be lightweight and fast so it doesn't slow down Codex, and it includes a testing tool to verify everything works before connecting to Codex. After 30 minutes of idle time, the lamp automatically turns off.

How It Works

1
💡 You discover a way to make your lamp react to your AI coding assistant

Someone shares a project that connects a smart lamp to Codex, so the lamp changes color based on what the AI is doing.

2
📦 You install the lamp control scripts

You copy the project files to a special folder on your computer where Codex can find them.

3
🔍 You test that your lamp can receive commands

You run a quick test to make sure your Mac can talk to your lamp over Bluetooth.

4
🔗 You connect the scripts to Codex

You add a simple configuration file that tells Codex to run the lamp scripts when important events happen.

5
✨ Your lamp lights up blue when Codex starts working

The moment of magic: you submit a prompt and watch your lamp burst into an animated blue glow, letting you know the AI is thinking.

6
Different moments trigger different colors
💜
Purple light means Codex needs your approval

When the AI wants to do something that needs your permission, the lamp turns purple so you know to check your screen.

🟡
Warm amber means everything is idle

When Codex finishes a task or is waiting for you, the lamp settles into a calm warm glow.

🎉 You have a physical indicator of your AI's activity

From across the room, you can tell if Codex is thinking, waiting for approval, or done. No more wondering if it's working.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 19 to 19 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is codex-lamp?

Codex-lamp is a physical status indicator that turns a Moonside smart lamp into a visual signal for Codex activity. When you submit a prompt, the lamp pulses blue. When Codex needs your approval for a sensitive action, it glows purple. When the turn finishes, it settles into warm amber. The project runs a Python daemon that watches for Codex hook events and sends Bluetooth commands to the lamp, keeping the hook scripts themselves fast and quiet. It requires macOS, a Moonside lamp that speaks Nordic UART Service commands, and the bleak Bluetooth library.

Why is it gaining traction?

This hits a real pain point: context switching between your terminal and whatever you're working on. Instead of watching the CLI for permission prompts, you get an ambient, peripheral signal. The design is deliberately minimal -- the hook writes a state file and exits immediately, while a background daemon owns the persistent Bluetooth connection. This keeps Codex responsive even if the lamp is slow or unreachable. The included tester script lets you validate your Bluetooth stack, Python environment, and lamp commands before touching Codex configuration at all.

Who should use this?

Developers who run Codex in a separate terminal window and want ambient awareness without glancing over. Particularly useful if you context-switch frequently or work in a noisy environment where audio notifications get lost. If you already have a Moonside lamp and use Codex on macOS, this is a low-effort quality-of-life upgrade. Not for Windows or Linux users, and not useful if you prefer to keep Codex output always visible.

Verdict

This is a niche but well-executed project for a specific hardware setup. The documentation is thorough and the architecture is sound, but with only 19 stars and no visible test suite, it is early-stage software. The 0.899% credibility score reflects that maturity gap. Try it if you have the hardware; wait for more community feedback if you do not.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.