A specialized integration that visualizes real-time AI agent status and activity on Tidbyt 64x32 LED hardware displays.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tidbyt-status
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install tidbyt-status using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Tidbyt Status Scout Display?
Tidbyt Status is a powerful monitoring tool designed for users of Openclaw Skills who want a physical, glanceable dashboard for their AI agents. By running a local HTTP API server, this skill exposes critical agent metrics—such as current task counts, activity levels, and session states—to the Tidbyt platform.
The skill includes a custom Starlark application that renders dynamic animations and status-specific facial expressions on the 64x32 pixel LED matrix, providing a unique living presence for your digital scouts. This integration bridges the gap between background AI processes and your physical workspace, ensuring you always know when your agent is thinking, working, or idling within the ecosystem of Openclaw Skills.
Tidbyt Status Scout Display Use Cases
- Monitoring long-running AI sub-agent tasks without checking a terminal or IDE.
- Creating a dedicated hardware status dashboard for your home office or developer desk.
- Visualizing agent activity levels and session states using custom LED animations.
- Integrating Openclaw Skills with smart home hardware for ambient notifications.
How Tidbyt Status Scout Display Works
- The Status API Server monitors the local session directory for changes in JSONL log files generated by the agent.
- The server parses recent activity to determine the agent's current state, such as chatting, working, thinking, or sleeping.
- A local HTTP endpoint is exposed at port 8765, serving a JSON payload containing the agent's name, emoji, status, and task count.
- The Tidbyt Starlark app fetches this data periodically from the local network address.
- The app renders a 64x32 pixel interface with animated faces and scrolling text based on the received status from Openclaw Skills.
Tidbyt Status Scout Display Setup
First, start the API server within your environment:
cd ~/.openclaw/workspace/skills/tidbyt-status
python3 scripts/status_server.py
Next, install the Pixlet development tool to communicate with your Tidbyt hardware:
brew install tidbyt/tidbyt/pixlet
pixlet login
Finally, update the API URL in scout_status.star to match your local IP, render the app, and push it to your device:
pixlet render scout_status.star
pixlet push --installation-id Scout <YOUR-DEVICE-ID> scout_status.webp
Tidbyt Status Scout Display Data Schema & Taxonomy
The skill tracks activity by monitoring session logs within the directory structure used by Openclaw Skills. It exposes the following data structure via the API:
| Field | Description | Type |
|---|---|---|
| agent | Name of the active agent (e.g., Scout) | String |
| status | Current state: chatting, working, thinking, or sleeping | String |
| active_tasks | Count of concurrent sub-agent sessions | Integer |
| recent_activity | Description of the most recent action or activity log | String |
| timestamp | ISO 8601 formatted time of the status update | String |
Tidbyt Status Scout Display Advanced Features
- Intelligent status detection logic based on file modification timestamps in the session directory.
- Support for background service deployment using systemd for persistent, always-on monitoring.
- Fully customizable activity thresholds to define the boundary between idle and sleeping states.
- Dynamic LED color rendering that changes based on real-time task complexity and agent engagement.
- Extensible API port configuration to allow multiple Openclaw Skills to report to different displays.
SKILL.md
Loading
Related Openclaw Skills
RUNE Prompt Amplification
RUNE transforms flat, ambiguous prompts into structured 8-layer XML prompts using a semantic engine to deliver significantly higher quality AI responses.
Supervisor
An autonomous agent skill that monitors server health and automatically repairs failed services and containers.
R2 Storage Management
A comprehensive interface for managing Cloudflare R2 object storage through boto3 and S3-compatible APIs within an AI agent environment.
Notion Workspace Skill
A comprehensive Python-based toolset for managing Notion pages, databases, and content blocks through the official REST API.
Social Scheduler Skill
A free, open-source social media automation tool designed for AI agents to schedule posts and threads across major platforms.
Social Scheduler Skill
A comprehensive automation tool for Openclaw Skills that enables AI agents to schedule and publish content across multiple social media platforms simultaneously.
Featured*
