Skip to content
TakoAPI
Back to skills

tidbyt-status

by mrscoutshub

Coding Agents & IDEs
430Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

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

INPUT

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

AGENT
  1. 1

    Start the status API server with python3 scripts/status_server.py

  2. 2

    Update the DEFAULT_API_URL in scout_status.star with the local machine IP

  3. 3

    Run pixlet render scout_status.star to generate the display image

  4. 4

    Run 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

  • 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-status

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links