InksPet follows semantic versioning. Major versions
introduce new agent states or breaking changes to the hook protocol.
Minor versions add display features or new LED effects.
Patch versions ship bug fixes only โ always safe to install.
Version bump to validate the release pipeline. No functional changes from v1.0.1.
๐ง Internals
Version bump only โ confirms end-to-end build, packaging, and web installer pipeline is working correctly
Display quality fix โ the e-paper panel no longer fades after repeated updates.
The screen now redraws only when content actually changes, keeping refreshes to a minimum and contrast consistently sharp.
๐ฅ Display
Replaced partial refresh with full refresh โ eliminates the progressive contrast fade (screen going lighter) that appeared during long working sessions
Content-change detection: display skips a refresh cycle when state, agent, tool, file, and task progress are all unchanged โ no wasted refresh on identical frames
Session elapsed time now shown only when the agent reaches Completed state (total task duration), rather than updating every 10 seconds during work
Fixed: _forceFullRefresh flag was silently ignored in Time Mode after wake from hibernate
Fixed: double full-refresh immediately after waking from idle hibernate (anti-ghosting timer now resets on wake)
๐ง Internals
Removed dead fullRefresh() / partialRefresh() stub methods that were no-ops
Extracted buildAgentDisplayInfo() helper โ state-change callback and periodic refresh now share a single implementation
Removed 10-second periodic refresh timer that triggered unnecessary screen updates
First public release of InksPet firmware โ Clawd the crab lives on your EleksCava e-paper display,
reacting in real time to Claude Code and other AI coding agents.
Pixel-art states, RGB LED sync, physical button approval, and a zero-config web dashboard.
โจ Agent Experience
12 pixel-art Clawd crab states: idle, thinking, working, typing, testing, reviewing, celebrating, confused, error, permission, sleeping, offline
RGB LED color sync โ the physical LED matches the current agent state
Partial e-paper refresh for smooth state transitions without full-screen flicker
Real-time tool call statistics (read / write / bash / search) on the dashboard
๐ Physical Controls
Hardware buttons A / B / C map to Approve / Always Allow / Deny for agent permission prompts
No more window switching โ approve AI tool calls without leaving your editor
Long-press button C to enter captive-portal WiFi provisioning mode
๐ Connectivity & Setup
Captive-portal WiFi provisioning โ connect to the InksPet_XXXX hotspot from any phone
mDNS discovery โ open the dashboard at http://inkspet.local with no IP lookup
WebSocket live event stream for zero-latency state updates from the AI assistant
One-click Hook Setup โ copy a single prompt and paste it into Claude Code / Cursor / Aider / any AI assistant; hooks configure themselves
๐ง Hardware & Firmware
ESP32 + 1.54" e-paper display support (EleksCava reference board)
Browser-based USB-C flashing via ESP Web Tools โ no drivers, no IDE, no command line
SPIFFS assets partition for pixel art & web dashboard โ OTA-ready for future versions
Low-power idle: device sleeps to <5mA between agent events
๐ Documentation
Open-source hardware schematics & firmware under MIT license