@funnycode/myclaude 0.1.9 → 0.1.10

package/README.md

@@ -14,7 +14,9 @@ npx @funnycode/myclaude
 ## Features
 
 - **AI Chat** — Write, refactor, debug, and explain code via natural language
-- **80+ Slash Commands** — `/commit`, `/review`, `/plan`, `/test`, `/doctor` and more
+- **80+ Slash Commands** — `/commit`, `/review`, `/plan`, `/doctor`, `/buddy`, `/achievements` and more
+- **BUDDY Companion** — A terminal pet that grows with you. Hatch, pet, and bond with your ASCII companion. 18 species, 5 rarity tiers, shiny variants.
+- **Achievements** — Unlock 20+ achievements as you code: streaks, milestones, discoveries.
 - **File Operations** — Edit, write, create, and search files with AI guidance
 - **Git Integration** — Automatic commit messages, branch management, PR creation
 - **MCP Support** — Model Context Protocol for extensible tool integrations
@@ -116,6 +118,12 @@ npx @funnycode/myclaude --help                 # Show help
 | `/reload-plugins` | Reload all plugins |
 | `/hooks` | Manage hooks |
 
+### Companion & Achievements
+| Command | Description |
+|---------|-------------|
+| `/buddy` | Manage your terminal companion (hatch, pet, card, mute) |
+| `/achievements` | View unlocked achievements and progress |
+
 ### System
 | Command | Description |
 |---------|-------------|
@@ -140,6 +148,68 @@ npx @funnycode/myclaude --help                 # Show help
 
 ---
 
+## BUDDY — Your Terminal Companion
+
+myclaude comes with a built-in virtual pet that lives in your terminal. Each pet is **deterministically generated** from your user ID — what you get is uniquely yours and cannot be cheated.
+
+### Species (18 total)
+
+🦆 Duck   🪿 Goose   🫧 Blob   🐱 Cat   🐉 Dragon  
+🐙 Octopus   🦉 Owl   🐧 Penguin   🐢 Turtle   🐌 Snail  
+👻 Ghost   🦎 Axolotl   🦫 Capybara   🌵 Cactus   🤖 Robot  
+🐰 Rabbit   🍄 Mushroom   🐈 Chonk
+
+### Rarity System
+
+| Rarity | Chance | Stars |
+|--------|--------|-------|
+| Common | 60% | ★ |
+| Uncommon | 25% | ★★ |
+| Rare | 10% | ★★★ |
+| Epic | 4% | ★★★★ |
+| Legendary | 1% | ★★★★★ |
+
+There's also a **1% shiny chance** independent of rarity — shiny companions sparkle ✨
+
+### Stats
+
+Each companion has 5 attributes: `DEBUGGING`, `PATIENCE`, `CHAOS`, `WISDOM`, `SNARK` — with one peak stat and one dump stat.
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `/buddy hatch` | Hatch a new companion |
+| `/buddy pet` | Pet your companion (hearts animation) |
+| `/buddy card` | View companion card with stats |
+| `/buddy mute` | Hide companion from terminal |
+| `/buddy unmute` | Show companion again |
+
+The companion reacts to your conversation and occasionally comments via speech bubbles. Each species has custom idle animations and pet reactions.
+
+---
+
+## Achievements
+
+Unlock achievements as you use myclaude. Track your progress with `/achievements`.
+
+### Categories
+
+| Category | Description |
+|----------|-------------|
+| 🌟 Getting Started | First hatch, first commit, first review, first plugin, first skill |
+| 📊 Usage | 10/100 commits, 100/1000 messages, model switching, config changes |
+| 🔥 Streaks | 3/7/30 consecutive days of use |
+| 🐾 Buddy | Hatch, pet 10/100 times, legendary or shiny companion |
+| ⚡ Power | Add an MCP server |
+
+```bash
+/achievements        # Show unlocked achievements summary
+/achievements list   # Show all achievements with progress
+```
+
+---
+
 ## Verified Working Features
 
 The following features have been tested and confirmed working:
@@ -153,6 +223,8 @@ The following features have been tested and confirmed working:
 - ✅ Git commit generation
 - ✅ File editing and creation
 - ✅ Skills system
+- ✅ BUDDY companion (hatch, pet, card, mute)
+- ✅ Achievements system
 - ✅ Vim mode
 - ✅ Config management
 - ✅ Doctor diagnostics
@@ -206,17 +278,31 @@ The build script bundles `src/entrypoints/cli.tsx` into a single file `dist/mycl
 
 ```
 src/
