GitHub 저장소 · 작성자 TravisBumgarner

dino-break

Name: dino-break
Author: TravisBumgarner

Claude Code가 긴 작업을 수행하는 동안 프롬프트 위의 띠에서 열리는 ASCII 공룡 달리기 게임 플러그인

TravisBumgarner@TravisBumgarner

TravisBumgarner/claude-mods/tree/main/dino

번역 완료

이 mod 소개

dino

Claude Code가 오래 걸리는 작업을 수행하는 동안 프롬프트 위의 띠에서 실행되는 Chrome 오프라인 공룡 게임을 ASCII로 구현한 것입니다. 플러그인 이름은 dino-break입니다.

HI 00412  00087   Claude is working...
      .--.
     (____)
    __
   / o)
__/ /         \|/
  /\           |
_____._______._______._______._______.
Space/Up: jump   P: pause   X: close

불러오기

Mod를 사용하려면 Claude Code v2.1.287 이상이 필요합니다(claude --version).

한 세션에서만 사용하려면:

claude --plugin-dir ~/Programming/mods/dino

모든 세션에서 사용하려면 폴더를 ~/.claude/settings.json의 env 블록에 추가합니다.

{
  "env": {
    "CLAUDE_CODE_PLUGIN_DIRS": "~/Programming/mods/dino"
  }
}

여러 mod를 불러오려면 경로를 :로 구분합니다. 대화형 세션은 폴더를 감시하므로 저장하면 편집 내용이 다시 로드됩니다.

/plugin을 실행해 로드되었는지 확인합니다. 탭 아래의 흐린 줄에 dino-break이 표시되어야 합니다.

플레이

| 키 | 동작 | | --- | --- | | 게임 클릭 | 키보드를 게임에 전달합니다(Esc를 누르면 프롬프트로 돌아갑니다) | | D | 시작하거나 3-2-1 카운트다운 후 일시 정지한 게임을 재개 | | Space / Up / W | 점프 | | P | 일시 정지하고 점수 저장 | | X | 저장하고 닫기 |

/dino로 게임을 수동으로 열거나 닫을 수 있습니다.

자동으로 열리는 방식

이 mod는 start_break 도구를 제공하고, 작업에 약 1분 이상 걸릴 것 같을 때 먼저 호출하도록 시스템 프롬프트에 한 줄을 추가합니다. Claude가 턴을 끝내면 게임이 일시 정지되고 실행을 저장한 뒤 토스트를 표시합니다.

Claude가 작업 시간을 추측하는 방식에 의존하므로 매번 실행되지는 않습니다. /dino는 항상 작동합니다.

점수

mod 자체의 ~/.claude 아래 저장소에 저장됩니다(이 저장소에는 저장되지 않음).

best: 최고 점수
scores: 최근 50회 실행
saved: 일시 정지된 실행. 다음 세션에 "Press D to resume"로 표시됩니다

파일

| 파일 | 내용 | | --- | --- | | .claude-plugin/plugin.json | 매니페스트 | | hooks/hooks.json | register.tsx를 가리킴 | | hooks/register.tsx | start_break 도구, /dino, 띠, 점수 저장 | | hooks/game.tsx | 게임: 키, 물리, 그리기(Client surface module로 실행) | | types/index.d.ts | 상태 계약 | | tests/dino.test.tsx | 시작, 일시 정지, 재개 |

개발

claude plugin validate ~/Programming/mods/dino
claude plugin test ~/Programming/mods/dino

Mod가 한 번 로드되면 Claude Code가 타입을 .claude-plugin/types/에 기록하고 tsconfig.json을 생성합니다. tsc -p .로 타입을 검사합니다. 둘 다 생성 파일이며 gitignore 대상입니다.

이 글을 작성할 당시 claude plugin test는 "hooks modules are turned off in this process" 때문에 실행을 거부했습니다. 따라서 테스트는 타입 검사를 마쳤지만 아직 실행되지는 않았습니다.

설치

먼저 작성자의 README에서 marketplace와 플러그인 이름을 확인하세요. 저장소 구조에 따라 명령어가 달라질 수 있습니다.

claude plugin marketplace add TravisBumgarner/claude-mods
claude plugin install dino-break

원문 / README

dino

An ASCII take on Chrome's offline dino game that runs in a band above the Claude Code prompt while Claude works on something long. The plugin is named dino-break.

HI 00412  00087   Claude is working...
      .--.
     (____)
    __
   / o)
__/ /         \|/
  /\           |
_____._______._______._______.
Space/Up: jump   P: pause   X: close

Load it

Mods need Claude Code v2.1.287 or later (claude --version).

For one session:

claude --plugin-dir ~/Programming/mods/dino

For every session, add the folder to the env block of ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_PLUGIN_DIRS": "~/Programming/mods/dino"
  }
}

To load several mods, separate their paths with :. Interactive sessions watch the folder, so edits reload when you save.

Run /plugin to check it loaded: the dim line under the tabs should name dino-break.

Play

| Key | Does | | --- | --- | | click the game | gives it the keyboard (Esc hands it back to the prompt) | | D | start, or resume a paused run after a 3-2-1 countdown | | Space / Up / W | jump | | P | pause and save the score | | X | save and close |

/dino opens or closes the game by hand.

How it opens on its own

The mod gives Claude a start_break tool and adds a line to the system prompt telling Claude to call it first when a task looks like it'll take more than about a minute. When Claude finishes the turn, the game pauses, saves your run, and shows a toast.

This depends on Claude guessing the task length, so it won't fire every time. /dino always works.

Scores

Saved in the mod's own store under ~/.claude (not in this repo):

best: high score
scores: last 50 runs
saved: the paused run, which comes back as "Press D to resume" in the next session

Files

| File | What | | --- | --- | | .claude-plugin/plugin.json | manifest | | hooks/hooks.json | points at register.tsx | | hooks/register.tsx | start_break tool, /dino, the band, saving scores | | hooks/game.tsx | the game: keys, physics, drawing (runs as a Client surface module) | | types/index.d.ts | state contract | | tests/dino.test.tsx | start, pause, resume |

Develop

claude plugin validate ~/Programming/mods/dino
claude plugin test ~/Programming/mods/dino

After the mod loads once, Claude Code writes its types into .claude-plugin/types/ and a tsconfig.json, and tsc -p . type-checks it. Both are generated and gitignored.

claude plugin test refused to run while this was written ("hooks modules are turned off in this process"), so the test is type-checked but hasn't run yet.