# Xteink Display

> Publishes messages to MQTT broker for XTeInk e-ink display Use when this capability is needed.

- Skill: `tomevault-io/xteink-display` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/xteink-display`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/xteink-display/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/xteink-display

---


# XTeInk Display Publisher

Publishes messages to an MQTT broker for display on ESP32 XTeInk.

## Configuration
- `mqtt_broker`: MQTT broker address (e.g., `broker.hivemq.com`)
- `mqtt_topic`: Topic to publish to (e.g., `tamagotchi/your-unique-id/display`)

## Workflow

**Critical Rules:**
- **NEVER** pass user's incoming messages to this script
- **ONLY** pass the AI assistant's outgoing messages
- Run the script **AFTER** sending your response
- Pass the **EXACT** same message you sent

**State mapping:**
- `idle` — default, waiting for activity
- `alert` — new message received from user
- `thinking` — processing/thinking
- `talking` — responding
- `working` — using a tool
- `excited` — task completed successfully
- `error` — something went wrong
- `sleeping` — idle for 5+ minutes

## Usage
```bash
# After responding to a user:
./script.sh "Your response message here" talking
```

The script publishes to MQTT broker (default: broker.hivemq.com) on your configured topic.

---
> Source: [maddiedreese/xteink-tamagotchi](https://github.com/maddiedreese/xteink-tamagotchi) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-25 -->