-├── commands/     # Slash command implementations
-├── components/   # React Ink UI components
-├── services/     # Backend services (API, MCP, analytics)
-├── tools/        # Tool implementations
-├── utils/        # Shared utilities
-├── entrypoints/  # CLI entry points
-└── main.tsx      # TUI main entry
+├── achievements/  # Achievement system (types, storage, checker)
+├── buddy/         # BUDDY companion (sprites, animations, types)
+├── commands/      # Slash command implementations
+├── components/    # React Ink UI components
+├── services/      # Backend services (API, MCP, analytics)
+├── tools/         # Tool implementations
+├── utils/         # Shared utilities
+├── entrypoints/   # CLI entry points
+└── main.tsx       # TUI main entry
 ```
 
 ---
 
+## Roadmap
+
+See [docs/ROADMAP.md](docs/ROADMAP.md) for the full iteration plan:
+
+- **P0** — Activate hidden features (BUDDY, Auto Memory) ✅
+- **P1** — Growth system (Achievements, skill recommendations)
+- **P2** — Interactive experience (multi-interaction, events)
+- **P3** — Extension ecosystem (plugin marketplace, Skill Studio)
+- **P4** — Intelligent evolution (personalized fine-tuning, offline mode)
+
+---
+
 ## Contributing
 
 Pull requests are welcome!

package/README.zh-CN.md

@@ -14,7 +14,9 @@ npx @funnycode/myclaude
 ## 功能特性
 
 - **AI 对话** — 通过自然语言编写、重构、调试和解释代码
-- **80+ 斜杠命令** — `/commit`、`/review`、`/plan`、`/test`、`/doctor` 等
+- **80+ 斜杠命令** — `/commit`、`/review`、`/plan`、`/doctor`、`/buddy`、`/achievements` 等
+- **BUDDY 伙伴** — 终端电子宠物，与你一同成长。孵化、抚摸、培养。18 个物种、5 级稀有度、闪光变异
+- **成就系统** — 边编码边解锁 20+ 成就：连续使用、里程牌、探索发现
 - **文件操作** — 在 AI 指导下编辑、写入、创建和搜索文件
 - **Git 集成** — 自动生成提交信息、管理分支、创建 PR
 - **MCP 支持** — Model Context Protocol 可扩展工具集成
@@ -116,6 +118,12 @@ npx @funnycode/myclaude --help                 # 查看帮助
 | `/reload-plugins` | 重新加载所有插件 |
 | `/hooks` | 管理钩子 |
 
+### 伙伴 & 成就
+| 命令 | 说明 |
+|------|------|
+| `/buddy` | 管理终端伙伴（孵化、抚摸、卡片、静音） |
+| `/achievements` | 查看已解锁的成就和进度 |
+
 ### 系统
 | 命令 | 说明 |
 |------|------|
@@ -140,9 +148,69 @@ npx @funnycode/myclaude --help                 # 查看帮助
 
 ---
 
-## 已确认可用的功能
+## BUDDY — 终端电子伙伴
+
+myclaude 内置了一个终端电子宠物。每只宠物都根据你的用户 ID **确定性生成**——独一无二，不可作弊。
+
+### 物种（共 18 种）
+
+🦆 鸭子   🪿 鹅   🫧 果冻   🐱 猫   🐉 龙  
+🐙 章鱼   🦉 猫头鹰   🐧 企鹅   🐢 乌龟   🐌 蜗牛  
+👻 幽灵   🦎 六角恐龙   🦫 水豚   🌵 仙人掌   🤖 机器人  
+🐰 兔子   🍄 蘑菇   🐈 胖猫
+
+### 稀有度系统
+
+| 稀有度 | 概率 | 星级 |
+|--------|------|------|
+| 普通 | 60% | ★ |
+| 非凡 | 25% | ★★ |
+| 稀有 | 10% | ★★★ |
+| 史诗 | 4% | ★★★★ |
+| 传说 | 1% | ★★★★★ |
 
-以下功能已经过测试并确认可用：
+还有独立于稀有度的 **1% 闪光概率**——闪光伙伴会闪闪发光 ✨
+
+### 属性
+
+每只伙伴有 5 项属性：`DEBUGGING`（调试）、`PATIENCE`（耐心）、`CHAOS`（混乱）、`WISDOM`（智慧）、`SNARK`（毒舌）——各有一项峰值属性和一项最低属性。
+
+### 命令
+
+| 命令 | 说明 |
+|------|------|
+| `/buddy hatch` | 孵化一只伙伴 |
+| `/buddy pet` | 抚摸伙伴（爱心动画） |
+| `/buddy card` | 查看伙伴卡片（属性、稀有度） |
+| `/buddy mute` | 隐藏伙伴 |
+| `/buddy unmute` | 重新显示伙伴 |
+
+伙伴会对你对话的内容做出反应，通过气泡说话。每种物种都有不同的空闲动画和抚摸反应。
+
+---
+
+## 成就系统
+
+边使用 myclaude 边解锁成就。用 `/achievements` 查看进度。
+
+### 分类
+
+| 类别 | 说明 |
+|------|------|
+| 🌟 入门 | 首次孵化、首次提交、首次审查、首次插件、首次技能 |
+| 📊 使用 | 10/100 次提交、100/1000 条消息、切换模型、修改配置 |
+| 🔥 连续 | 连续 3/7/30 天使用 |
+| 🐾 Buddy | 孵化、抚摸 10/100 次、传说或闪光伙伴 |
+| ⚡ 高级 | 添加 MCP 服务器 |
+
+```bash
+/achievements           # 查看已解锁成就摘要
+/achievements list      # 查看全部成就及进度
+```
+
+---
+
+## 已确认可用的功能
 
 - ✅ 交互式 REPL（与 AI 对话）
 - ✅ 打印模式（`-p` 参数）
@@ -153,6 +221,8 @@ npx @funnycode/myclaude --help                 # 查看帮助
 - ✅ Git 提交信息生成
 - ✅ 文件编辑和创建
 - ✅ 技能系统
+- ✅ BUDDY 伙伴（孵化、抚摸、卡片、静音）
+- ✅ 成就系统
 - ✅ Vim 模式
 - ✅ 配置管理
 - ✅ Doctor 诊断
@@ -206,17 +276,31 @@ bun run version    # 验证 CLI 启动
 
 ```
 src/
