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.