card-widget

Push validated widget data to the ai-desk-card daemon at 127.0.0.1:9877.

136|10|Updated May 21, 2026
One-click install
npx skills add https://github.com/op7418/ai-desk-card --skill card-widget
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: card-widget
Source: https://github.com/op7418/ai-desk-card/tree/main/plugin/skills/card-widget
Command: npx skills add https://github.com/op7418/ai-desk-card --skill card-widget

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyserial, jsonschema, and includes scripts (resource) and assets (resource) components.

What problem does it solve?

This Skill enables pushing glanceable widget data to the 540×960 ai-desk-card M5Paper e-ink display, so you get timely information without switching apps.

Core Features & Use Cases

  • Push 1-4 widgets to the local card daemon (127.0.0.1:9877) to render a single frame and update the display.
  • Supports a catalog of 16 widget types (weather, calendar, todo, inbox, ai-status, etc.) with layout guidance and per-slot optimization.
  • Runs end-to-end with deterministic tasks via the included scripts (push_widget.py) and automatic transport selection (Wi‑Fi/USB/BLE) for fast, offline-friendly updates.

Quick Start

Show weather and calendar on my ai-desk-card.

Frequently Asked Questions about card-widget

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I push live widgets to an M5Paper e-ink display?

Push live widgets to an M5Paper e-ink display by sending validated widget data to the local card daemon at 127.0.0.1:9877, which renders the frame and updates the screen automatically.

What types of widgets can I display on an ai-desk-card?

The ai-desk-card supports 16 widget types including weather, calendar, todo, inbox, and ai-status, allowing you to push 1-4 widgets per frame with layout guidance and per-slot optimization.

Does the widget push daemon validate data against JSON schemas?

Yes, the widget push daemon validates all widget data against JSON schemas before transmission, ensuring data integrity and gracefully handling transport errors during the display update.

Can I update my e-ink display widgets without an active Wi-Fi connection?

Yes, you can update e-ink display widgets offline because the system features automatic transport selection that supports Wi-Fi, USB, and BLE connections for fast and offline-friendly updates.

Do I need pyserial to run scripts for pushing widget data?

Yes, pyserial is a required dependency for running the deterministic push_widget.py script, which handles the end-to-end process of sending widget data to the ai-desk-card daemon.