PromLight setup guide

How PromLight turns AI agent work into a desk signal

A practical setup guide for a rechargeable Bluetooth status light that maps Claude Code, Codex, Cursor, Copilot, and Qoder states to red, yellow, and green signals.

PromLight AI Signal Light with red yellow and green LEDs

Agent states

busy, waiting for confirmation, error, complete

Mapped to yellow, yellow blink, red blink, and green steady signals.

Connection

Bluetooth 5.3, about 20 m rated range

Walls, furniture, and interference can reduce real range.

Power

400mAh battery, USB-C charging

Source material rates about 4 to 5 days at 8 hours per day.

Platforms

Windows and macOS desktop app

Linux, phones, and tablets are not currently supported.

Turn invisible agent states into physical cues

The core value is not decoration. PromLight makes background AI work visible while you code, review, or step away from the desk.

  • Yellow steady means the agent is still busy.
  • Yellow blink means the workflow is waiting for your confirmation.
  • Red blink means the workflow hit an error.
  • Green steady means the task is complete.

Use the desktop app as the bridge

The light is hardware, but the practical workflow depends on the companion app watching agent events and sending light commands over Bluetooth.

  • Keep the desktop app running in the background.
  • Use the device list to confirm which light is connected.
  • Review hook logs when an agent state is not reflected correctly.

Place it where peripheral vision can catch it

The compact body and red, yellow, and green LEDs are best used where you can notice the state without turning it into another screen to watch.

  • Use the clip or elastic strap on a stable nearby surface.
  • Keep the USB-C charging port reachable.
  • Avoid hiding it behind monitors, speakers, or laptop lids.

Check compatibility before ordering

The source material gives useful boundaries, and the site keeps those boundaries visible before checkout.

  • Windows and macOS are the supported desktop platforms listed.
  • Linux, phones, and tablets are not currently supported.
  • Claude Code, Codex, Cursor, Copilot, and Qoder are listed as supported AI workflows.

Set up the light before the next long agent run

PromLight depends on Bluetooth pairing, a desktop app, and the hooks that map AI workflow events to light states. Test the full chain once while you are still at the desk.

1

Charge the light

Use the USB-C port for charging. The port is not the computer connection.

2

Install the desktop app

Run the PromLight desktop app on Windows or macOS and allow it to stay active in the background.

3

Pair over Bluetooth

Connect the PromLight unit through the local control panel and confirm it appears in the device list.

4

Bind the AI workflow

Enable the hook or integration for the AI coding workflow you use, then watch the event log for status changes.

5

Test the state colors

Use manual commands or a small agent task to confirm busy, waiting, error, and complete signals before relying on it during a real session.

Use the guide to verify fit before checkout

PromLight is for Windows and macOS desktop AI workflows. The site avoids claims about Linux, phones, tablets, certifications, waterproofing, or cloud behavior because the provided evidence does not prove them.

Shop PromLight

PromLight FAQ

Compatibility, setup, and claim boundaries for a small Bluetooth status light used with AI coding workflows.

What is PromLight AI Signal Light?

PromLight is a rechargeable Bluetooth desk light for AI coding-agent workflows. It turns background agent states into red, yellow, and green physical signals so you can step away from the screen without missing important state changes.

Which AI tools does it support?

The source material lists Claude Code, Codex, Cursor, Copilot, and Qoder. Do not assume every version or every third-party fork is supported until the desktop app confirms it.

What do the light states mean?

The listed mapping is yellow steady for busy, yellow blink for waiting for confirmation, red blink for error, and green steady for complete.

Does USB-C connect the light to the computer?

No. The USB-C port is for charging only. The computer connection is wireless over Bluetooth.

How far can it work from the computer?

The product material lists about 20 m effective distance over Bluetooth 5.3. Real-world range can be lower when walls, furniture, metal surfaces, or wireless interference are present.

How long does the battery last?

The source material lists a 400mAh lithium battery rated for about 4 to 5 days when used 8 hours per day. Actual runtime depends on brightness, blink patterns, and connection behavior.

Can one computer connect to multiple lights?

The source material says one computer can connect to multiple PromLight units. It does not provide a reliable maximum count, so the site does not claim one.

Does it work on Linux, phones, or tablets?

The listed platform support is Windows and macOS. Linux, phones, and tablets are not currently supported by the source material.

Does the desktop app need to stay open?

The source material describes a PC program designed to run in the background and start with the computer. The light depends on that local app for agent status mapping.

What does the control panel do?

The captured control panel shows a device list, per-light controls, event or hook logs, and manual command controls.

How does it mount on a desk or monitor?

The product material shows a back clip and elastic strap. That supports simple placement on a desk setup, but buyers should confirm their exact mounting surface before relying on it.

How big is the light?

The listed body size is about 25 x 67 x 21 mm, compact enough for a monitor edge, desk shelf, or nearby stand.

Does the product need cloud access?

The provided material proves Bluetooth hardware and a local control panel, but it does not prove a no-cloud design. The site therefore avoids claiming offline-only or cloud-free behavior.

Is it CE, FCC, or RoHS certified?

The provided source material does not include certification proof, so the site does not claim CE, FCC, RoHS, waterproofing, drop resistance, or similar compliance properties.

What is included?

The source material clearly shows the PromLight device and a charging cable. It also shows clip and strap mounting hardware. Any bundle-specific extras should be confirmed at checkout.

Who is it for?

It is for developers, builders, and AI-heavy operators who run coding agents in the background and want a physical signal for work that is busy, blocked, errored, or complete.