ClaudeCodeMod

All shelves / Mods / Workflow

godot-stagehand

By mrf

godot-stagehand is a Claude Code workflow mod by mrf.

For Godot Stagehand, which drives a running Godot game, draws the connection and the last frame Claude captured.

Draws

Install

The marketplace name is godot-stagehand.

In Claude Code
/plugin marketplace add mrf/godot-stagehand
/plugin install godot-stagehand@godot-stagehand
Open the repo

It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.

Version
0.5.1
License
MIT
Repo stars
9
Last change
2026-10-08

What it can reach

  • Draws in the session
  • Reaches the network or an outside service
  • Sees tool calls
  • Calls another program on this machine

Godot Stagehand drives a running Godot game from outside the engine. This plugin is its Claude Code install. It brings an MCP server, which downloads the matching release binary from GitHub on first start, a skill, and godot-stagehand on the shell PATH. You can point binary_path at an existing binary instead of that download. Enable the plugin in the Godot project's .claude/settings.json rather than for every project, and remove any hand-written godot-stagehand MCP entry first, or every tool appears twice. The game listens on 127.0.0.1 and rejects a command until the session token is supplied. The README says that listener is a dev control plane, not a hardened endpoint, and to read the security notes before exposing it. A status line shows stagehand and connected, or how many games are connected. With none, the pane says no game is connected. /stagehand-view opens a pane with the last frame Claude captured. kitty and Ghostty show the picture. Other terminals, and anything inside tmux, show a coarse grid of colored blocks. The Desktop app shows the frame's size and capture time, not the picture. Refresh frame and Re-read status call the plugin's own screenshot and status tools.

The plugin folder has no README. These lines are the repository README. Godot Stagehand is a Go tool that drives a running Godot game, in the role Playwright has for a browser. This folder is its Claude Code mod. The MCP server and the skill work without the mod. The download from GitHub is the network access. The game's listener on 127.0.0.1 is the local program. Refresh frame calls the plugin's own screenshot tool, so this page does not list runs-commands. The frame updates after a Stagehand tool returns, so this page does not list a hold.

Demo

The Claude Code section on the author's GitHub page
Screenshot of the author's GitHub page.

What it hooks into

  • tool.callAround a tool call, where it can hold one
  • ui.renderDraws into the sessionAbovePromptPane
  • command.runWhen you run its slash command/stagehand-view
  • session.startWhen a session starts

Read from the on() calls in its hook modules. Open its source under Files to check what each one does.

Slash commands 1

  • /stagehand-viewShow the last game frame Claude captured and the Stagehand connection

Files

The author's source, 3 files. They load when you open them.

Facts

Author
mrf
Category
Workflow
Marketplace
godot-stagehand
Repo
mrf/godot-stagehand
Folder
integrations/claude-code
Version
0.5.1
License
MIT
Repo stars
9
Last change
2026-10-08
Language
Go
Files
10

Other mods in Workflow

flowstatepicatzHolds a commandFor Flowstate, a workflow language, draws a pane of runs, checks a Flowfile after an edit, and asks before a flow command that changes a server.taxi-blackboxdevbrother2024Records Claude's tool calls like a taxi dashcam and opens the moments before an error or a refusal.taxi-navidevbrother2024Draws Claude's to-do list as a taxi route, with the current stop and a cue when the plan changes.mod-managermishgoldenbergDraws a pane to install, turn on or off, update, or remove each mod in the claude-mods set.recap-plusskanehiraDraws a recap above the prompt of what this session is for, where it stands, and what comes next.phase-runner-hudAyeJKFor Phase Runner, skills that build a product in phases, raises a toast when a run needs you, and /phase-status prints where the run is with no model call.followthrough-bandbayramannakovFor Followthrough, a ledger of checks that outlive the session, draws the checks due for this repo above the prompt.jaira-cockpitBeMuCaFor Jaira, a markdown kanban for agent work, draws the tickets waiting on you, and waits before a large prompt goes out on a cold cache.showrunner-modBendzaeFor Showrunner, a terminal manager for agent sessions, draws the task above the prompt and reports that session's status back.command-centerBioInfoFor Claudelicious, one operator's Claude Code cookbook, draws a pane of the session's intent, running jobs, and open questions.todo-barhoobnnDraws a progress bar of Claude's task list above the prompt: the task in progress, how long it has run, and what is next.ts-bandhoobnnDraws your Tailscale machines above the prompt: one mark while every node is online and direct, otherwise the relayed or offline ones.
All 396 in Workflow