@subinium/claude-code-achievementsPublic

Plugins#Claude Code#Coding #Product #Personal

Steam-style achievements for Claude Code

This plugin adds a local achievement system to Claude Code. It uses hooks to observe tool use, matches those actions against achievement rules, and then shows progress and unlock notifications. Commands let you view locked and unlocked achievements and change language or notification settings.

84 stars•6 forks•Shell•Updated 7mo ago

Who it's for

Builders who use Claude Code and want their agent work tracked like a game.

What it delivers

You can see progress and unlock milestones as you code instead of treating every session like a blank slate.

What it does

Achievement tracking

Tracks Claude Code actions against 29 achievements across four categories.

Hook-based detection

Uses Claude Code hooks to watch tool use and trigger achievement checks.

Progress commands

Provides `/achievements`, `/achievements locked`, and category filters to inspect status.

Notifications

Shows real-time unlock alerts with platform-specific notifications or a terminal fallback.

Language settings

Supports English, Chinese, Spanish, Korean, and Japanese through `/achievements-settings`.

Local state storage

Stores progress in `~/.claude/achievements/state.json` so it stays on your machine.

How to get it

1Run
```
npx claude-code-achievements
```

README

Claude Code Achievements

Level up your AI coding skills

╔══════════════════════════════════════════════════════════════╗
║  🎮  UNLOCK ACHIEVEMENTS  •  TRACK PROGRESS  •  HAVE FUN  🎮  ║
╚══════════════════════════════════════════════════════════════╝

Transform your Claude Code experience into an RPG adventure!

Quick Start · Achievements · Commands

中文 · Español · 한국어 · 日本語

✨ Why This Exists

Learning Claude Code is a journey. This plugin turns that journey into a game.

🏆 29 Achievements to unlock across 4 skill trees
🔔 Real-time notifications when you level up
📊 Track your mastery from beginner to expert
🌍 5 Languages supported

🚀 Quick Start

npx claude-code-achievements

That's it. Start coding and watch the achievements roll in!

🏆 Achievements

🌱 Getting Started

4 Achievements

Your first steps

⚡ Workflow

10 Achievements

Work smarter

🔧 Power Tools

10 Achievements

Unlock abilities

👑 Mastery

5 Achievements

Become a legend

🌱 Getting Started

Every master was once a beginner

	Achievement	Quest
✏️	First Touch	Edit any file with Claude
📝	Creator	Create a new file
🔍	Code Detective	Search codebase with Glob or Grep
📋	Project Curator	Create your first `CLAUDE.md`

⚡ Workflow

Efficiency is intelligent laziness

	Achievement	Quest
📋	Task Planner	Use TodoWrite for task tracking
📋	Task Master	Use TaskCreate/TaskUpdate/TaskList
🎯	Strategic Thinker	Enter Plan mode (`Shift+Tab` × 2)
🗣️	Communicator	Have Claude ask you a clarifying question
🌍	Global Curator	Set up global `~/.claude/CLAUDE.md`
📦	Version Controller	Make a commit with Claude
🚀	Ship It!	Push code to remote
🔀	PR Champion	Create a pull request with `gh pr create`
🧪	Quality Guardian	Run tests
🚦	CI/CD Pioneer	Create GitHub Actions workflow

🔧 Power Tools

With great power comes great productivity

	Achievement	Quest
🎨	Visual Inspector	Analyze an image or screenshot
📡	Doc Hunter	Fetch and analyze a web page
🤖	Delegation Master	Spawn a sub-agent with Task tool
⏳	Multitasker	Run a command in the background
🔌	MCP Pioneer	Use any MCP tool
🌐	Web Explorer	Search the web
⚙️	Customizer	Modify Claude Code settings
📜	Skill Creator	Create custom skill
⌨️	Command Crafter	Create custom slash command
🧩	Plugin Explorer	Install a marketplace plugin

👑 Mastery

The elite few who push the boundaries

	Achievement	Quest
🪝	Automation Architect	Set up Claude Code hooks
🔗	MCP Connector	Configure `.mcp.json` integration
🤖	Agent Architect	Create a custom agent
🛡️	Security Guard	Configure security permissions
🔄	Loop Master	Start autonomous coding loop

🎮 Commands

/achievements          # View your unlocked achievements
/achievements locked   # See what's left to unlock (with hints!)
/achievements all      # Full achievement list by category
/achievements-settings # Configure language & notifications

Category Filters

/achievements basics    # 🌱 Getting Started
/achievements workflow  # ⚡ Workflow
/achievements tools     # 🔧 Power Tools
/achievements mastery   # 👑 Mastery

🔔 Notifications

Achievement unlocked? You'll know instantly!

Platform	Style
🍎 macOS	Native notification with sound
🐧 Linux	System notification
🪟 Windows	Toast notification
💻 Fallback	Terminal alert

🛠️ How It Works

   You: "Edit the config file"
              │
              ▼
   ┌─────────────────────┐
   │  Claude uses Edit   │
   └─────────────────────┘
              │
              ▼
   ┌─────────────────────┐
   │  🎯 Hook triggered  │──▶ Achievement check
   └─────────────────────┘
              │
       ┌──────┴──────┐
       ▼             ▼
   ┌───────┐    ┌────────┐
   │ 🏆 +1 │    │  None  │
   │Unlock!│    │Continue│
   └───────┘    └────────┘

The plugin hooks into Claude Code's event system. Every tool use is tracked. When you hit a milestone, you get rewarded!

🌍 Languages

🇺🇸 English
🇨🇳 中文
🇪🇸 Español
🇰🇷 한국어
🇯🇵 日本語

Change anytime with /achievements-settings

📂 Your Progress

All progress is saved locally:

~/.claude/achievements/state.json

Reset your journey anytime:

rm ~/.claude/achievements/state.json

🤝 Contributing

Got an idea for a new achievement? Found a bug? Contributions welcome!

🏆 Suggest new achievements
🌍 Add translations
🐛 Report issues
⭐ Star this repo!

Ready to start your journey?

npx claude-code-achievements

Level up. Unlock achievements. Have fun coding!

MIT © subinium

Files in the repo

Repository payload•19 top-level entries

.claude-plugin— Plugin manifest for Claude Code
.github— GitHub workflows and templates
assets— 1 item
bin— 2 items
commands— Slash commands
data— 2 items
hooks— Hook scripts
scripts— Helper scripts
.gitignore
CHANGELOG.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md
package.json— Node package: install with npm
README.es.md
README.ja.md
README.ko.md
README.md— The README
README.zh.md
SECURITY.md

Discussion (0)

Ask about usage, or say what you built with it

No comments yet. Be the first to say what this is good for.

More plugins

DietrichGebert/ponytailPlugins

Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.

138k

1 add

Egonex-AI/Understand-AnythingPlugins

Graphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.

82k

code-yeongyu/

oh-my-openagent

code-yeongyu/oh-my-openagentPlugins

OmO: Just type "mass ulw" keyword with your prompt. Now you are the master of graph engineering.

69k

thedotmack/claude-memPlugins

Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More

94k

dmmulroy/anti-slopPlugins

Opinionated Oxlint rules for rejecting low-evidence TypeScript and JavaScript patterns

4.3k

Yeachan-Heo/oh-my-claudecodePlugins

Teams-first Multi-agent orchestration for Claude Code

39k