convez.ai
PluginUtilidadesIniciante
SuWeishengya

Claude Neko

SuWeishengya/Claude-Neko

Gato animado que mostra o status do Claude Code em tempo real

Ver no GitHub
BomPluginScore · de 0 a 100

Um mascote de gato desktop que acompanha o Claude Code no Linux, exibindo em tempo real o estado de trabalho (pensando, codificando, executando, etc). Oferece 10 animações de estado, efeitos de partículas, múltiplos temas de cor e integração nativa com a CLI do Claude Code.

Instalação

$npx convez-ai SuWeishengya/Claude-Neko

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
0
Saúde
71%
Último commit
há 5 meses
Versão
v0.1.0
Issues abertas
0
Contribuidores
2

Casos de uso

  • Monitorar visualmente o progresso de execução do Claude Code
  • Receber feedback visual instantâneo sobre erros ou conclusão de tarefas
  • Adicionar elemento lúdico ao fluxo de trabalho de desenvolvimento

Veredito

Ferramenta criativa que gamifica a experiência do Claude Code com animações genuínas e feedback visual. Implementação sólida em GTK3, mas com nicho específico para usuários Linux que já usam Claude Code CLI.

README

A tradução para o português deste README ainda está na fila.

Claude Neko


Claude Neko 是 Claude Code 的桌面宠物伴侣。一只小橘猫实时显示 Claude 的工作状态——空闲时眨眼、思考时沉思、写代码时打字、完成后开心跳跃。

基于 GTK3 + Cairo 绘制,RGBA 透明背景,支持 Wayland 和 X11。

功能特性

10 种状态动画

状态精灵图触发条件显示文字
idle空闲等待输入Ready
think用户提交问题Thinking...
busy执行工具(Bash/Read…)工具名
typing写代码(Edit/Write)Coding...
subagent调用子代理Helper...
attention等待审批等待审批: 工具名
heart审批通过Approved!
happy任务完成Done! ★
error工具报错Error!
sleep30 秒无活动zZz...

粒子特效

每种状态都有独特的粒子效果:sleep 飘出 "z"、busy 旋转加载点、typing 弹出代码符号、heart 飘爱心。

6 种颜色方案

多实例自动分配不同颜色:橘 → 蓝 → 粉 → 灰 → 黑 → 白。右键菜单可实时切换。

右键菜单

右键点击小猫弹出操作菜单:

  • 检查更新 — 从 GitHub Release 检测新版本
  • 帮助 — 显示 neko 指令表
  • 颜色切换 — 实时切换猫咪颜色(不关闭菜单)
  • 反馈问题 — 打开 GitHub Issues
  • 停止 — 关闭小猫

在线更新

neko update     # 检查并安装更新
neko version    # 查看当前版本号

更新时自动备份,失败可回滚。

安装

方式一:Git Clone

git clone https://github.com/SuWeishengya/Claude-Neko.git
cd Claude-Neko
bash install.sh

方式二:下载压缩包

从 Releases 下载 claude-neko-v0.1.0.tar.gz:

tar xzf claude-neko-v0.1.0.tar.gz
cd claude-neko-v0.1.0
bash install.sh

安装脚本自动检测发行版(Fedora / Ubuntu / Arch),安装系统依赖,配置 Claude Code Hooks。完成后打开任意 Claude Code 会话,小猫自动出现。

卸载:

bash ~/.local/share/claude-neko/uninstall.sh

日常使用

装好后基本不用管。手动控制:

neko start      # 拉起小猫(监听所有 Claude 会话)
neko stop       # 关闭所有小猫
neko restart    # 重启
neko status     # 查看运行状态
neko enable     # 开启自动随 Claude 启动
neko disable    # 关闭自动启动
neko version    # 显示版本号
neko update     # 检查并安装更新

自动模式 vs 手动模式

自动模式手动模式
启动方式Claude Code 自动触发neko start
会话绑定每只猫绑定一个会话一只猫监听所有会话
生命周期会话结束猫退出手动 neko stop
多实例每个会话一只猫单实例

操作方式

操作效果
左键拖拽移动小猫位置
左键单击显示统计信息(Token、会话数等)
右键打开操作菜单

环境要求

项目要求
系统Linux 桌面环境
Python3.8+
GUIGTK3(大多数 Linux 发行版自带)
终端Claude Code CLI

⚠️ 仅支持 Linux。不支持 macOS / Windows,不支持 Claude Desktop(GUI 版)。

技术架构

Claude Code (SessionStart)  ──▶ launch.sh ──▶ server.py + neko_widget.py
Claude Code (PreToolUse)    ──▶ hook_bridge.py ──POST──▶ server.py
Claude Code (PostToolUse)   ──▶ hook_bridge.py ──POST──▶ server.py
Claude Code (Stop)          ──▶ hook_bridge.py ──POST──▶ server.py
Claude Code (SessionEnd)    ──▶ hook_bridge.py ──POST──▶ server.py
  • server.py — HTTP 后端,端口 9100+,维护全局状态机
  • neko_widget.py — GTK3 悬浮窗,125ms 帧动画 + 500ms 状态轮询
  • hook_bridge.py — Claude Code Hook 事件桥接
  • updater.py — 在线更新模块(GitHub Release 检测 + 下载 + 安装)

许可证

MIT

致谢

灵感来自 anthropics/claude-desktop-buddy(ESP32 硬件版),基于 worddless1-dotcom/claude-desktop-buddy(Windows 版)移植适配。

Ver o original no GitHub

Bom para

Relacionados