claude-code-achievements — Claude Code plugin
A game-like plugin that records Claude Code activity and awards achievements for work with files, tasks, Git, MCP, and settings.
/plugin marketplace add anthropics/claude-plugins-community
/plugin install claude-code-achievements@claude-communityWhat claude-code-achievements does
This plugin adds an achievement layer to Claude Code. It contains 29 goals in four branches, covering actions such as editing or creating files, searching a codebase, running tests, making commits, configuring MCP, and creating hooks.
Claude Code hooks observe tool activity and check whether a milestone has been reached. The plugin can show a system or terminal alert when an achievement opens. Use /achievements, /achievements locked, or /achievements all to inspect progress, with category filters available as well.
Progress is kept on the local machine at ~/.claude/achievements/state.json. Removing that file wipes the recorded journey, so preserve it before resetting the state.
What it helps with
- track which Claude Code features you have used
- check unlocked and remaining achievements
- get alerts when a milestone is reached
- review practice across achievement categories
Example prompts for the agent
- Show my unlocked goals with
/achievements. - List remaining goals and hints using
/achievements locked. - Change the language and notifications with
/achievements-settings.
How to install claude-code-achievements
Plugin marketplace
/plugin marketplace add anthropics/claude-plugins-community/plugin install claude-code-achievements@claude-communityStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about claude-code-achievements
How do I install claude-code-achievements in Claude Code?
First run /plugin marketplace add anthropics/claude-plugins-community, then install it with /plugin install claude-code-achievements@claude-community.
What does claude-code-achievements do?
It observes Claude Code activity and awards achievements for actions involving tools, Git, MCP, tests, settings, and other workflows. The current progress is available through /achievements.
Where does the plugin keep achievement progress?
It saves the state locally in ~/.claude/achievements/state.json. Deleting this file clears the recorded progress.
