claudeers.
// Other

kindle-claude

Kindle e-ink como painel de mesa do Claude Code, com o Claudinho chef em pixel art

// Other[ api ][ mobile ][ claude ]#claude#claude-code#e-ink#kindle#pixel-art#python#other◷ MIT$open-sourceupdated 28 days ago
Actively maintained
95/100
last commit about 1 month ago
last release none
releases 0
open issues 0

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up kindle-claude (git-clone project) into my current project.
Found on https://claudeers.com/kindle-claude
Repo: https://github.com/guithepc/kindle-claude
Homepage/docs: —
Detected install method: git-clone → git clone https://github.com/guithepc/kindle-claude
Category: other. Platforms: api, mobile.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or clone
git clone https://github.com/guithepc/kindle-claude

// compatibility

Platformsapi, mobile
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguagePython

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

Claudinho no Kindle

Um Kindle velho virou painel de mesa: ele mostra o que o Claude Code está cozinhando agora
e quanto de token já foi pro fogo.

Painel no Kindle alternando entre cozinhando, esperando e descansando

Telas geradas pelo próprio servidor em modo demo, com a moldura desenhada por cima.

O que é

Enquanto o Claude Code trabalha no computador, o Kindle do lado mostra:

  • O que ele está fazendo agora: a ferramenta em uso (Edit, Bash, Grep…) e as últimas que passaram.
  • Quanto da janela de uso já foi: % da sessão de 5h e % da semana, em anéis segmentados, com a hora em que cada um zera.
  • Tokens de hoje, quanto entrou na última hora e a média diária.
  • O Claudinho chef, um mascote em pixel art que muda de animação conforme o estado.

A tela é e-ink: atualiza devagar, não tem cor e não gasta bateria parada. Por isso o design inteiro usa preto, branco e quatro cinzas, e só o mascote se mexe.

Os estados

CozinhandoEsperando vocêDescansando
TrabalhandoEsperandoDescansando
O Claude está trabalhando. A barra "No fogo agora" mostra a ferramenta atual.Terminou e está esperando você (ou pedindo permissão, com o sino tocando mais rápido).Parado há mais de 30 minutos.

Com vários agentes rodando ao mesmo tempo, o painel mostra a sessão mais urgente: pedindo permissão > trabalhando > terminou > descansando.

O Claudinho chef

Sete animações de 2 quadros cada, desenhadas numa grade de 36×24 pixels.

SopaCebolaFrigideiraTempero
Mexendo a sopaCortando cebolaFrigideira pro altoTemperando
PratoEsperandoDescansando
Prato prontoTocando o sinoCochilando com café

Enquanto o Claude trabalha, o servidor sorteia blocos de sopa, cebola, tempero e frigideira. A ideia original era uma animação por ferramenta, mas as ferramentas duram menos de um segundo e o Kindle só olha a cada 30. O processo de design está em docs/design.md.

Como funciona

