Playmark

Godot addon + Claude Code plugin

Mark it while you play. Claude fixes it.

Press CtrlShiftM in your running Godot game. Pin what's wrong and write a line. Claude Code gets the frame, the last five seconds, the log and the code under your pin.

v0.2.0Godot 4.5+MITChangelog

Recorded in Godot

Playmark in a toy Godot scene: a pin on the teal square, the note 'Boxy should be orange', saved; then the square turns orange and a toast says Fixed #1

How it works

  1. Play

    Run your game from Godot. Playmark keeps the last five seconds.

  2. Mark

    CtrlShiftM freezes the frame. Click to pin, drag to box, 1 to 5 for a category, then a note.

  3. Claude fixes

    Your next prompt in Claude Code mentions the mark. /playmark:triage finds the code under your pin and proposes a fix. You say which.

  4. Retest

    The game says "Fixed #3" and leaves a marker where you made the mark. Walk back and check.

Try it

One mark, one fix.

Guided runs on a toy scene, the same flow as in Godot. Pick a change, five steps each.

  1. Freeze
  2. Pin
  3. Stamp
  4. Save
  5. Claude
Freeze
Marked #1Art
Fixed by Claude Fixed #1 Boxy: #2EC4B6 → #FF8A1F in look.gd
What did you notice?

The mark

What Claude gets

Every mark is a folder in .playmark/inbox, git-ignored by default. This is the real one from the video.

annotated.png: the frozen frame of the four shapes with pin number 1 on the teal square
annotated.png the frame, pins numbered
  • annotated.pngthe frame, pins numbered
  • clip_sheet.pngthe last seconds, oldest first
  • log.txtwarnings and errors
  • mark.jsonnote, scene, the nodes and scripts under each pin, your game's state
{
  "seq": 1,
  "category": "art",
  "note": "Boxy should be orange",
  "marks": [{ "type": "pin", "x": 750, "y": 536 }],
  "scene": { "path": "res://shapes.tscn" },
  "under_marks": [{
    "mark": 1,
    "physics": [{
      "path": "Boxy",
      "class": "Area2D",
      "script": "res://shape.gd"
    }]
  }],
  "context": { "look": [ … ] }
}

Inside

What it does

Install

Three commands in Claude Code

  1. /plugin marketplace add barmoshe/playmark
  2. /plugin install playmark@playmark
  3. /playmark:installin your game's repo

Godot 4.5+Claude CodeNode 18+Desktop, tested on macOS

Without Claude Code, copy addons/playmark into your project and enable it in Project Settings, Plugins. Updates: claude plugin update playmark.

Why

I made Playmark while building Wandcraft, a roguelite where you program your wand. Playtesting my own game, I kept noticing small things I didn't want to stop and write up. Now I press a key, point, and keep playing.