M5Paper 是 M5Stack 推出的一款可触控墨水屏设备,采用乐鑫 ESP32 主控 ,正面嵌入了一块分辨率为 540 x 960 的 4.7 寸 的电子墨水屏,支持 16 级灰度显示,集成了拨轮开关、温湿度传感器 SHT30 和物理按键,预留了 TF-card (microSD)接口,还集成了 FM24C02 存储芯片,可提供 2KB 容量的断电存储,内置了 1150mAh 锂电池,借助内部的 RTC(BM8563) 能够实现休眠与唤醒功能,搭配 GT911 电容式触控面板,支持两点触控以及多种手势操作,能为用户提供更优质的文本阅读体验,并且具备低功耗以及掉电图像保持等特性,同时开放了 3 组 HY2.0-4P 外设接口,能够拓展各种各样的传感器设备,为后续的应用功能开发带来了无限的可能性。
当你安装 ai-desk-card 桌面副屏 Skill 后,就可以通过Claude Code / Codex 等 AI Agent 服务推送 widget:天气、日程、todo、PR 队列、AI 状态、休息提醒等,最终显示在 M5Paper 的4.7 寸墨水屏上,把你的M5Paper墨水屏,变成Claude Code的专属物理搭档!多会话看板、硬件一键审批、不用切窗口,甚至还有会变脸的摸鱼小猫。
🖥 桌面副屏:540×960 墨水屏立在显示器旁,工作状态一目了然
🤖 AI 主动推送:Agent 决定推什么 widget、什么时候推;你不用自己开浏览器查天气

🧩 16 种插件:weather / calendar / todo / focus / inbox / pr-queue / ai-status / git-status / now-playing / break-reminder / scratch / messages / deadlines / next-meeting / system / ai-tasks
🎨 服务端渲染:daemon 用 Python + Pillow 渲染像素帧,固件只负责显示;想加新 widget 只改 Python,不用动 C++
🧩 三种供电模式自动切换:USB 常开 / USB 数据线 / 电池 + BLE 待机(几个月续航)
🌐 Wi-Fi 秒刷:本地 HTTP 直推,无云依赖
💤 关屏 0 功耗保留最后一帧:墨水屏特性,电池续航 6 个月

👆 底栏触屏:点"睡眠"推电子名片 + 深度休眠;点"设置"翻设置页。150ms 点击态反馈
⏰ 自动息屏:到 quiet hours 自动切到电子名片,daemon 不需要 Agent 在线
AI Desk Card 墨水屏共有4 个槽位,采用 2-1-1 布局
AI Desk Card 更新链路如下:
你 ──说自然语言──▶ AI Agent ──触发──▶ Skill ──自动执行──▶ M5Paper 屏上

AI Desk Card 常见使用场景
🤖 快速开始
命令行安装
npx skills add https://github.com/op7418/ai-desk-card --skill ai-desk-card
让 AI 帮你自动装

你只需要把下面这段话复制粘贴给 Claude Code / Cursor 即可。
帮我装 ai-desk-card 这个 Skill。请按下面步骤做:
1.确保 ~/.claude/skills/ 目录存在,不存在就创建
2.执行 git clone https://github.com/op7418/ai-desk-card.git ~/.claude/skills/ai-desk-card
3.验证:ls ~/.claude/skills/ai-desk-card/ 应该看到 SKILL.md、flows/、plugin/、daemon/、src/、assets/

4.装好告诉我,之后我说“帮我把卡片装上”就会触发这个 Skill
AI Desk Card Skill 是结构化工作流,Agent 会按下面顺序自动跑:
入职 (flow 01) — 探测 PlatformIO / USB 设备 → 引导你烧固件
传输诊断 (flow 02) — 设备连不上时定位问题
配 Wi-Fi (flow 03) — 把 Wi-Fi 凭证写进设备 NVS

写偏好 (flow 04) — 第一次问"你想看哪些卡片,多久刷一次"
推 widget (flow 05) — 日常推送的热路径
设定时 (flow 06) — Agent 用自己的 loop / cron 定时刷
息屏 (flow 07) — 推电子名片 + 设备深度休眠 0 功耗
AI Desk Card 完整子流程在 flows/ 目录。Skill 主路由在 SKILL.md。

🌟 外挂Agent伴侣演示
自动更新日程和待办:AI Agent 通过飞书 CLI 直接读取飞书日历,更新到墨水屏
GitHub动态更新:GitHub 开源项目有新 PR、有人在 Issue 里 at 我、CI 挂了,AI 都会把它推上去。
日常信息更新:实时天气、运动提醒、TODO List 等
🌳 写在最后

