tidbyt-status
by mrscoutshub
Coding Agents & IDEsBrief
HTTP API server that exposes OpenClaw agent status for Tidbyt LED displays.
Description
What This Skill Does
HTTP API server that exposes OpenClaw agent status as JSON, paired with a Starlark app for rendering on Tidbyt 64x32 LED displays. Monitors agent session files and surfaces status, task counts, and recent activity. Supports four status states: chatting, working, thinking, and sleeping.
Puts live agent status on a physical display you can glance at without switching windows or checking logs.
When to Use It
- Check if your AI agent is busy before sending a new task
- Display agent workload on a desk LED display while working
- Monitor background task count at a glance without opening a terminal
- Get notified visually when an agent transitions from working to idle
- Run a persistent status dashboard on a physical device in a home office
Example Workflow
User wants to see Scout's current status on their Tidbyt device
- 1
Start the status API server with
python3 scripts/status_server.py - 2
Update the DEFAULT_API_URL in scout_status.star with the local machine IP
- 3
Run
pixlet render scout_status.starto generate the display image - 4
Run
pixlet push --installation-id Scout <DEVICE-ID> scout_status.webpto push to the Tidbyt
Tidbyt LED display shows Scout's name, animated face reflecting current status, active task count, and scrolling recent activity text
Requirements
- Tidbyt device
- pixlet CLI installed (via Homebrew on macOS or GitHub releases on Linux)
- Tidbyt account (for `pixlet login` and device ID retrieval)
Installation
clawhub install mrscoutshub/tidbyt-statusRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.