claude-code-achievements 1.0.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,7 @@
+{
+  "name": "claude-code-achievements",
+  "description": "Steam-style achievement system for Claude Code",
+  "author": {
+    "name": "subinium"
+  }
+}

package/README.md

@@ -0,0 +1,201 @@
+# 🎮 Claude Code Achievements
+
+Steam-style achievement system for [Claude Code](https://claude.ai/claude-code). Gamify your coding journey and unlock achievements as you master Claude Code features!
+
+## Installation
+
+```bash
+npx claude-code-achievements
+```
+
+The interactive installer will:
+1. **Auto-detect** your OS (macOS/Linux/Windows)
+2. **Auto-detect** system notification capability
+3. Ask for language preference (English/한국어)
+4. Configure notification style (system/terminal/both)
+5. Install to `~/.claude/plugins/local/claude-code-achievements`
+
+### Manual Installation
+
+```bash
+git clone https://github.com/subinium/claude-code-achievements.git
+cd claude-code-achievements
+node bin/install.js
+```
+
+## Usage
+
+| Command | Description |
+|---------|-------------|
+| `/achievements` | View all achievements with progress |
+| `/achievements hint` | Get tips for unlocking achievements |
+| `/achievements basics` | View "Getting Started" category |
+| `/achievements workflow` | View "Workflow" category |
+| `/achievements tools` | View "Power Tools" category |
+| `/achievements mastery` | View "Mastery" category |
+| `/achievements-settings` | Change language or notification settings |
+
+## Achievements (15 total)
+
+### Getting Started (⬜ Common / 🟩 Uncommon)
+
+| # | Achievement | Description | How to Unlock |
+|---|-------------|-------------|---------------|
+| 1 | ✏️ **First Touch** ⬜ | Edit a file | Use `Edit` tool |
+| 2 | 📝 **Creator** ⬜ | Create a new file | Use `Write` tool |
+| 3 | 📋 **Project Curator** 🟩 | Create CLAUDE.md | Write to `CLAUDE.md` |
+
+### Workflow (🟩 Uncommon)
+
+| # | Achievement | Description | How to Unlock |
+|---|-------------|-------------|---------------|
+| 4 | 🎯 **Strategic Thinker** | Use Plan mode | Press `Shift+Tab` twice |
+| 5 | 📦 **Version Controller** | Commit with Claude | Run `git add` or `git commit` |
+| 6 | 🚀 **Ship It!** | Push to remote | Run `git push` |
+| 7 | 🧪 **Quality Guardian** | Run tests | Run `npm test`, `pytest`, etc. |
+
+### Power Tools (🟦 Rare)
+
+| # | Achievement | Description | How to Unlock |
+|---|-------------|-------------|---------------|
+| 8 | 🤖 **Delegation Master** | Use sub-agents | Use `Task` tool |
+| 9 | 🔌 **MCP Pioneer** | Use MCP tool | Use any `mcp__*` tool |
+| 10 | 🌐 **Web Explorer** | Search the web | Use `WebSearch` tool |
+| 11 | ⚡ **Skill Master** | Use slash command | Use `Skill` tool (e.g., `/commit`) |
+| 12 | 📓 **Data Scientist** | Edit notebook | Use `NotebookEdit` tool |
+| 13 | ⚙️ **Customizer** | Modify settings | Write to `.claude/settings*.json` |
+
+### Mastery (🟪 Epic / 🟨 Legendary)
+
+| # | Achievement | Description | How to Unlock |
+|---|-------------|-------------|---------------|
+| 14 | 🪝 **Automation Architect** 🟪 | Set up hooks | Write file with `"hooks"` config |
+| 15 | 🔄 **Loop Master** 🟨 | Start Ralph Loop | Use `/ralph-loop` skill |
+
+## Rarity System
+
+| Rarity | Color | Count | Difficulty |
+|--------|-------|-------|------------|
+| Common | ⬜ | 2 | First session |
+| Uncommon | 🟩 | 5 | Regular usage |
+| Rare | 🟦 | 6 | Power user features |
+| Epic | 🟪 | 1 | Advanced automation |
+| Legendary | 🟨 | 1 | Expert level |
+
+## Notifications
+
+System notifications are **auto-detected** during installation:
+
+| OS | Method | Requirement | Auto-detected |
+|----|--------|-------------|---------------|
+| macOS | `osascript` | Built-in | ✅ Always |
+| Linux | `notify-send` | `libnotify-bin` | ✅ Checked |
+| Windows | PowerShell | Windows 10+ | ✅ Checked |
+| Fallback | Terminal | None | ✅ Always |
+
+**Note:** If system notifications aren't available, terminal notifications are used automatically.
+
+### Install `notify-send` on Linux
+
+```bash
+# Ubuntu/Debian
+sudo apt install libnotify-bin
+
+# Fedora
+sudo dnf install libnotify
+
+# Arch
+sudo pacman -S libnotify
+```
+
+## How It Works
+
+```
+┌─────────────────────────────────────────────────────────┐
+│  You use a tool (Edit, Write, Bash, Task, etc.)        │
+│                         │                               │
+│                         ▼                               │
+│  ┌─────────────────────────────────────────────────┐   │
+│  │ PostToolUse Hook → track-achievement.sh         │   │
+│  │ Checks tool_name, tool_input, permission_mode   │   │
+│  └─────────────────────────────────────────────────┘   │
+│                         │                               │
+│          ┌──────────────┴──────────────┐               │
+│          ▼                             ▼               │
+│  ┌───────────────┐           ┌─────────────────┐       │
+│  │ Match found!  │           │ No match        │       │
+│  │ → Unlock      │           │ → Continue      │       │
+│  │ → Notify      │           └─────────────────┘       │
+│  │ → Save state  │                                     │
+│  └───────────────┘                                     │
+└─────────────────────────────────────────────────────────┘
+```
+
+## Files
+
+| Path | Description |
+|------|-------------|
+| `~/.claude/achievements/state.json` | Your progress & settings |
+| `~/.claude/plugins/local/claude-code-achievements/` | Plugin files |
+| `~/.claude/commands/achievements.md` | Slash command |
+
+## Settings
+
+Edit `~/.claude/achievements/state.json`:
+
+```json
+{
+  "settings": {
+    "language": "en",              // "en" | "ko"
+    "notifications": true,          // true | false
+    "notification_style": "system"  // "system" | "terminal" | "both"
+  }
+}
+```
+
+## Troubleshooting
+
+### Achievements not unlocking?
+
+```bash
+# 1. Check hooks are registered
+cat ~/.claude/settings.json | grep -A5 "hooks"
+
+# 2. Verify plugin installed
+ls ~/.claude/plugins/local/claude-code-achievements/
+
+# 3. Check state file
+cat ~/.claude/achievements/state.json
+```
+
+### Reset progress
+
+```bash
+rm ~/.claude/achievements/state.json
+```
+
+### Reinstall
+
+```bash
+npx claude-code-achievements
+```
+
+## Languages
+
+- 🇺🇸 English
+- 🇰🇷 한국어
+
+## Contributing
+
+PRs welcome! Ideas:
+- New achievements
+- New languages
+- Bug fixes
+
+## License
+
+MIT
+
+---
+
+Happy coding! 🎮

package/bin/config.js

@@ -0,0 +1,285 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const STATE_FILE = path.join(os.homedir(), '.claude', 'achievements', 'state.json');
+
+// ANSI escape codes
+const ESC = '\x1b';
+const CLEAR_SCREEN = `${ESC}[2J${ESC}[H`;
+const HIDE_CURSOR = `${ESC}[?25l`;
+const SHOW_CURSOR = `${ESC}[?25h`;
+const BOLD = `${ESC}[1m`;
+const DIM = `${ESC}[2m`;
+const RESET = `${ESC}[0m`;
+const CYAN = `${ESC}[36m`;
+const GREEN = `${ESC}[32m`;
+const YELLOW = `${ESC}[33m`;
+const WHITE = `${ESC}[37m`;
+const BG_GRAY = `${ESC}[48;5;236m`;
+
+// Box drawing
+const BOX = {
+  topLeft: '╭',
+  topRight: '╮',
+  bottomLeft: '╰',
+  bottomRight: '╯',
+  horizontal: '─',
+  vertical: '│'
+};
+
+// Load state
+function loadState() {
+  try {
+    return JSON.parse(fs.readFileSync(STATE_FILE, 'utf8'));
+  } catch {
+    return {
+      settings: { language: 'en', notifications: true, notification_style: 'terminal' },
+      achievements: {},
+      counters: { ralph_iterations: 0, files_read: 0, edits_made: 0 },
+      session: { files_read_set: [], ralph_loop_active: false }
+    };
+  }
+}
+
+// Save state
+function saveState(state) {
+  const dir = path.dirname(STATE_FILE);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  fs.writeFileSync(STATE_FILE, JSON.stringify(state, null, 2));
+}
+
+// Get terminal width
+function getTermWidth() {
+  return process.stdout.columns || 80;
+}
+
+// Settings definition
+function getSettings(state) {
+  return [
+    {
+      id: 'language',
+      label: 'Language',
+      value: state.settings.language === 'ko' ? '한국어' : 'English',
+      options: [
+        { id: 'en', label: 'English' },
+        { id: 'ko', label: '한국어' }
+      ]
+    },
+    {
+      id: 'notifications',
+      label: 'Notifications',
+      value: state.settings.notifications ? 'On' : 'Off',
+      options: [
+        { id: true, label: 'On' },
+        { id: false, label: 'Off' }
+      ]
+    },
+    {
+      id: 'notification_style',
+      label: 'Notification style',
+      value: state.settings.notification_style || 'terminal',
+      options: [
+        { id: 'terminal', label: 'terminal' },
+        { id: 'system', label: 'system' },
+        { id: 'both', label: 'both' }
+      ]
+    },
+    {
+      id: 'reset',
+      label: 'Reset all progress',
+      value: '',
+      options: [
+        { id: 'yes', label: 'Yes, reset' },
+        { id: 'no', label: 'Cancel' }
+      ]
+    }
+  ];
+}
+
+// Config UI
+class ConfigUI {
+  constructor() {
+    this.state = loadState();
+    this.settings = getSettings(this.state);
+    this.selected = 0;
+    this.editMode = false;
+    this.editIndex = 0;
+  }
+
+  render() {
+    const width = Math.min(getTermWidth() - 4, 100);
+    let output = CLEAR_SCREEN;
+
+    // Title
+    output += `\n  ${BOLD}Configure Vibecoding Achievements${RESET}\n\n`;
+
+    // Search box (decorative)
+    const searchWidth = width - 2;
+    output += `  ${BOX.topLeft}${BOX.horizontal.repeat(searchWidth)}${BOX.topRight}\n`;
+    output += `  ${BOX.vertical} ${DIM}⌕ Search settings...${' '.repeat(searchWidth - 21)}${RESET}${BOX.vertical}\n`;
+    output += `  ${BOX.bottomLeft}${BOX.horizontal.repeat(searchWidth)}${BOX.bottomRight}\n\n`;
+
+    // Settings list
+    this.settings.forEach((setting, index) => {
+      const isSelected = index === this.selected;
+      const prefix = isSelected ? `${GREEN}❯${RESET}` : ' ';
+
+      const labelWidth = 35;
+      const label = setting.label.padEnd(labelWidth);
+
+      let valueDisplay = setting.value;
+      if (this.editMode && index === this.selected) {
+        // Show options in edit mode
+        const opts = setting.options;
+        valueDisplay = opts.map((opt, i) => {
+          if (i === this.editIndex) {
+            return `${GREEN}${BOLD}${opt.label}${RESET}`;
+          }
+          return `${DIM}${opt.label}${RESET}`;
+        }).join('  ');
+      } else {
+        valueDisplay = `${DIM}${setting.value}${RESET}`;
+      }
+
+      if (isSelected && !this.editMode) {
+        output += `  ${prefix} ${BOLD}${label}${RESET}${valueDisplay}\n`;
+      } else {
+        output += `  ${prefix} ${label}${valueDisplay}\n`;
+      }
+    });
+
+    // Help
+    output += `\n  ${DIM}↑/↓: Navigate  Enter: Edit  ←/→: Change value  q: Quit${RESET}\n`;
+
+    process.stdout.write(output);
+  }
+
+  async run() {
+    if (!process.stdin.isTTY) {
+      console.log('This command requires an interactive terminal.');
+      console.log('Current settings:');
+      console.log(JSON.stringify(this.state.settings, null, 2));
+      return;
+    }
+
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.setEncoding('utf8');
+    process.stdout.write(HIDE_CURSOR);
+
+    this.render();
+
+    return new Promise((resolve) => {
+      const cleanup = () => {
+        process.stdin.setRawMode(false);
+        process.stdin.pause();
+        process.stdout.write(SHOW_CURSOR);
+        process.stdout.write(CLEAR_SCREEN);
+      };
+
+      process.stdin.on('data', (key) => {
+        // Ctrl+C or q
+        if (key === '\u0003' || (key === 'q' && !this.editMode)) {
+          cleanup();
+          resolve();
+          return;
+        }
+
+        // Escape - exit edit mode
+        if (key === '\u001b' && this.editMode) {
+          this.editMode = false;
+          this.render();
+          return;
+        }
+
+        if (this.editMode) {
+          const setting = this.settings[this.selected];
+          const opts = setting.options;
+
+          // Left arrow
+          if (key === '\u001b[D') {
+            this.editIndex = Math.max(0, this.editIndex - 1);
+            this.render();
+          }
+          // Right arrow
+          else if (key === '\u001b[C') {
+            this.editIndex = Math.min(opts.length - 1, this.editIndex + 1);
+            this.render();
+          }
+          // Enter - apply selection
+          else if (key === '\r' || key === '\n') {
+            this.applyChange(setting.id, opts[this.editIndex].id);
+            this.editMode = false;
+            this.settings = getSettings(this.state);
+            this.render();
+          }
+        } else {
+          // Up arrow
+          if (key === '\u001b[A') {
+            this.selected = Math.max(0, this.selected - 1);
+            this.render();
+          }
+          // Down arrow
+          else if (key === '\u001b[B') {
+            this.selected = Math.min(this.settings.length - 1, this.selected + 1);
+            this.render();
+          }
+          // Enter - enter edit mode
+          else if (key === '\r' || key === '\n') {
+            const setting = this.settings[this.selected];
+            this.editMode = true;
+            // Set editIndex to current value
+            const currentVal = this.state.settings[setting.id];
+            this.editIndex = setting.options.findIndex(o => o.id === currentVal);
+            if (this.editIndex === -1) this.editIndex = 0;
+            this.render();
+          }
+          // Left/Right - quick toggle
+          else if (key === '\u001b[D' || key === '\u001b[C') {
+            const setting = this.settings[this.selected];
+            const opts = setting.options;
+            const currentVal = this.state.settings[setting.id];
+            let idx = opts.findIndex(o => o.id === currentVal);
+            if (idx === -1) idx = 0;
+
+            if (key === '\u001b[C') {
+              idx = Math.min(opts.length - 1, idx + 1);
+            } else {
+              idx = Math.max(0, idx - 1);
+            }
+
+            this.applyChange(setting.id, opts[idx].id);
+            this.settings = getSettings(this.state);
+            this.render();
+          }
+        }
+      });
+    });
+  }
+
+  applyChange(settingId, value) {
+    if (settingId === 'reset') {
+      if (value === 'yes') {
+        this.state.achievements = {};
+        this.state.counters = { ralph_iterations: 0, files_read: 0, edits_made: 0 };
+        this.state.session = { files_read_set: [], ralph_loop_active: false };
+      }
+    } else {
+      this.state.settings[settingId] = value;
+    }
+    saveState(this.state);
+  }
+}
+
+// Run
+const ui = new ConfigUI();
+ui.run().catch(err => {
+  process.stdout.write(SHOW_CURSOR);
+  console.error(err);
+  process.exit(1);
+});