← Back to Skills Marketplace
Tidbyt Status Display
by
MrScoutsHub
· GitHub ↗
· v1.0.0
638
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install tidbyt-status
Description
Provides an HTTP API exposing OpenClaw agent status as JSON for displaying on Tidbyt 64x32 LED devices with activity, emoji, and task details.
Usage Guidance
This package appears to do what it says: run a small local HTTP server that inspects ~/.openclaw/agents/main/sessions/*.jsonl metadata and serves a JSON /status endpoint for a Tidbyt app. Before installing, note: 1) The Tidbyt Starlark file (scout_status.star) and a packaged .skill file are referenced in the docs but are not included — you will need that .star app to render/push to your Tidbyt. 2) The server returns CORS: '*' and the docs show opening TCP port 8765; if you expose this port to a wider network or the internet, your agent's status (and timestamps/filenames) will be publicly accessible — consider restricting access (firewall rules, local-only binding, VPN, or add authentication/TLS) if privacy matters. 3) The code only uses file metadata (modification times and filenames) and does not read session file contents, but you should review ~/.openclaw/agents/main/sessions/ yourself to confirm it contains only metadata you are comfortable exposing. 4) Installing the systemd service requires sudo and will run the server as your user; verify the ExecStart path and the service file before enabling. If you want the extra assurance, ask the author to include the missing scout_status.star file and the packaged skill, and consider adding optional basic auth or IP-restriction to the status endpoint.
Capability Analysis
Type: OpenClaw Skill
Name: tidbyt-status
Version: 1.0.0
The OpenClaw skill 'tidbyt-status' is designed to expose the agent's status via a local HTTP API for Tidbyt LED displays. The `scripts/status_server.py` file correctly implements this by reading agent session files (`~/.openclaw/agents/main/sessions/*.jsonl`) and serving status JSON on a local port (default 8765). The `install.sh` script and `SKILL.md` provide clear, user-facing instructions for setup, including options for background execution and systemd service creation, which requires explicit user `sudo` commands. There is no evidence of prompt injection against the agent, data exfiltration, unauthorized remote access, or any other malicious intent. All observed behaviors align with the stated purpose of providing an agent status display.
Capability Assessment
Purpose & Capability
The skill claims to expose agent status for Tidbyt and the included Python server reads ~/.openclaw/agents/main/sessions/*.jsonl to determine activity and returns the declared JSON fields; the install helper and SKILL.md steps focus on running the server and using Pixlet. Reading the sessions directory is coherent with the stated goal.
Instruction Scope
Runtime instructions only ask to run the included status_server.py and use Pixlet to render the Tidbyt app. SKILL.md references a Tidbyt Starlark app (scout_status.star) and a packaged skill file (tidbyt-status.skill) that are not present in the manifest — you'll need to obtain or create that .star file to complete the integration. The server only uses file metadata (mtime, filenames) and does not read session file contents.
Install Mechanism
No automated install from remote URLs or package registries; an install.sh helper and a systemd example are included. The script does not download external code. Recommended third-party install (Pixlet) is sourced from the project's official release locations (Homebrew or GitHub releases) as described in docs.
Credentials
The skill requests no environment variables, credentials, or config paths beyond accessing files under the user's home (~/.openclaw). That access is proportional to determining agent activity. Note: the server sets CORS to '*' and the docs advise opening firewall ports — both of which broaden exposure and should be considered before placing the service on a network reachable by untrusted hosts.
Persistence & Privilege
The skill is not always-enabled and does not request elevated platform privileges. The systemd instructions require sudo to install the service (normal for creating system services) but the skill does not attempt to modify other skills or global configuration.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install tidbyt-status - After installation, invoke the skill by name or use
/tidbyt-status - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Real-time agent status display with animated faces for Tidbyt 64x32 LED displays. Includes API server and Starlark app.
Metadata
Frequently Asked Questions
What is Tidbyt Status Display?
Provides an HTTP API exposing OpenClaw agent status as JSON for displaying on Tidbyt 64x32 LED devices with activity, emoji, and task details. It is an AI Agent Skill for Claude Code / OpenClaw, with 638 downloads so far.
How do I install Tidbyt Status Display?
Run "/install tidbyt-status" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Tidbyt Status Display free?
Yes, Tidbyt Status Display is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Tidbyt Status Display support?
Tidbyt Status Display is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Tidbyt Status Display?
It is built and maintained by MrScoutsHub (@mrscoutshub); the current version is v1.0.0.
More Skills