https://github.com/subinium/claude-code-achievements
🎮 Steam-style Achievement system for Claude Code
https://github.com/subinium/claude-code-achievements
claude-code gamification
Last synced: about 2 hours ago
JSON representation
🎮 Steam-style Achievement system for Claude Code
- Host: GitHub
- URL: https://github.com/subinium/claude-code-achievements
- Owner: subinium
- Created: 2026-01-17T04:23:51.000Z (4 days ago)
- Default Branch: main
- Last Pushed: 2026-01-18T23:09:39.000Z (2 days ago)
- Last Synced: 2026-01-20T08:59:50.929Z (about 22 hours ago)
- Topics: claude-code, gamification
- Language: Shell
- Homepage:
- Size: 232 KB
- Stars: 40
- Watchers: 0
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.es.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# Claude Code Achievements
**Sistema de logros estilo Steam para Claude Code**
[](https://www.npmjs.com/package/claude-code-achievements)
[](LICENSE)
[](package.json)
¡Gamifica tu experiencia de programación y desbloquea logros mientras dominas las funciones de Claude Code!
[Instalación](#instalación) · [Uso](#uso) · [Logros](#logros) · [Cómo Funciona](#arquitectura)
**[English](README.md)** · **[中文](README.zh.md)** · **[한국어](README.ko.md)** · **[日本語](README.ja.md)**
---
## Características
- **26 Logros** en 4 categorías
- **Notificaciones en tiempo real** vía alertas del sistema o terminal
- **Soporte multiidioma** (EN / 中文 / ES / 한국어 / 日本語)
- **Multiplataforma** (macOS / Linux / Windows)
- **Instalación global** - funciona en todos tus proyectos
## Instalación
```bash
npx claude-code-achievements
```
El instalador interactivo:
1. Detectará automáticamente tu SO y capacidad de notificaciones
2. Preguntará tu preferencia de idioma
3. Configurará el estilo de notificación (sistema/terminal/ambos)
4. Instalará globalmente en `~/.claude/plugins/local/`
> **Nota:** Este plugin se instala **globalmente** y funciona automáticamente en todos tus proyectos.
### Instalación Manual
```bash
git clone https://github.com/subinium/claude-code-achievements.git
cd claude-code-achievements
node bin/install.js
```
## Uso
| Comando | Descripción |
|---------|-------------|
| `/achievements` | Ver logros desbloqueados (predeterminado) |
| `/achievements locked` | Ver logros bloqueados con pistas |
| `/achievements all` | Ver todos los logros por categoría |
| `/achievements-settings` | Cambiar idioma o configuración de notificaciones |
### Filtros de Categoría
```bash
/achievements basics # Primeros Pasos
/achievements workflow # Flujo de Trabajo
/achievements tools # Herramientas Avanzadas
/achievements mastery # Maestría
```
## Logros
Primeros Pasos (4 logros)
| Logro | Cómo Desbloquear |
|-------|------------------|
| ✏️ **Primer Toque** | Editar cualquier archivo |
| 📝 **Creador** | Crear un nuevo archivo |
| 🔍 **Detective de Código** | Usar Glob o Grep para buscar en el código |
| 📋 **Curador de Proyecto** | Crear `CLAUDE.md` para contexto del proyecto |
Flujo de Trabajo (8 logros)
| Logro | Cómo Desbloquear |
|-------|------------------|
| 📋 **Planificador de Tareas** | Usar TodoWrite para seguimiento de tareas |
| 🎯 **Pensador Estratégico** | Usar modo Plan (`Shift+Tab` dos veces) |
| 🗣️ **Comunicador** | Claude usa `AskUserQuestion` para clarificar requisitos |
| 🌍 **Curador Global** | Configurar `~/.claude/CLAUDE.md` |
| 📦 **Controlador de Versiones** | Hacer commit con Claude |
| 🚀 **¡A Producción!** | Hacer push al repositorio remoto |
| 🧪 **Guardián de Calidad** | Ejecutar tests con Claude |
| 🚦 **Pionero CI/CD** | Crear workflow de GitHub Actions |
Herramientas Avanzadas (9 logros)
| Logro | Cómo Desbloquear |
|-------|------------------|
| 🎨 **Inspector Visual** | Analizar imagen o captura de pantalla |
| 📡 **Cazador de Docs** | Obtener y analizar una página web |
| 🤖 **Maestro de Delegación** | Usar herramienta `Task` para sub-agentes |
| 🔌 **Pionero MCP** | Usar cualquier herramienta MCP |
| 🌐 **Explorador Web** | Usar herramienta `WebSearch` |
| ⚙️ **Personalizador** | Modificar configuración de Claude Code |
| 📜 **Creador de Skills** | Crear skill personalizado en `.claude/skills/` |
| ⌨️ **Artesano de Comandos** | Crear comando slash personalizado |
| 🧩 **Explorador de Plugins** | Instalar un plugin desde el marketplace |
Maestría (5 logros)
| Logro | Cómo Desbloquear |
|-------|------------------|
| 🪝 **Arquitecto de Automatización** | Configurar hooks de Claude Code |
| 🔗 **Conector MCP** | Configurar `.mcp.json` para integraciones |
| 🤖 **Arquitecto de Agentes** | Crear agente personalizado en `.claude/agents/` |
| 🛡️ **Guardia de Seguridad** | Configurar permisos de seguridad |
| 🔄 **Maestro del Bucle** | Iniciar bucle de codificación autónomo |
---
## Arquitectura
Este plugin usa el **sistema de hooks de Claude Code** para rastrear tus acciones en tiempo real.
```
┌─────────────────────────────────────────────────────────────┐
│ SESIÓN DE CLAUDE CODE │
├─────────────────────────────────────────────────────────────┤
│ │
│ Tú: "Edita el archivo de configuración" │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────┐ │
│ │ Claude usa la herramienta Edit │ │
│ └─────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────┐ │
│ │ Se activa el Hook PostToolUse │◄── hooks.json │
│ │ → track-achievement.sh │ │
│ └─────────────────────────────────────┘ │
│ │ │
│ ┌──────────┴──────────┐ │
│ ▼ ▼ │
│ ┌───────────┐ ┌───────────┐ │
│ │ ¡Coincide!│ │ No coincide│ │
│ │ │ │ │ │
│ │ Desbloquear│ │ Continuar │ │
│ │ Notificar │ └───────────┘ │
│ │ Guardar │ │
│ └───────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
```
### Estructura del Plugin
```
~/.claude/plugins/local/claude-code-achievements/
├── .claude-plugin/
│ └── plugin.json # Metadatos del plugin
├── hooks/
│ ├── hooks.json # Definiciones de hooks (PostToolUse, Stop)
│ ├── track-achievement.sh # Lógica principal de seguimiento
│ └── track-stop.sh # Manejador de fin de sesión
├── commands/
│ ├── achievements.md # Comando /achievements
│ └── achievements-settings.md
├── scripts/
│ ├── show-achievements.sh # UI de visualización
│ └── show-notification.sh # Manejador de notificaciones
└── data/
├── achievements.json # Definiciones de logros
└── i18n/
├── en.json # English
├── zh.json # 中文
├── es.json # Español
├── ko.json # 한국어
└── ja.json # 日本語
```
### Cómo Funcionan los Hooks
El plugin registra dos hooks en Claude Code:
| Hook | Activador | Propósito |
|------|-----------|-----------|
| `PostToolUse` | Después de ejecutar herramienta | Verificar condiciones de logro |
| `Stop` | Al finalizar sesión | Guardar estadísticas de sesión |
### Cómo Funcionan los Comandos
Los comandos slash (`/achievements`) se implementan como **archivos Markdown** en `~/.claude/commands/`.
---
## Notificaciones
Las notificaciones del sistema se detectan automáticamente durante la instalación:
| SO | Método | Sonido |
|----|--------|--------|
| macOS | `osascript` | Glass |
| Linux | `notify-send` | Predeterminado del sistema |
| Windows | PowerShell | Predeterminado del sistema |
| Alternativa | Terminal | Ninguno |
### Instalar notify-send en Linux
```bash
# Ubuntu/Debian
sudo apt install libnotify-bin
# Fedora
sudo dnf install libnotify
# Arch
sudo pacman -S libnotify
```
---
## Configuración
La configuración se guarda en `~/.claude/achievements/state.json`:
```json
{
"settings": {
"language": "es",
"notifications": true,
"notification_style": "system"
},
"achievements": {},
"counters": {}
}
```
| Configuración | Valores | Descripción |
|---------------|---------|-------------|
| `language` | `"en"`, `"zh"`, `"es"`, `"ko"`, `"ja"` | Idioma de la interfaz |
| `notifications` | `true`, `false` | Activar/desactivar alertas |
| `notification_style` | `"system"`, `"terminal"`, `"both"` | Método de alerta |
---
## Solución de Problemas
¿Los logros no se desbloquean?
```bash
# Verificar que el plugin está instalado
ls ~/.claude/plugins/local/claude-code-achievements/
# Verificar que existe el archivo de estado
cat ~/.claude/achievements/state.json
# Reiniciar Claude Code después de la instalación para cargar los hooks
```
Reiniciar todo el progreso
```bash
rm ~/.claude/achievements/state.json
```
Reinstalar el plugin
```bash
npx claude-code-achievements@latest
```
---
## Contribuir
¡Las contribuciones son bienvenidas! Ideas:
- Nuevos logros
- Nuevas traducciones de idiomas
- Mejoras de UI
- Corrección de errores
## Licencia
MIT © [subinium](https://github.com/subinium)
---
**¡Feliz programación!**