litdemon

Geekmagic Hook — Development skill for Claude Code

Development community

Claude Code hooks for GeekMagic SmallTV-Ultra display.

How to install Geekmagic Hook

This entry records only its repository, not the path inside it, so there is no exact command to give. Open litdemon/geekmagic-hook and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Geekmagic Hook does

Claude Code hooks for GeekMagic SmallTV-Ultra display.

Alternatives in Development

Claude Canvas — A TUI toolkit that gives Claude Code its own display 1.4k ★
Dao Code — Open-source TypeScript terminal coding agent for DeepSeek-V4 — builds on DeepSeek's strong price-performance a 1.3k ★
Pohuy — Переключить уровень мата (lite/full/ultra) 1.1k ★

README

geekmagic-hook

Show your **Claude Code** working state on a **GeekMagic SmallTV-Ultra** pixel display — in real time, via Claude Code hooks.

What it does

Every time Claude Code changes state (thinking, using a tool, waiting, rate-limited, done), a matching GIF plays on your GeekMagic display automatically.

Claude Code State	GIF shown
Session first start	`starting.gif`
Prompt received (subsequent)	`prompt_received.gif`
Calling a tool (Bash, Read, Edit…)	`calling_tools.gif`
Tool finished, still working	`working.gif`
Idle — waiting for next prompt	`waiting.gif`
Waiting for your permission	`permission.gif`
Rate-limited	`rate_limited.gif`

Requirements

GeekMagic SmallTV-Ultra on the same Wi-Fi network
Claude Code CLI
Python 3.9+
pipx (recommended) or pip

Quick Start

# 1. Install
pipx install git+https://github.com/litdemon/geekmagic-hook

# 2. Auto-discover device, upload GIFs, register hooks
geekmagic_hook setup

# 3. Restart Claude Code — done!

Or with pip:

pip install git+https://github.com/litdemon/geekmagic-hook
geekmagic_hook setup

CLI Reference

geekmagic_hook setup              # discover device + register Claude Code hooks
geekmagic_hook uninstall          # remove all hooks
geekmagic_hook status             # device info + hook registration status
geekmagic_hook test               # cycle through all states visually (2s each)
geekmagic_hook discover           # re-scan network (useful after IP change)
geekmagic_hook logs               # tail the hook log
geekmagic_hook theme list         # list GIFs on device
geekmagic_hook theme upload  # upload a custom theme folder

See [`geekmagic_hook/README.md`](geekmagic_hook/README.md) for full documentation.