---
title: "sparkmine"
url: "https://claudemods.dev/ja/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: "ja"
content_locale: "ja"
---

# sparkmine

Claude Code 用のピクセルアート採掘アイドルクリッカーで、プロンプトの上の帯で動作し、ツール呼び出しと Claude の作業からスパークを獲得し、ショップ、アップグレード、鉱脈、深度レイヤー、実績を備えています。

## Description

Sparkmine は、プロンプトの上の帯でアイドル採掘クリッカーをプレイする Claude Code モッドです。Claude が行うすべてのツール呼び出しがスパーク ✻ を採掘し、Mine を押すとさらに採掘できます。Claude 自身の作業も報酬を生みます（テストの通過、コミット、長いターン）。ショップでスパークを使って生産者とアップグレードを購入し、金鉱脈を捕まえてボーナスを獲得し、深度レイヤーを降りてパークを取得し、500 m 下から新しい坑道を開始して古代の石を手に入れましょう。33 の実績、オプションのサウンド、および /mine、/mine share、/mine sound、/mine stop、/mine compact、/mine hide、/mine reset などのコマンドが付属しています。すべてのセッションが 1 つのセーブを共有します。トークンを使用せず、ネットワークリクエストやコマンドを行わず、小さなローカルセーブを 1 つ保持します。

## 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