flowchart LR
  A[Claude Code<br/>hooks + statusLine] --> B[data/*.json]
  H[~/.claude/projects<br/>históricos] --> C
  B --> C[server.py<br/>renderer Pillow]
  C -->|PNG via Wi-Fi, a cada 30 s| D[Kindle<br/>scriptlet + eips]
  1. Os hooks do Claude Code gravam o estado de cada sessão em data/state.json.
  2. A statusLine guarda o % de uso da sessão e da semana em data/statusline.json, e continua mostrando a statusLine que você já tinha.
  3. O servidor lê isso, soma os tokens dos históricos em ~/.claude/projects, desenha a tela 800×600 com Pillow e gira 90° pra tela em pé do Kindle.
  4. O Kindle puxa pelo Wi-Fi a cada 30 s: lê /status.txt e baixa uma tela inteira por quadro da animação, só quando algo mudou. O computador nunca empurra nada.

Detalhes de cada peça em docs/como-funciona.md.

Instalação

O que você precisa

  • Kindle com jailbreak. Testado num Kindle básico de 8ª geração (2016), firmware 5.15.1, tela 600×800. O jailbreak usado foi o WinterBreak2 (firmwares abaixo de 5.16.4). Siga o guia do Kindle Modding pro seu modelo. No Kindle não precisa instalar mais nada: o script usa curl, eips e lipc-set-prop, que já vêm no sistema.
  • Computador com macOS ou Linux, Python 3.9+ e Pillow. Windows não funciona ainda (o hook.py usa fcntl).
  • Claude Code rodando no mesmo computador do servidor.
  • Kindle e computador na mesma rede Wi-Fi.

No computador

git clone https://github.com/guithepc/kindle-claude.git
cd kindle-claude
pip3 install --user pillow
python3 setup.py          # liga os hooks e a statusLine no ~/.claude/settings.json (faz backup antes)
python3 server.py         # deixe rodando

Reinicie as sessões do Claude Code que já estavam abertas, pra elas passarem a mandar eventos.

Confira no navegador: http://localhost:8787/preview.png?demo=esperando

Anote o IP do computador na rede (no macOS: ipconfig getifaddr en0).

No Kindle

  1. Edite kindle/claude_dash.sh e troque o IP:
    MAC="<IP_DO_COMPUTADOR>"
    PORT=8787
    
  2. Ligue o Kindle no cabo e copie claude_dash.sh pra pasta documents.
  3. Ejete, conecte o Kindle no mesmo Wi-Fi e toque em Claude Dash na biblioteca. A tela aparece em alguns segundos.

Configuração

OndeOpçãoPadrão
kindle/claude_dash.shMAC: IP do computadorIP_DO_MAC
PORT8787
POLL: segundos entre leituras30
FULL_EVERY: atualizações parciais antes de um refresh completo10
variável de ambienteKINDLE_DASH_PORT8787
KINDLE_DASH_ROTATE: 90 = logo "kindle" à esquerda, 270 = à direita90

No dia a dia

AçãoComo
Iniciar o servidorpython3 server.py (a janela precisa ficar aberta)
Iniciar o servidor sozinho (macOS)sh servico.sh registra um LaunchAgent que sobe no login. sh servico.sh remover desfaz. Não testado.
Iniciar no Kindletocar em Claude Dash na biblioteca
Parar o painelabrir http://localhost:8787/parar. O Kindle sai na próxima leitura (até 30 s) e volta pra tela inicial. Reiniciar o Kindle também resolve.
Remover os hookspython3 setup.py remover

Enquanto o painel roda, o script impede a proteção de tela e mantém o Wi-Fi ligado. Deixe o Kindle no carregador. Se o computador dormir, o Kindle mostra "sem conexão com o Mac…" até ele voltar.

Estrutura

kindle-claude/
├── server.py            servidor HTTP + renderer (Pillow): monta a tela, gira e serve pro Kindle
├── hook.py              hook do Claude Code: grava o estado de cada sessão em data/state.json
├── statusline.py        statusLine: guarda o % de uso (5h e semana) e repassa a sua statusLine antiga
├── setup.py             instala/remove hooks e statusLine no ~/.claude/settings.json (com backup)
├── servico.sh           registra o servidor como LaunchAgent do macOS
├── sprites.json         os 14 quadros do Claudinho chef em grade 36×24
├── kindle/
│   └── claude_dash.sh   scriptlet que roda no Kindle (copiar pra documents/)
├── tools/
│   ├── build_sprites.py converte os quadros exportados do Paper em sprites.json
│   ├── sprites_src.json paths SVG dos quadros exportados do Paper
│   └── readme_media.py  gera as imagens deste README
├── design/
│   ├── paper/           telas e explorações exportadas do Paper
│   └── pixelart/chef.py o Claudinho escrito em ASCII
├── docs/                design, funcionamento e solução de problemas
├── fonts/               Inter Tight e JetBrains Mono (licença OFL)
└── data/                gerado em tempo de execução (fora do git)

Limitações

  • Só enxerga o Claude Code rodando no mesmo computador do servidor. Conversas no app do Claude e agentes em máquinas remotas não aparecem.
  • O % de uso só existe em planos Pro/Max e aparece depois da primeira resposta da sessão.
  • O total de tokens inclui leitura de cache, por isso fica alto.
  • Layout feito pra tela 600×800 e testado só no macOS e num único Kindle.
  • A animação em blocos sorteados foi validada em simulação. A validação visual no aparelho ainda está pendente.
  • Pra sair do painel pelo próprio Kindle, só reiniciando.

Problemas encontrados no caminho e como resolver: docs/problemas.md.

Créditos

Design feito no Paper. Sprites, anéis e telas gerados por código. Fontes Inter Tight e JetBrains Mono, licença OFL.

Projeto pessoal, sem afiliação com a Anthropic. O Claudinho é fan art inspirada no mascote do Claude Code.

Licença

MIT. As fontes em fonts/ seguem as próprias licenças OFL.

// faq

What is kindle-claude?

Kindle e-ink como painel de mesa do Claude Code, com o Claudinho chef em pixel art. It is open-source on GitHub.

Is kindle-claude free to use?

kindle-claude is open-source under the MIT license, so it is free to use.

What category does kindle-claude belong to?

kindle-claude is listed under other in the Claudeers registry of Claude-compatible tools.

34 views
★ 19 stars
unclaimed
updated 28 days ago

// embed badge

kindle-claude on Claudeers
[![Claudeers](https://claudeers.com/api/badge/kindle-claude.svg)](https://claudeers.com/kindle-claude)

// retro hit counter

kindle-claude hit counter
[![Hits](https://claudeers.com/api/counter/kindle-claude.svg)](https://claudeers.com/kindle-claude)

// reviews

// guestbook

0/500

// related in Other

🔓

符合nature论文学术表达和科研绘图的Skill

// otherYuan1z0825/⟨Python⟩★ 54,085◷ Apache-2.0[ claude ]
🔓

Anti-AI-slop design skill for Claude Code, Cursor, and Codex.

// otherNutlope/⟨CSS⟩★ 49,642◷ MIT[ claude ]
🔓

Huashu Design · HTML-native design skill for Claude Code · Claude Code 里 HTML 原生的设计 skill · 高保真原型 / 幻灯片 / 动画 + 20 设计哲学 + 5 维评审 + MP4 导出 · Agent-agnostic

// otheralchaincyf/⟨HTML⟩★ 28,944◷ MIT[ claude ]
🔓

Open source Ghostty-based macOS terminal with vertical tabs and notifications for AI coding agents. Built for multitasking, organization, and programmability.

// othermanaflow-ai/⟨Swift⟩★ 28,842◷ NOASSERTION[ claude ]
→ see how kindle-claude connects across the ecosystem