---
title: "sparkmine"
url: "https://claudemods.dev/ko/builds/sparkmine-702d28"
source: "https://github.com/tozmoz/sparkmine"
source_type: "github"
repo: "https://github.com/tozmoz/sparkmine"
author: "tozmoz"
author_handle: "tozmoz"
stars: 0
category: "게임 및 엔터테인먼트"
categories: ["games"]
tags: ["clicker-game", "hooks", "idle-game", "pixel-art", "plugin", "statusline"]
permission_level: 2
scan_complete: true
install: "claude plugin marketplace add tozmoz/sparkmine\nclaude plugin install sparkmine@sparkmine"
added: "2026-10-11T12:55:56.841Z"
updated: "2026-10-11T09:49:23Z"
locale: "ko"
content_locale: "ko"
---

# sparkmine

Claude Code용 픽셀 아트 채굴 방치형 클리커로, 프롬프트 위 밴드에서 실행되며 도구 호출과 Claude의 작업에서 스파크를 얻고, 상점, 업그레이드, 광맥, 깊이 층, 업적을 갖추고 있습니다.

## Description

Sparkmine은 프롬프트 위 밴드에서 방치형 채굴 클리커를 플레이하는 Claude Code 모드입니다. Claude가 수행하는 모든 도구 호출이 스파크 ✻를 채굴하고, Mine을 누르면 더 많이 채굴됩니다. Claude 자신의 작업도 보상을 줍니다(테스트 통과, 커밋, 긴 턴). 상점에서 스파크를 사용해 생산자와 업그레이드를 구매하고, 금광맥을 잡아 보너스를 얻고, 깊이 층을 내려가 특전을 받고, 500m 아래에서 새 갱도를 시작해 고대 돌을 얻으세요. 33개의 업적, 선택적 사운드, 그리고 /mine, /mine share, /mine sound, /mine stop, /mine compact, /mine hide, /mine reset 같은 명령이 포함되어 있습니다. 모든 세션은 하나의 저장을 공유합니다. 토큰을 사용하지 않고, 네트워크 요청이나 명령을 하지 않으며, 작은 로컬 저장 하나를 유지합니다.

## Install

```
claude plugin marketplace add tozmoz/sparkmine
claude plugin install sparkmine@sparkmine
```

## Original README

# Sparkmine: Idle Clicker Game for Claude Code

A game you play while Claude works, built as a
[Claude Code mod](https://code.claude.com/docs/en/plugins/mods/overview).
Claude works. You click.

Plays in the Code tab of the **Claude Desktop app** and in Claude Code in the
terminal.

![The band above the prompt: a pixel miner digs while Claude works](docs/band.png)

While Claude works, a pixel miner digs in the band above your prompt. Every
tool call Claude makes mines sparks ✻, and each press of **Mine** mines more.
Claude's own work pays too: a test run that passes, a commit, a long turn.
Spend it all in the shop on a crew that keeps digging, and on upgrades.

<img src="docs/shop.png" alt="The shop in the Claude Desktop app: upgrades and a new shaft" width="420">

## Install

Needs Claude Code v2.1.293 or later. In a terminal, run:

```bash
claude plugin marketplace add tozmoz/sparkmine
claude plugin install sparkmine@sparkmine --scope user
```

The user scope puts it in every session, including the Code tab of the Claude
Desktop app. New sessions load it; in open ones, run `/reload-plugins`. Inside Claude Code, `/plugin install sparkmine --marketplace
tozmoz/sparkmine` does the same.

To update later:

```bash
claude plugin marketplace update sparkmine
claude plugin update sparkmine@sparkmine
```

Or let updates arrive on their own: in Claude Code in a terminal, run
`/plugin`, open the Marketplaces tab, select sparkmine and choose **Enable
auto-update**.

## Play

- Press **Mine** while Claude works. Clicks count only then. In the
  terminal, give the band the keyboard (click it, or press ctrl+x then Tab)
  and press `m`: every press counts, while quick clicks on one spot count as
  one.
- Open the shop with **Shop** or `/mine`. Producers mine every second Claude
  works; upgrades make clicks, tool calls, Claude's work and the crew
  stronger. The shop's stats show where your sparks came from.
- **Claude's work pays**, once a turn each: tests that pass, a bug squashed
  (tests that failed, then pass), a build that passes, a clean lint, a commit,
  a pull request opened or merged, and a turn longer than five minutes. Every
  third good turn in a row pays a streak.
- **Veins:** now and then a gold vein shows beside the Shop sign for twenty
  seconds. Catch it for two minutes of income, or a ×5 frenzy for thirty.
- **Depth:** the mine goes a hundred metres deeper with every tenfold of
  sparks, through layer after layer. Each layer you reach adds its perk for
  the rest of the run.

  ![The layers down to the core, where each starts and what it adds](docs/layers.png)

- **New shaft:** from 500 m down, open a new shaft in the shop to start over
  for ◈ ancient stones. They add to everything for good, each a little less
  than the one before: 10 stones add 50%, 100 add 251%. A deeper run pays more
  of them.
- **Achievements:** 33 badges for records such as your first vein, 100
  commits, a ten-turn streak or reaching the magma, and nine secrets. Each
  adds 2% to everything, and they stay through new shafts.
- **Sounds:** a few rare moments chime softly, such as a vein caught.
  `/mine sound` turns them off.

All your sessions share one save, so they mine into the same mine. The crew's
idle pace is paid once, however many sessions are open.

| Command | What it does |
| :- | :- |
| `/mine` | Opens the shop |
| `/mine share` | Puts a card of your mine in the conversation to paste anywhere (in the terminal, on the clipboard too) |
| `/mine sound` | Turns the sounds off in every session, and on again |
| `/mine stop`, `/mine start` | Stops the game in every session, and starts it again |
| `/mine compact` | Keeps the band to one line, even while Claude works |
| `/mine hide`, `/mine show` | Hides the band in this session, and brings it back |
| `/mine reset` | Deletes your save, after asking |

To remove it, disable or uninstall it from `/plugin`. Your save stays until
you reset it.

## What it touches

- It **DOES NOT** use tokens: it never calls a model and adds nothing to your
  prompts.
- It **DOES NOT** make network requests or run commands. Nothing leaves your
  machine. Its few sounds play through the system's own player (`afplay` on
  macOS).
- It **DOES NOT** keep or send your prompts or Claude's answers: it reads them
  on your machine only to notice a few words.
- It counts tool calls, turns and permission prompts, and reads whether a
  test run passed or a commit landed, but changes none of them.
- It keeps one small save on your machine.

## Known limits

- In the terminal, quick clicks on one spot count as one. Press `m` instead.
- A mod cannot see a permission dialog, so the band keeps going while one is
  open. It rests only while Claude asks you a question or waits on a plan.
- Each machine keeps its own save.

## License

MIT