-├── commands/     # 斜杠命令实现
-├── components/   # React Ink UI 组件
-├── services/     # 后端服务（API、MCP、分析）
-├── tools/        # 工具实现
-├── utils/        # 共享工具函数
-├── entrypoints/  # CLI 入口
-└── main.tsx      # TUI 主入口
+├── achievements/  # 成就系统（类型定义、存储、检查器）
+├── buddy/         # BUDDY 伙伴（精灵图、动画、类型）
+├── commands/      # 斜杠命令实现
+├── components/    # React Ink UI 组件
+├── services/      # 后端服务（API、MCP、分析）
+├── tools/         # 工具实现
+├── utils/         # 共享工具函数
+├── entrypoints/   # CLI 入口
+└── main.tsx       # TUI 主入口
 ```
 
 ---
 
+## 路线图
+
+详见 [docs/ROADMAP.md](docs/ROADMAP.md)：
+
+- **P0** — 激活隐藏功能（BUDDY、Auto Memory）✅
+- **P1** — 成长系统（成就、技能推荐）
+- **P2** — 互动体验（多交互模式、节日事件）
+- **P3** — 扩展生态（插件市场、Skill Studio）
+- **P4** — 智能进化（个性化微调、离线模式）
+
+---
+
 ## 贡献
 
 欢迎提交 PR 参与贡献！

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@funnycode/myclaude",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "private": false,
   "description": "An open-source AI coding assistant in your terminal - powered by Claude",
-  "readme": "# @funnycode/myclaude\n\n**myclaude** — An open-source AI coding assistant that runs in your terminal.\nThis project is a fork/rebrand of Claude Code, committed to providing an independent, open AI coding experience.\n\n## Quick Start\n\n- Run: `npx @funnycode/myclaude`\n- Requires: Node.js >= 18 and an Anthropic API key\n- Set: `export ANTHROPIC_API_KEY=sk-ant-...`\n\n## Features\n\n- AI Chat, 80+ Slash Commands, File Operations, Git Integration\n- MCP Support, Plugin System, Agent Mode, Skills System\n- React Ink Terminal UI with themes, Vim mode, syntax highlighting\n- Multi-Model: Anthropic, AWS Bedrock, Google Vertex AI, Microsoft Foundry\n\n## Links\n\n- Gitee: https://gitee.com/thomaslwq/myclaude\n- GitHub: https://github.com/thomaslwq/myclaude\n- npm: https://www.npmjs.com/package/@funnycode/myclaude\n\n## License\n\nMIT",
+  "readme": "# @funnycode/myclaude\n\n**myclaude** — An open-source AI coding assistant that runs in your terminal.\nThis project is a fork/rebrand of Claude Code, committed to providing an independent, open AI coding experience.\n\n## Quick Start\n\n- Run: `npx @funnycode/myclaude`\n- Requires: Node.js >= 18 and an Anthropic API key\n- Set: `export ANTHROPIC_API_KEY=sk-ant-...`\n\n## Features\n\n- AI Chat, 80+ Slash Commands, File Operations, Git Integration\n- MCP Support, Plugin System, Agent Mode, Skills System\n- **BUDDY Companion** — A terminal pet (18 species, rarity, shiny)\n- **Achievements** — Unlock 20+ achievements as you code\n- React Ink Terminal UI with themes, Vim mode, syntax highlighting\n- Multi-Model: Anthropic, AWS Bedrock, Google Vertex AI, Microsoft Foundry\n\n## BUDDY Commands\n\n- `/buddy hatch` — Hatch a companion\n- `/buddy pet` — Pet your companion\n- `/buddy card` — View stats card\n- `/achievements` — View unlocked achievements\n\n## Links\n\n- Gitee: https://gitee.com/thomaslwq/myclaude\n- GitHub: https://github.com/thomaslwq/myclaude\n- npm: https://www.npmjs.com/package/@funnycode/myclaude\n\n## License\n\nMIT",
   "license": "MIT",
   "type": "module",
   "packageManager": "bun@1.3.5",