{"id":48817226,"url":"https://github.com/crazyma99/claude-minipet","last_synced_at":"2026-04-20T18:00:54.099Z","repository":{"id":351222177,"uuid":"1210078846","full_name":"crazyma99/claude-minipet","owner":"crazyma99","description":"🐾 A virtual pet for Claude Code TUI — it grows, evolves, and codes with you!","archived":false,"fork":false,"pushed_at":"2026-04-17T01:55:29.000Z","size":212,"stargazers_count":3,"open_issues_count":1,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-18T16:02:39.169Z","etag":null,"topics":["ascii-art","claude-code","pixel-art","tamagotchi","terminal","tui","virtual-pet"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/claude-minipet","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/crazyma99.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-14T04:14:34.000Z","updated_at":"2026-04-17T11:56:04.000Z","dependencies_parsed_at":null,"dependency_job_id":"82bb0e23-6458-4bb8-8d8d-51797afbf9e7","html_url":"https://github.com/crazyma99/claude-minipet","commit_stats":null,"previous_names":["crazyma99/claude-minipet"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/crazyma99/claude-minipet","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crazyma99%2Fclaude-minipet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crazyma99%2Fclaude-minipet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crazyma99%2Fclaude-minipet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crazyma99%2Fclaude-minipet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/crazyma99","download_url":"https://codeload.github.com/crazyma99/claude-minipet/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crazyma99%2Fclaude-minipet/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32059139,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T11:35:06.609Z","status":"ssl_error","status_checked_at":"2026-04-20T11:34:48.899Z","response_time":94,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ascii-art","claude-code","pixel-art","tamagotchi","terminal","tui","virtual-pet"],"created_at":"2026-04-14T12:01:31.471Z","updated_at":"2026-04-20T18:00:54.026Z","avatar_url":"https://github.com/crazyma99.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🐾 Claude MiniPet\n\n\u003e [!IMPORTANT]\n\u003e **隐私声明：** 本项目所有 Hooks 仅用于宠物状态（经验、心情、饱食度等）的娱乐性监测，**不会读取、存储或传输你的任何代码内容、文件内容或对话内容。** 所有数据处理均在本地端侧完成，云同步仅上传宠物状态数值（等级、经验、统计计数等），不包含任何源码或隐私信息。项目完全开源，欢迎审查代码。\n\n一只住在 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 终端里的虚拟宠物。在你编程时它会陪伴在终端底部，随着你的 coding 活动获得经验、升级、进化。\n\n\u003e **前提条件：** 本工具是 Claude Code 的扩展插件，需要先安装 Node.js 和 Claude Code。\n\n**[English](README_EN.md)**\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"show.png\" alt=\"Claude MiniPet 截图\" width=\"100%\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Node.js-18+-339933?logo=nodedotjs\u0026logoColor=white\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Claude_Code-TUI-6c5ce7\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/License-MIT-blue\" /\u003e\n\u003c/p\u003e\n\n## 环境准备\n\n### 1. 安装 Node.js\n\n前往 [Node.js 官网](https://nodejs.org/) 下载 LTS 版本（\u003e=18），或使用包管理器：\n\n```bash\n# macOS (Homebrew)\nbrew install node\n\n# Ubuntu / Debian\ncurl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -\nsudo apt-get install -y nodejs\n\n# Windows (winget)\nwinget install OpenJS.NodeJS.LTS\n```\n\n### 2. 安装 Claude Code\n\n参考 [Claude Code 官方文档](https://docs.anthropic.com/en/docs/claude-code)：\n\n```bash\nnpm install -g @anthropic-ai/claude-code\n```\n\n## 安装 MiniPet\n\n```bash\nnpm install -g claude-minipet \u0026\u0026 claude-minipet init\n```\n\n一条命令完成安装和配置，交互式引导流程：\n\n```\n🐾 欢迎使用 Claude MiniPet!\n\n📧 请输入你的邮箱: you@example.com\n📤 发送验证码中...\n✅ 验证码已发送到你的邮箱\n\n🔑 请输入验证码 (输入 r 重新发送): 483721\n✅ 登录成功!\n\n✨ 一只新的宠物诞生了! ✨\n种族: 壳龙 (Shelldragon)\n稀有度: ★★★ [传说]\n🧬 DNA: A3-F7-2B-E1-8C-D4-09-5F\n\n✅ Claude Code hooks 已配置\n✅ 守护进程已启动\n☁️ 宠物数据已上传到云端\n\n重启 Claude Code 就能看到你的宠物了! 🎉\n```\n\n## 使用\n\n```bash\nclaude-minipet status            # 查看宠物详细状态\nclaude-minipet feed              # 喂食（饱食度 +30）\nclaude-minipet pat               # 摸摸（心情 +10，亲密 +2）\nclaude-minipet rename \u003c名字\u003e     # 给宠物改名\nclaude-minipet redeem \u003c兑换码\u003e   # 兑换码兑换宠物\nclaude-minipet sync              # 手动同步云端数据\n```\n\n日常使用不需要手动操作 — 宠物会在你用 Claude Code 编程时自动获得经验、升级、进化，数据自动同步到云端。\n\n## 兑换码\n\n```bash\nclaude-minipet redeem XXXX-XXXX-XXXX\n```\n\n兑换后当前宠物会被替换为新宠物（Lv.1 重新培养）。兑换码由管理员生成分发。\n\n## 特性\n\n- **🎲 程序化生成** — 每只宠物独一无二，基于 DNA 系统随机生成外观\n- **🐱 6 个种族** — 位猫、壳龙、码史莱姆、吉狐、虫枭、像素精灵，各有专属被动技能\n- **✨ 5 级稀有度** — 普通(60%) / 优秀(25%) / 稀有(10%) / 传说(4%) / 异色(1%)\n- **📈 养成系统** — 等级、经验、心情、饱食度、亲密度\n- **🧬 进化分支** — 3 阶段进化，编程习惯决定进化方向\n- **🎨 像素画渲染** — Unicode 半块字符 + ANSI 24-bit 真彩色\n- **💫 多帧动画** — 眨眼、进食、升级、进化等动态效果\n- **☁️ 云端同步** — 邮箱登录，数据自动同步，跨设备使用\n- **💬 宠物气泡** — 实时语音气泡，显示工作状态、评语、彩蛋\n- **🧠 AI 感知** — 新会话自动识别宠物命令，说\"喂宠物\"即可执行\n- **💓 心跳监测** — 客户端每 60 秒上报心跳，服务端实时追踪在线状态和客户端版本\n\n## 宠物气泡\n\n状态栏底部始终显示一个实时气泡，宠物会根据当前状态\"说话\"：\n\n```\n╭────────────────────────────────────────────────╮\n│ \u003e\u003e 疯狂Coding中... [3m25s]                     │  ← Claude 工作中\n╰────────────────────────────────────────────────╯\n\n╭────────────────────────────────────────────────╮\n│ [ok] 任务完成了！ (用时 5分12秒)               │  ← Claude 停止时\n╰────────────────────────────────────────────────╯\n```\n\n宠物还会根据你的编码行为吐槽或鼓励：\n- 只 commit 不写测试 → \"主人又在裸奔了...\"\n- 连续报错 → \"又炸了...宠物捂脸\"\n- 深夜编码 → \"都这么晚了，主人该休息了\"\n- 长时间离开后回来 → \"主人回来啦！宠物想你了~\"\n\n## 经验获取\n\n| 事件 | 基础经验 | 内容加成 |\n|------|---------|---------|\n| 发送消息 | +3 | +1/100字符 |\n| Bash 命令 | +5 | +1/100字符 |\n| 编辑/写入文件 | +8 | +1/100字符 |\n| 读取文件 | +2 | +1/100字符 |\n| 测试通过 | +15 | +1/100字符 |\n| Git commit | +20 | +1/100字符 |\n| 创建 PR | +30 | +1/100字符 |\n\n内容加成上限 +50，大文件操作获得更多经验。\n\n## 种族\n\n| 种族 | 被动技能 |\n|------|---------|\n| 🐱 位猫 Bitcat | 读文件时特别开心 |\n| 🐉 壳龙 Shelldragon | Bash 命令双倍经验 |\n| 🟢 码史莱姆 Codeslime | 升级经验需求 -20% |\n| 🦊 吉狐 Gitfox | Git 操作额外经验 |\n| 🦉 虫枭 Bugowl | 测试/调试双倍经验 |\n| 🤖 像素精灵 Pixiebot | 心情衰减减半 |\n\n## 进化\n\n每个种族有 3 个进化阶段（幼年体 → 成长体 → 完全体），每阶段 2-3 个分支。进化方向取决于你的编程习惯：\n\n- 写代码多 → 代码系进化\n- 跑命令多 → 命令系进化\n- 亲密度高 → 特殊进化\n- 保持好心情 → 光系进化\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrazyma99%2Fclaude-minipet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcrazyma99%2Fclaude-minipet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrazyma99%2Fclaude-minipet/lists"}