{"id":39378963,"url":"https://github.com/subinium/claude-code-achievements","last_synced_at":"2026-01-23T08:01:10.777Z","repository":{"id":333071122,"uuid":"1136103792","full_name":"subinium/claude-code-achievements","owner":"subinium","description":"🎮 Steam-style Achievement system for Claude Code","archived":false,"fork":false,"pushed_at":"2026-01-18T23:09:39.000Z","size":238,"stargazers_count":60,"open_issues_count":0,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-22T19:53:28.011Z","etag":null,"topics":["claude-code","gamification"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/subinium.png","metadata":{"files":{"readme":"README.es.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","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-01-17T04:23:51.000Z","updated_at":"2026-01-22T07:37:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/subinium/claude-code-achievements","commit_stats":null,"previous_names":["subinium/claude-code-achievements"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/subinium/claude-code-achievements","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subinium%2Fclaude-code-achievements","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subinium%2Fclaude-code-achievements/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subinium%2Fclaude-code-achievements/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subinium%2Fclaude-code-achievements/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/subinium","download_url":"https://codeload.github.com/subinium/claude-code-achievements/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subinium%2Fclaude-code-achievements/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28684003,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-23T05:48:07.525Z","status":"ssl_error","status_checked_at":"2026-01-23T05:48:07.129Z","response_time":59,"last_error":"SSL_read: 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":["claude-code","gamification"],"created_at":"2026-01-18T02:58:58.139Z","updated_at":"2026-01-23T08:01:10.737Z","avatar_url":"https://github.com/subinium.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"assets/icon.png\" alt=\"Claude Code Achievements\" width=\"120\" height=\"120\"\u003e\n\n# Claude Code Achievements\n\n**Sistema de logros estilo Steam para Claude Code**\n\n[![npm version](https://img.shields.io/npm/v/claude-code-achievements.svg?style=flat-square\u0026color=CB3837)](https://www.npmjs.com/package/claude-code-achievements)\n[![license](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](LICENSE)\n[![node](https://img.shields.io/badge/node-%3E%3D14.0.0-brightgreen.svg?style=flat-square)](package.json)\n\n¡Gamifica tu experiencia de programación y desbloquea logros mientras dominas las funciones de Claude Code!\n\n[Instalación](#instalación) · [Uso](#uso) · [Logros](#logros) · [Cómo Funciona](#arquitectura)\n\n**[English](README.md)** · **[中文](README.zh.md)** · **[한국어](README.ko.md)** · **[日本語](README.ja.md)**\n\n\u003c/div\u003e\n\n---\n\n## Características\n\n- **26 Logros** en 4 categorías\n- **Notificaciones en tiempo real** vía alertas del sistema o terminal\n- **Soporte multiidioma** (EN / 中文 / ES / 한국어 / 日本語)\n- **Multiplataforma** (macOS / Linux / Windows)\n- **Instalación global** - funciona en todos tus proyectos\n\n## Instalación\n\n```bash\nnpx claude-code-achievements\n```\n\nEl instalador interactivo:\n1. Detectará automáticamente tu SO y capacidad de notificaciones\n2. Preguntará tu preferencia de idioma\n3. Configurará el estilo de notificación (sistema/terminal/ambos)\n4. Instalará globalmente en `~/.claude/plugins/local/`\n\n\u003e **Nota:** Este plugin se instala **globalmente** y funciona automáticamente en todos tus proyectos.\n\n### Instalación Manual\n\n```bash\ngit clone https://github.com/subinium/claude-code-achievements.git\ncd claude-code-achievements\nnode bin/install.js\n```\n\n## Uso\n\n| Comando | Descripción |\n|---------|-------------|\n| `/achievements` | Ver logros desbloqueados (predeterminado) |\n| `/achievements locked` | Ver logros bloqueados con pistas |\n| `/achievements all` | Ver todos los logros por categoría |\n| `/achievements-settings` | Cambiar idioma o configuración de notificaciones |\n\n### Filtros de Categoría\n\n```bash\n/achievements basics    # Primeros Pasos\n/achievements workflow  # Flujo de Trabajo\n/achievements tools     # Herramientas Avanzadas\n/achievements mastery   # Maestría\n```\n\n## Logros\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003ePrimeros Pasos\u003c/b\u003e (4 logros)\u003c/summary\u003e\n\n| Logro | Cómo Desbloquear |\n|-------|------------------|\n| ✏️ **Primer Toque** | Editar cualquier archivo |\n| 📝 **Creador** | Crear un nuevo archivo |\n| 🔍 **Detective de Código** | Usar Glob o Grep para buscar en el código |\n| 📋 **Curador de Proyecto** | Crear `CLAUDE.md` para contexto del proyecto |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eFlujo de Trabajo\u003c/b\u003e (8 logros)\u003c/summary\u003e\n\n| Logro | Cómo Desbloquear |\n|-------|------------------|\n| 📋 **Planificador de Tareas** | Usar TodoWrite para seguimiento de tareas |\n| 🎯 **Pensador Estratégico** | Usar modo Plan (`Shift+Tab` dos veces) |\n| 🗣️ **Comunicador** | Claude usa `AskUserQuestion` para clarificar requisitos |\n| 🌍 **Curador Global** | Configurar `~/.claude/CLAUDE.md` |\n| 📦 **Controlador de Versiones** | Hacer commit con Claude |\n| 🚀 **¡A Producción!** | Hacer push al repositorio remoto |\n| 🧪 **Guardián de Calidad** | Ejecutar tests con Claude |\n| 🚦 **Pionero CI/CD** | Crear workflow de GitHub Actions |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eHerramientas Avanzadas\u003c/b\u003e (9 logros)\u003c/summary\u003e\n\n| Logro | Cómo Desbloquear |\n|-------|------------------|\n| 🎨 **Inspector Visual** | Analizar imagen o captura de pantalla |\n| 📡 **Cazador de Docs** | Obtener y analizar una página web |\n| 🤖 **Maestro de Delegación** | Usar herramienta `Task` para sub-agentes |\n| 🔌 **Pionero MCP** | Usar cualquier herramienta MCP |\n| 🌐 **Explorador Web** | Usar herramienta `WebSearch` |\n| ⚙️ **Personalizador** | Modificar configuración de Claude Code |\n| 📜 **Creador de Skills** | Crear skill personalizado en `.claude/skills/` |\n| ⌨️ **Artesano de Comandos** | Crear comando slash personalizado |\n| 🧩 **Explorador de Plugins** | Instalar un plugin desde el marketplace |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eMaestría\u003c/b\u003e (5 logros)\u003c/summary\u003e\n\n| Logro | Cómo Desbloquear |\n|-------|------------------|\n| 🪝 **Arquitecto de Automatización** | Configurar hooks de Claude Code |\n| 🔗 **Conector MCP** | Configurar `.mcp.json` para integraciones |\n| 🤖 **Arquitecto de Agentes** | Crear agente personalizado en `.claude/agents/` |\n| 🛡️ **Guardia de Seguridad** | Configurar permisos de seguridad |\n| 🔄 **Maestro del Bucle** | Iniciar bucle de codificación autónomo |\n\n\u003c/details\u003e\n\n---\n\n## Arquitectura\n\nEste plugin usa el **sistema de hooks de Claude Code** para rastrear tus acciones en tiempo real.\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│                     SESIÓN DE CLAUDE CODE                    │\n├─────────────────────────────────────────────────────────────┤\n│                                                              │\n│   Tú: \"Edita el archivo de configuración\"                   │\n│                     │                                        │\n│                     ▼                                        │\n│   ┌─────────────────────────────────────┐                   │\n│   │      Claude usa la herramienta Edit  │                   │\n│   └─────────────────────────────────────┘                   │\n│                     │                                        │\n│                     ▼                                        │\n│   ┌─────────────────────────────────────┐                   │\n│   │    Se activa el Hook PostToolUse    │◄── hooks.json     │\n│   │    → track-achievement.sh            │                   │\n│   └─────────────────────────────────────┘                   │\n│                     │                                        │\n│         ┌──────────┴──────────┐                             │\n│         ▼                     ▼                             │\n│   ┌───────────┐        ┌───────────┐                        │\n│   │ ¡Coincide!│        │ No coincide│                       │\n│   │           │        │           │                        │\n│   │ Desbloquear│       │ Continuar │                        │\n│   │ Notificar │        └───────────┘                        │\n│   │ Guardar   │                                              │\n│   └───────────┘                                              │\n│                                                              │\n└─────────────────────────────────────────────────────────────┘\n```\n\n### Estructura del Plugin\n\n```\n~/.claude/plugins/local/claude-code-achievements/\n├── .claude-plugin/\n│   └── plugin.json          # Metadatos del plugin\n├── hooks/\n│   ├── hooks.json           # Definiciones de hooks (PostToolUse, Stop)\n│   ├── track-achievement.sh # Lógica principal de seguimiento\n│   └── track-stop.sh        # Manejador de fin de sesión\n├── commands/\n│   ├── achievements.md      # Comando /achievements\n│   └── achievements-settings.md\n├── scripts/\n│   ├── show-achievements.sh # UI de visualización\n│   └── show-notification.sh # Manejador de notificaciones\n└── data/\n    ├── achievements.json    # Definiciones de logros\n    └── i18n/\n        ├── en.json          # English\n        ├── zh.json          # 中文\n        ├── es.json          # Español\n        ├── ko.json          # 한국어\n        └── ja.json          # 日本語\n```\n\n### Cómo Funcionan los Hooks\n\nEl plugin registra dos hooks en Claude Code:\n\n| Hook | Activador | Propósito |\n|------|-----------|-----------|\n| `PostToolUse` | Después de ejecutar herramienta | Verificar condiciones de logro |\n| `Stop` | Al finalizar sesión | Guardar estadísticas de sesión |\n\n### Cómo Funcionan los Comandos\n\nLos comandos slash (`/achievements`) se implementan como **archivos Markdown** en `~/.claude/commands/`.\n\n---\n\n## Notificaciones\n\nLas notificaciones del sistema se detectan automáticamente durante la instalación:\n\n| SO | Método | Sonido |\n|----|--------|--------|\n| macOS | `osascript` | Glass |\n| Linux | `notify-send` | Predeterminado del sistema |\n| Windows | PowerShell | Predeterminado del sistema |\n| Alternativa | Terminal | Ninguno |\n\n### Instalar notify-send en Linux\n\n```bash\n# Ubuntu/Debian\nsudo apt install libnotify-bin\n\n# Fedora\nsudo dnf install libnotify\n\n# Arch\nsudo pacman -S libnotify\n```\n\n---\n\n## Configuración\n\nLa configuración se guarda en `~/.claude/achievements/state.json`:\n\n```json\n{\n  \"settings\": {\n    \"language\": \"es\",\n    \"notifications\": true,\n    \"notification_style\": \"system\"\n  },\n  \"achievements\": {},\n  \"counters\": {}\n}\n```\n\n| Configuración | Valores | Descripción |\n|---------------|---------|-------------|\n| `language` | `\"en\"`, `\"zh\"`, `\"es\"`, `\"ko\"`, `\"ja\"` | Idioma de la interfaz |\n| `notifications` | `true`, `false` | Activar/desactivar alertas |\n| `notification_style` | `\"system\"`, `\"terminal\"`, `\"both\"` | Método de alerta |\n\n---\n\n## Solución de Problemas\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e¿Los logros no se desbloquean?\u003c/b\u003e\u003c/summary\u003e\n\n```bash\n# Verificar que el plugin está instalado\nls ~/.claude/plugins/local/claude-code-achievements/\n\n# Verificar que existe el archivo de estado\ncat ~/.claude/achievements/state.json\n\n# Reiniciar Claude Code después de la instalación para cargar los hooks\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eReiniciar todo el progreso\u003c/b\u003e\u003c/summary\u003e\n\n```bash\nrm ~/.claude/achievements/state.json\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eReinstalar el plugin\u003c/b\u003e\u003c/summary\u003e\n\n```bash\nnpx claude-code-achievements@latest\n```\n\n\u003c/details\u003e\n\n---\n\n## Contribuir\n\n¡Las contribuciones son bienvenidas! Ideas:\n\n- Nuevos logros\n- Nuevas traducciones de idiomas\n- Mejoras de UI\n- Corrección de errores\n\n## Licencia\n\nMIT © [subinium](https://github.com/subinium)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**¡Feliz programación!**\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsubinium%2Fclaude-code-achievements","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsubinium%2Fclaude-code-achievements","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsubinium%2Fclaude-code-achievements/lists"}