LaunchKit · 2026
Back to Skills

tidbyt-status

HTTP API server that exposes OpenClaw agent status for Tidbyt LED displays.

0
430 downloads
by @mrscoutshub

Setup & Installation

openclaw skills install @mrscoutshub/tidbyt-status

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install tidbyt-status

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

Here's how your AI assistant might use this skill in practice.

INPUT

User wants to see Scout's current status on their Tidbyt device

AGENT
  1. 1Start the status API server with `python3 scripts/status_server.py`
  2. 2Update the DEFAULT_API_URL in scout_status.star with the local machine IP
  3. 3Run `pixlet render scout_status.star` to generate the display image
  4. 4Run `pixlet push --installation-id Scout <DEVICE-ID> scout_status.webp` to push to the Tidbyt
OUTPUT

Tidbyt LED display shows Scout's name, animated face reflecting current status, active task count, and scrolling recent activity text

Requirements

Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.

Tidbyt devicepixlet CLI installed (via Homebrew on macOS or GitHub releases on Linux)Tidbyt account (for `pixlet login` and device ID retrieval)