AI Desk Card 跟传统 IoT 设备最大的不同在于16 种 widget 模板预置在服务端,AI Agent 只负责往里面塞 JSON 数据,交互界面完全由 AI 决策,无需用户配置。
Claude Code/Codex重度用户:开N个会话干活的,效率至少提升30%,再也不用切窗口切到晕
桌面极客/折腾党:外挂智能副屏,比普通电子钟、天气屏酷10倍
AI编程内容创作者:直播/录屏的时候把墨水屏放旁边,不用露Claude窗口的隐私,观众还能一眼看到AI的操作状态,专业度拉满
GitHub项目:https://github.com/op7418/ai-desk-card
M5Paper is a touch-enabled e-ink display device released by M5Stack, powered by the Espressif ESP32 microcontroller. Its front features a 4.7-inch e-ink screen with a resolution of 540 x 960 pixels, supporting 16 levels of grayscale. The device integrates a wheel switch, an SHT30 temperature and humidity sensor, physical buttons, and a reserved TF-card (microSD) slot. It also includes the FM24C02 storage chip, which provides 2KB of non-volatile memory for data retention when powered down. With a built-in 1150mAh lithium battery and an RTC (BM8563) for sleep and wake-up functionality, combined with the GT911 capacitive touch panel that supports two-point touch and multiple gestures, this device offers an enhanced text reading experience with low power consumption and image persistence. Additionally, it provides three open HY2.0-4P interfaces for connecting various sensor devices, expanding its potential applications.
Once you have installed the ai-desk-card desktop secondary screen skill, you can use AI agent services like Claude Code or Codex to push widgets such as weather updates, schedules, to-do lists, PR queues, AI status, and rest reminders. These will all be displayed on the 4.7-inch e-ink screen of the M5Paper, transforming it into a dedicated physical display partner for your AI workflow. The device supports multiple conversation tabs, one-click hardware approval, and even includes a fun "loitering cat" animation for idle times.
🖥 Desktop secondary screen: A 540×960 e-ink display mounted next to your monitor, providing a clear view of your working status.
🤖 AI active push: The agent decides what widgets to display and when, eliminating the need to manually check for weather or other updates.

🧩 16 plugins available: options include weather, calendar, to-do, focus, inbox, PR queue, AI status, git status, now playing, break reminder, scratch pad, messages, deadlines, next meeting, system, and AI tasks.
🎨 Server-side rendering: The daemon renders pixel frames using Python and Pillow, while the firmware simply displays them. Adding new widgets requires modifying Python code, not digging through C++.
🔌 Three power modes: USB constant on, USB data cable, or battery + BLE standby (with months of battery life in standby mode).
🌐 Wi-Fi instant refresh: Local HTTP direct push ensures fast updates without relying on a cloud server.
💤 Zero power consumption while off: The e-ink display retains the final frame, providing up to 6 months of battery life while powered down.

👆 Bottom bar touch controls: Tap "sleep" to push a business card and enter deep sleep, or tap "settings" to flip to the settings page. A 150ms visual feedback is provided for clicks.
⏰ Automatic screen off: The device enters a low-power mode with a business card display during quiet hours, without needing additional agent commands.
The AI Desk Card features four widget slots arranged in a 2-1-1 layout for flexible display configuration.
The update pathway for the AI Desk Card is as follows:
You → Natural language command → AI Agent → Trigger → Skill → Automated execution → M5Paper display.

Common use cases for the AI Desk Card include:
🤖 Quick start:
Command-line installation:
npx skills add https://github.com/op7418/ai-desk-card --skill ai-desk-card
Let AI handle the installation:

Simply copy and paste the following prompt to Claude Code or Cursor:
"Help me install the ai-desk-card skill. Please follow these steps:
1. Ensure the ~/.claude/skills/ directory exists; create it if not.
2. Execute: git clone https://github.com/op7418/ai-desk-card.git ~/.claude/skills/ai-desk-card
3. Verify by listing the directory: ls ~/.claude/skills/ai-desk-card/ should show SKILL.md, flows/, plugin/, daemon/, src/, and assets/.

4. Let me know when it's installed, and I'll use the 'Help me set up the card' command."
The AI Desk Card Skill is a structured workflow where the Agent will automatically run the following steps in order:
Onboarding (flow 01): Detects the PlatformIO environment and USB device, then guides you through the firmware flashing process.
Transmission diagnostics (flow 02): Identifies issues if the device fails to connect.
Wi-Fi setup (flow 03): Writes Wi-Fi credentials to the device's NVS memory.

Preference writing (flow 04): Prompts for your desired widgets and refresh intervals.
Widget pushing (flow 05): The primary path for sending data to the screen.
Timer settings (flow 06): The agent uses its internal loop or cron job to schedule periodic updates.
Screen off (flow 07): Pushes a business card and puts the device into deep sleep, minimizing power consumption.
The complete workflow for the AI Desk Card is stored in the flows/ directory, with the main routing logic defined in SKILL.md.

🌟 Demonstration of external agent integration:
Automated calendar and to-do updates: The AI agent reads your Feishu calendar via CLI and updates the e-ink screen accordingly.
GitHub activity updates: If there are new pull requests, mentions on issues, or failed CI builds in your GitHub repository, the AI will push these notifications to the display.
Daily information updates: Includes real-time weather, exercise reminders, and to-do lists.
🌳 Final thoughts:

The AI Desk Card stands out from traditional IoT devices because its 16 widget templates are hosted on the server. The AI agent simply fills them with JSON data, and the user interface is dynamically determined by the AI, requiring no manual configuration from the user.
For heavy users of Claude Code and Codex who juggle multiple sessions, this device can significantly boost efficiency (up to 30%) by eliminating the need to constantly switch between windows.
For desktop enthusiasts and tinkerers, this represents a cool addition to their setup, far surpassing the utility of standard digital clocks or weather displays.
For AI programming content creators, the card serves as a professional visual aid during live streams or recordings, clearly displaying AI operation statuses without revealing sensitive data from browser windows.
GitHub项目:https://github.com/op7418/ai-desk-card